Тип QML MediaPlayer

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

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

Свойства

• audioRole : перечисление
• autoLoad : bool
• autoPlay : bool
• availability : перечисление
• bufferProgress : real
• duration : int
• error : перечисление
• errorString : строка
• hasAudio : bool
• hasVideo : bool
• loops : int
• mediaObject : вариант
• metaData
  • metaData.title : вариант
  • metaData.subTitle : вариант
  • metaData.author : вариант
  • metaData.comment : вариант
  • metaData.description : вариант
  • metaData.category : вариант
  • metaData.genre : вариант
  • metaData.year : вариант
  • metaData.date : вариант
  • metaData.userRating : вариант
  • metaData.keywords : вариант
  • metaData.language : вариант
  • metaData.publisher : вариант
  • metaData.copyright : вариант
  • metaData.parentalRating : вариант
  • metaData.ratingOrganization : вариант
  • metaData.size : вариант
  • metaData.mediaType : вариант
  • metaData.audioBitRate : вариант
  • metaData.audioCodec : вариант
  • metaData.averageLevel : вариант
  • metaData.channelCount : вариант
  • metaData.peakValue : вариант
  • metaData.sampleRate : вариант
  • metaData.albumTitle : вариант
  • metaData.albumArtist : вариант
  • metaData.contributingArtist : вариант
  • metaData.composer : вариант
  • metaData.conductor : вариант
  • metaData.lyrics : вариант
  • metaData.mood : вариант
  • metaData.trackNumber : вариант
  • metaData.trackCount : вариант
  • metaData.coverArtUrlSmall : вариант
  • metaData.coverArtUrlLarge : вариант
  • metaData.resolution : вариант
  • metaData.pixelAspectRatio : вариант
  • metaData.videoFrameRate : вариант
  • metaData.videoBitRate : вариант
  • metaData.videoCodec : вариант
  • metaData.posterUrl : вариант
  • metaData.chapterNumber : вариант
  • metaData.director : вариант
  • metaData.leadPerformer : вариант
  • metaData.writer : вариант
• muted : bool
• notifyInterval : int
• playbackRate : real
• playbackState : перечисление
• playlist : Плейлист
• position : int
• seekable : bool
• source : url
• status : перечисление
• volume : real

Сигналы

• error(error, errorString)
• paused()
• playbackStateChanged()
• playing()
• stopped()

Методы

• pause()
• play()
• seek(offset)
• stop()
• list<int> supportedAudioRoles()

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

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

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

Можно использовать MediaPlayer самостоятельно для воспроизведения аудиоконтента (например, Audio), или можно использовать его совместно с VideoOutput для рендеринга видео.

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

    VideoOutput {
        anchors.fill: parent
        source: mediaplayer
    }

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

См. также VideoOutput.

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

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

Это свойство содержит роль аудиопотока. Его можно установить, чтобы указать тип воспроизводимого аудио, что позволяет системе принимать соответствующие решения в отношении громкости, маршрутизации или пост-обработки.

Роль аудио необходимо установить до установки свойства source.

Поддерживаемые значения можно получить с помощью supportedAudioRoles().

Значение может быть одним из следующих:

• UnknownRole - роль неизвестна или не определена.
• MusicRole - музыка.
• VideoRole - саундтрек из фильма или видео.
• VoiceCommunicationRole - голосовые коммуникации, такие как телефония.
• AlarmRole - будильник.
• NotificationRole - уведомление, например, входящее электронное письмо или запрос чата.
• RingtoneRole - мелодия.
• AccessibilityRole - для доступности, например, с помощью экранного диктора.
• SonificationRole - сонификация, например, с помощью звуков пользовательского интерфейса.
• GameRole - звуки игры.

Это свойство QML было введено в Qt 5.6.

autoLoad : bool

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

По умолчанию значение true, если false — медиа не будет загружено до начала воспроизведения.

autoPlay : bool

Это свойство управляет тем, будет ли медиа воспроизводиться при запуске.

По умолчанию false. Если установлено значение true, значение autoLoad будет перезаписано на true.

availability : enumeration

Возвращает состояние доступности медиаплеера.

Это одно из значений:

bufferProgress : real

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

Воспроизведение может начаться или возобновиться только при полном заполнении буфера, в этом случае статус MediaPlayer.Buffered или MediaPlayer.Buffering. Значение, меньшее, чем 1.0 означает, что статус MediaPlayer.Stalled.

См. также status.

duration : int

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

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

error : enumeration

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

errorString : string

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

hasAudio : bool

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

hasVideo : bool

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

loops : int

Это свойство содержит количество воспроизведений медиа. Значение 0 или 1 означает, что медиа будет воспроизведено только один раз; установите MediaPlayer.Infinite для включения бесконечного цикла воспроизведения.

Значение может быть изменено во время воспроизведения, в этом случае оставшееся количество циклов будет обновлено до нового значения.

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

mediaObject : variant

Это свойство содержит нативный объект медиа.

Его можно использовать для получения указателя на объект QMediaPlayer, чтобы интегрировать его с кодом C++.

QObject *qmlMediaPlayer; // The QML MediaPlayer object
QMediaPlayer *player = qvariant_cast<QMediaPlayer *>(qmlMediaPlayer->property("mediaObject"));

Примечание: Это свойство недоступно из QML.

metaData.title : variant

Эти свойства содержат метаданные для текущего медиа.

• metaData.title - название медиа.
• metaData.subTitle - подзаголовок медиа.
• metaData.author - автор медиа.
• metaData.comment - комментарий пользователя к медиа.
• metaData.description - описание медиа.
• metaData.category - категория медиа.
• metaData.genre - жанр медиа.
• metaData.year - год выпуска медиа.
• metaData.date - дата медиа.
• metaData.userRating - рейтинг пользователя медиа в диапазоне от 0 до 100.
• metaData.keywords - список ключевых слов, описывающих медиа.
• metaData.language - язык медиа в соответствии с кодом ISO 639-2.
• metaData.publisher - издатель медиа.
• metaData.copyright - авторское право на медиа.
• metaData.parentalRating - рейтинг для детей медиа.
• metaData.ratingOrganization - название организации, ответственной за рейтинги для детей медиа.
• metaData.size - размер медиа в байтах.
• metaData.mediaType - тип медиа.
• metaData.audioBitRate - битрейт аудиопотока медиа в битах в секунду.
• metaData.audioCodec - кодирование аудиопотока медиа.
• metaData.averageLevel - средний уровень громкости медиа.
• metaData.channelCount - количество каналов в аудиопотоке медиа.
• metaData.peakValue - максимальный уровень громкости аудиопотока медиа.
• metaData.sampleRate - частота дискретизации аудиопотока медиа в герцах.
• metaData.albumTitle - название альбома, к которому относится медиа.
• metaData.albumArtist - имя основного исполнителя альбома, к которому относится медиа.
• metaData.contributingArtist - имена исполнителей, участвующих в медиа.
• metaData.composer - композитор медиа.
• metaData.conductor - дирижер медиа.
• metaData.lyrics - тексты песен к медиа.
• metaData.mood - настроение медиа.
• metaData.trackNumber - номер трека медиа.
• metaData.trackCount - количество треков в альбоме, содержащем медиа.
• metaData.coverArtUrlSmall - URL изображения обложки малого размера.
• metaData.coverArtUrlLarge - URL изображения обложки большого размера.
• metaData.resolution - размер изображения или видео.
• metaData.pixelAspectRatio - соотношение сторон пикселей изображения или видео.
• metaData.videoFrameRate - частота кадров видеопотока медиа.
• metaData.videoBitRate - битрейт видеопотока медиа в битах в секунду.
• metaData.videoCodec - кодирование видеопотока медиа.
• metaData.posterUrl - URL изображения постера.
• metaData.chapterNumber - номер главы медиа.
• metaData.director - режиссер медиа.
• metaData.leadPerformer - ведущий исполнитель в медиа.
• metaData.writer - автор медиа.

См. также QMediaMetaData.

muted : bool

Это свойство указывает, выключен ли выход аудио.

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

notifyInterval : int

Интервал, с которым будут обновляться уведомляемые свойства.

Уведомляемыми свойствами являются position и bufferProgress.

Интервал выражается в миллисекундах, значение по умолчанию — 1000.

Это свойство QML было добавлено в Qt 5.9.

playbackRate : real

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

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

playbackState : enumeration

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

• PlayingState - медиа в настоящее время воспроизводится.
• PausedState - воспроизведение медиа приостановлено.
• StoppedState - воспроизведение медиа еще не начато.

playlist : Playlist

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

Установка свойства playlist сбрасывает source на пустую строку.

Это свойство QML было добавлено в Qt 5.6.

position : int

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

Для изменения этой позиции используйте метод seek().

См. также seek().

seekable : bool

Это свойство содержит информацию о возможности изменения позиции аудио.

Если true, вызов метода seek() приведет к переходу воспроизведения на новую позицию.

source : url

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

Установка свойства source очищает текущий playlist, если он есть.

status : enumeration

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

• NoMedia — нет заданных данных мультимедиа.
• Loading — мультимедиа загружается в данный момент.
• Loaded — мультимедиа загружено.
• Buffering — мультимедиа буферизует данные.
• Stalled — воспроизведение прервано во время буферизации данных мультимедиа.
• Buffered — данные мультимедиа буферизованы.
• EndOfMedia — мультимедиа воспроизведена до конца.
• InvalidMedia — мультимедиа не может быть воспроизведена.
• UnknownStatus — статус мультимедиа неизвестен.

volume : real

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

Громкость масштабируется линейно от 0.0 (тишина) до 1.0 (полная громкость). Значения вне этого диапазона будут ограничены.

Значение по умолчанию для громкости — 1.0.

Элементы управления громкостью пользовательского интерфейса обычно масштабируются нелинейно. Например, использование логарифмической шкалы приведет к линейным изменениям воспринимаемой громкости, что обычно ожидается от элемента управления громкостью. Подробнее см. QtMultimedia.convertVolume().

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

error(error, errorString)

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

Соответствующий обработчик — onError.

paused()

Этот сигнал генерируется при приостановке воспроизведения.

Соответствующий обработчик — onPaused.

playbackStateChanged()

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

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

playing()

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

Соответствующий обработчик — onPlaying.

stopped()

Этот сигнал генерируется при остановке воспроизведения.

Соответствующий обработчик — onStopped.

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

pause()

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

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

play()

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

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

seek(offset)

Если свойство seekable имеет значение true, переходит к текущей позиции воспроизведения offset.

Переход может быть асинхронным, поэтому свойство position может не обновиться немедленно.

См. также seekable и position.

stop()

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

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

list<int> supportedAudioRoles()

Возвращает список поддерживаемых ролей аудио.

Если установка роли аудио не поддерживается, возвращается пустой список.

Этот метод QML был добавлен в Qt 5.6.

См. также audioRole.