Тип 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
• playbackRate : вещественное
• playbackState : перечисление
• 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 : real

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

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

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

duration : int

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

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

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

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

errorString : строка

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

hasAudio : bool

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

hasVideo : bool

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

loops : int

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

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

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

playbackRate : real

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

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

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

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

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

playlist : Playlist

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

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

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

position : int

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

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

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

seekable : bool

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

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

source : url

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

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

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

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

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

volume : real

Это свойство содержит громкость аудиовыхода, от 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.