Тип QML MediaPlayer

Добавляет воспроизведение медиа в сцену. Подробнее...

• Список всех членов, включая унаследованные

Свойства

• activeAudioTrack : int
• activeSubtitleTrack : int
• activeVideoTrack : int
• audioOutput : AudioOutput
• audioTracks : список<mediaMetaData>
• bufferProgress : вещественный
• duration : int
• error : перечисление
• errorString : строка
• hasAudio : логический
• hasVideo : логический
• loops : int
• mediaStatus : перечисление
• metaData : mediaMetaData
• playbackRate : вещественный
• playbackState : перечисление
• position : int
• seekable : логический
• source : url
• subtitleTracks : список<mediaMetaData>
• videoOutput : VideoOutput
• videoTracks : список<mediaMetaData>

Сигналы

• errorOccurred(error, errorString)
• playbackStateChanged()

Методы

• pause()
• play()
• stop()

Подробное описание

Text {
    text: "Click Me!";
    font.pointSize: 24;
    width: 150; height: 50;

    MediaPlayer {
        id: playMusic
        source: "music.wav"
        audioOutput: AudioOutput {}
    }
    MouseArea {
        anchors.fill: parent
        onPressed:  { playMusic.play() }
    }
}

Вы можете использовать MediaPlayer вместе с MultiMedia::AudioOutput для воспроизведения аудиоконтента или использовать его вместе с Multimedia::VideoOutput для рендеринга видео.

Item {
    MediaPlayer {
        id: mediaplayer
        source: "groovy_video.mp4"
        audioOutput: AudioOutput {}
        videoOutput: videoOutput
    }

    VideoOutput {
        id: videoOutput
        anchors.fill: parent
    }

    MouseArea {
        anchors.fill: parent
        onPressed: mediaplayer.play();
    }
}

См. также AudioOutput и VideoOutput.

Документация по свойствам

activeAudioTrack : int

Это свойство содержит номер дорожки текущей активной аудиодорожки. Установите в -1 для отключения аудиодорожки.

Значение свойства по умолчанию — 0: первая аудиодорожка.

activeSubtitleTrack : int

Это свойство содержит номер дорожки текущей активной субтитров. Установите в -1 для отключения субтитров.

Значение свойства по умолчанию — -1: субтитры не активны.

activeVideoTrack : int

Это свойство содержит номер дорожки текущей активной видеодорожки. Установите в -1 для отключения видеодорожки.

Значение свойства по умолчанию — 0: первая видеодорожка.

audioOutput : AudioOutput

Это свойство содержит целевой аудиовыход. Принимает один элемент AudioOutput.

См. также QMediaPlayer::setAudioOutput().

audioTracks : список<mediaMetaData>

Это свойство содержит список метаданных. Каждый индекс относится к аудиодорожке.

Метаданные содержат свойства, описывающие отдельные дорожки. Для аудиодорожек свойство Язык обычно является наиболее важным свойством.

См. также mediaMetaData.

bufferProgress : вещественный

Это свойство содержит, какая часть буфера данных в настоящее время заполнена, от 0.0 (пустой) до 1.0 (полный).

Воспроизведение может начаться или возобновиться только тогда, когда буфер полностью заполнен. Когда буфер заполнен, MediaPlayer.Buffered имеет значение true. Когда прогресс буфера находится между 0.0 и 0.1, MediaPlayer.Buffering устанавливается в true.

Значение, меньшее чем 1.0, подразумевает, что свойство MediaPlayer.StalledMedia имеет значение true.

См. также mediaStatus.

duration : int

Это свойство содержит продолжительность медиа в миллисекундах.

Если медиа не имеет фиксированной продолжительности (например, прямая трансляция), оно будет установлено в 0.

error : перечисление

Это свойство содержит состояние ошибки аудио. Оно может быть одним из следующих.

errorString : строка

Это свойство содержит строку, описывающую текущее состояние ошибки более подробно.

hasAudio : логический

Это свойство содержит информацию о наличии аудио в медиа.

hasVideo : логический

Это свойство содержит информацию о наличии видео в медиа.

loops : int

Определяет, сколько раз медиа будет воспроизведено перед остановкой. Установите в MediaPlayer::Infinite, чтобы постоянно циклически воспроизводить текущий медиафайл.

Значение по умолчанию — 1. Установка этого свойства в 0 не имеет эффекта.

mediaStatus : перечисление

Это свойство содержит статус загрузки медиа. Оно может быть одним из следующих:

metaData : mediaMetaData

Возвращает метаданные для текущего медиа, используемого медиаплеером.

Метаданные могут содержать информацию, такую как название видео или дата его создания.

playbackRate : вещественный

Это свойство содержит скорость воспроизведения аудио в кратных нормальной скорости.

По умолчанию 1.0.

playbackState : перечисление

Это свойство содержит состояние воспроизведения медиа. Оно может быть одним из следующих:

position : int

Значение — текущая позиция воспроизведения в миллисекундах с начала медиа. Периодические изменения позиции будут отображены сигналом positionChanged().

Если свойство seekable имеет значение true, это свойство можно установить в миллисекунды.

seekable : bool

Это свойство указывает, можно ли изменить позицию position медиа.

source : url

Это свойство содержит URL-адрес источника медиа.

Item {
    MediaPlayer {
        id: mediaplayer
        source: "file:///test.mp4"
        videoOutput: videoOutput
        audioOutput: AudioOutput {

        }
    }

    VideoOutput {
        id: videoOutput
        anchors.fill: parent
    }

    MouseArea {
        id: playArea
        anchors.fill: parent
        onPressed: mediaplayer.play();
    }
}

См. также QMediaPlayer::setSource().

subtitleTracks : list<mediaMetaData>

Это свойство содержит список метаданных. Каждый индекс относится к дорожке субтитров.

Метаданные содержат свойства, описывающие отдельные дорожки. Для дорожек субтитров свойство Language обычно является наиболее важным.

См. также mediaMetaData.

videoOutput : VideoOutput

Это свойство содержит целевой видеовыход. Принимает один элемент VideoOutput.

См. также QMediaPlayer::setVideoOutput().

videoTracks : list<mediaMetaData>

Это свойство содержит список метаданных. Каждый индекс относится к видеодорожке.

Метаданные содержат свойства, описывающие отдельные дорожки.

См. также mediaMetaData.

Документация по сигналам

errorOccurred(error, errorString)

Этот сигнал генерируется при возникновении ошибки. Параметр errorString может содержать более подробную информацию об ошибке.

Примечание: Соответствующий обработчик — onErrorOccurred.

См. также QMediaPlayer::Error.

playbackStateChanged()

Этот сигнал генерируется при изменении свойства playbackState.

Примечание: Соответствующий обработчик — onPlaybackStateChanged.

Документация по методам

pause()

Приостанавливает воспроизведение медиа.

Устанавливает свойство playbackState в значение PausedState.

play()

Запускает или возобновляет воспроизведение медиа.

Устанавливает свойство playbackState в значение PlayingState.

stop()

Останавливает воспроизведение медиа.

Устанавливает свойство playbackState в значение StoppedState.