Тип QML Audio

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

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

Свойства

• audioRole : перечисление
• autoLoad : bool
• autoPlay : bool
• availability : перечисление
• bufferProgress : вещественное
• 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 : вещественное
• playbackState : перечисление
• playlist : Playlist
• position : int
• seekable : bool
• source : url
• status : перечисление
• volume : вещественное

Сигналы

• 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;

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

См. также Видео.

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

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 (полностью).

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

См. также статус.

duration : целое число

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

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

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

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

errorString : строка

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

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

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

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

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

loops : целое число

Это свойство хранит количество раз, которое медиа будет воспроизведено. Значение 0 или 1 означает, что медиа будет воспроизведено только один раз; установите значение Audio.Infinite, чтобы включить бесконечное повторение.

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

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

mediaObject : variant

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

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

QObject *qmlAudio; // The QML Audio object
QMediaPlayer *player = qvariant_cast<QMediaPlayer *>(qmlAudio->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 : логическое

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

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

notifyInterval : целое число

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

Уведомляемые свойства — позиция и bufferProgress.

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

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

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

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

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

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

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

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

playlist : Playlist

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

Установка свойства списка воспроизведения сбрасывает свойство источник на пустую строку.

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

position : целое число

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

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

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

seekable : логическое

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

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

source : url

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

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

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

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

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

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

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

Громкость масштабируется линейно от 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.