Тип QML MediaPlayer

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

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

Свойства

• audioRole : перечисление
• autoLoad : bool
• autoPlay : bool
• availability : перечисление
• bufferProgress : real
• customAudioRole : string
• duration : int
• error : перечисление
• errorString : string
• hasAudio : bool
• hasVideo : bool
• loops : int
• mediaObject : variant
• 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
• notifyInterval : int
• playbackRate : real
• playbackState : перечисление
• playlist : 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 - аудио игры.
• CustomRole - роль задаётся свойством customAudioRole.

customAudioRole очищается, когда это свойство установлено на любое значение, кроме CustomRole.

Это свойство было добавлено в 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.

customAudioRole : string

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

Роль аудио должна быть установлена до задания свойства source.

audioRole устанавливается в CustomRole, когда это свойство установлено.

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

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.

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

playbackRate : real

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

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

playbackState : enumeration

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

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

playlist : Плейлист

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

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

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

position : int

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

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

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

seekable : bool

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

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

source : url

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

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

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

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

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

volume : real

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

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

Значение по умолчанию — 1.0.

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

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

error(error, errorString)

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

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

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

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.

список<int> supportedAudioRoles()

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

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

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

См. также audioRole.