Тип QML MediaPlayer

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

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

Свойства

• audioRole : перечисление
• autoLoad : bool
• autoPlay : bool
• availability : перечисление
• bufferProgress : real
• duration : int
• error : перечисление
• errorString : строка
• hasAudio : bool
• hasVideo : bool
• loops : int
• mediaObject : вариант
• metaData
  • metaData.title : variant
  • metaData.subTitle : variant
  • metaData.author : variant
  • metaData.comment : variant
  • metaData.description : variant
  • metaData.category : variant
  • metaData.genre : variant
  • metaData.year : variant
  • metaData.date : variant
  • metaData.userRating : variant
  • metaData.keywords : variant
  • metaData.language : variant
  • metaData.publisher : variant
  • metaData.copyright : variant
  • metaData.parentalRating : variant
  • metaData.ratingOrganization : variant
  • metaData.size : variant
  • metaData.mediaType : variant
  • metaData.audioBitRate : variant
  • metaData.audioCodec : variant
  • metaData.averageLevel : variant
  • metaData.channelCount : variant
  • metaData.peakValue : variant
  • metaData.sampleRate : variant
  • metaData.albumTitle : variant
  • metaData.albumArtist : variant
  • metaData.contributingArtist : variant
  • metaData.composer : variant
  • metaData.conductor : variant
  • metaData.lyrics : variant
  • metaData.mood : variant
  • metaData.trackNumber : variant
  • metaData.trackCount : variant
  • metaData.coverArtUrlSmall : variant
  • metaData.coverArtUrlLarge : variant
  • metaData.resolution : variant
  • metaData.pixelAspectRatio : variant
  • metaData.videoFrameRate : variant
  • metaData.videoBitRate : variant
  • metaData.videoCodec : variant
  • metaData.posterUrl : variant
  • metaData.chapterNumber : variant
  • metaData.director : variant
  • metaData.leadPerformer : variant
  • metaData.writer : variant
• muted : bool
• 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 : перечисление

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

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

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

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

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

См. также status.

duration : целое

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

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

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

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

errorString : строка

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

hasAudio : bool

Этот параметр содержит значение, указывающее, содержит ли медиа аудио.

hasVideo : bool

Этот параметр содержит значение, указывающее, содержит ли медиа видео.

loops : целое

Этот параметр содержит количество повторов воспроизведения медиа. Значение 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.

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

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

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

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

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

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

playlist : Playlist

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

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

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

position : целое

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

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

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

seekable : bool

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

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

source : url

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

Установление параметра source очищает текущий плейлист, если таковой имеется.

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

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

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

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

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

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

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

error(error, errorString)

Этот сигнал излучается при возникновении ошибки. Параметр 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.