Тип MediaPlayer QML

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

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

Свойства

• audioRole : перечисление
• autoLoad : bool
• autoPlay : bool
• availability : перечисление
• bufferProgress : real
• customAudioRole : строка
• 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 самостоятельно для воспроизведения аудиоконтента (например, Аудио), или вы можете использовать его в сочетании с 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 : Playlist

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

Установка свойства 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.

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.