Тип QML Видео

Удобный тип для отображения указанного видео. Подробнее...

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

Свойства

• audioRole : перечисление
• autoLoad : bool
• autoPlay : bool
• availability : перечисление
• bufferProgress : real
• customAudioRole : строка
• duration : int
• error : перечисление
• errorString : строка
• fillMode : перечисление
• hasAudio : bool
• hasVideo : bool
• loops : int
• metaData : объект
• muted : bool
• notifyInterval : int
• orientation : int
• playbackRate : real
• playbackState : перечисление
• playlist : Плейлист
• position : int
• seekable : bool
• source : url
• status : перечисление
• volume : real

Сигналы

• paused()
• playing()
• stopped()

Методы

• pause()
• play()
• seek(offset)
• stop()
• supportedAudioRoles()

Подробное описание

Video — это удобный тип, объединяющий функциональность MediaPlayer и VideoOutput в одном. Он предоставляет простую функциональность воспроизведения видео без необходимости объявлять несколько типов.

Video {
    id: video
    width : 800
    height : 600
    source: "video.avi"

    MouseArea {
        anchors.fill: parent
        onClicked: {
            video.play()
        }
    }

    focus: true
    Keys.onSpacePressed: video.playbackState == MediaPlayer.PlayingState ? video.pause() : video.play()
    Keys.onLeftPressed: video.seek(video.position - 5000)
    Keys.onRightPressed: video.seek(video.position + 5000)
}

Video поддерживает представление видео без преобразований, с растяжением и с равномерным масштабированием. Описание растяжения с равномерным масштабированием см. в описании свойства fillMode.

См. также MediaPlayer и VideoOutput.

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

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

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

Роль аудио необходимо установить перед установкой свойства source.

Поддерживаемые значения можно получить с помощью supportedAudioRoles().

Значение может быть одним из:

• MediaPlayer.UnknownRole — роль неизвестна или не определена.
• MediaPlayer.MusicRole — музыка.
• MediaPlayer.VideoRole — саундтрек из фильма или видео.
• MediaPlayer.VoiceCommunicationRole — голосовая связь, например, телефонный разговор.
• MediaPlayer.AlarmRole — звуковой сигнал тревоги.
• MediaPlayer.NotificationRole — уведомление, например, входящее электронное письмо или запрос в чат.
• MediaPlayer.RingtoneRole — мелодия звонка.
• MediaPlayer.AccessibilityRole — для обеспечения доступности, например, с помощью программы чтения с экрана.
• MediaPlayer.SonificationRole — сонификация, например, с помощью звуков пользовательского интерфейса.
• MediaPlayer.GameRole — аудио для игры.
• MediaPlayer.CustomRole — роль задается свойством customAudioRole.

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

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

autoLoad : bool

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

По умолчанию значение true, если false, медиа не будут загружены до начала воспроизведения.

autoPlay : bool

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

Установка в true также устанавливает autoLoad в true. По умолчанию false.

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

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

Это одно из:

bufferProgress : real

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

customAudioRole : строка

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

Роль аудио необходимо установить перед установкой свойства source.

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

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

duration : int

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

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

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

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

• MediaPlayer.NoError — текущая ошибка отсутствует.
• MediaPlayer.ResourceError — видео не может быть воспроизведено из-за проблемы с выделением ресурсов.
• MediaPlayer.FormatError — формат видео не поддерживается.
• MediaPlayer.NetworkError — видео не может быть воспроизведено из-за проблем с сетью.
• MediaPlayer.AccessDenied — видео не может быть воспроизведено из-за недостаточных разрешений.
• MediaPlayer.ServiceMissing — видео не может быть воспроизведено, потому что служба медиа не могла быть инициализирована.

errorString : строка

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

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

Установите это свойство, чтобы определить, как видео масштабируется для соответствия целевому области.

• VideoOutput.Stretch - видео масштабируется для заполнения
• VideoOutput.PreserveAspectFit - видео масштабируется равномерно для заполнения без обрезки
• VideoOutput.PreserveAspectCrop - видео масштабируется равномерно для заполнения, с обрезкой при необходимости

Поскольку этот тип предназначен для удобства в QML, он не поддерживает перечисления напрямую, поэтому для доступа к доступным режимам заполнения используются перечисления из VideoOutput.

По умолчанию используется режим заполнения preserveAspectFit.

hasAudio : bool

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

hasVideo : bool

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

loops : int

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

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

По умолчанию установлено значение 1.

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

metaData : object

Это свойство содержит метаданные текущего медиа.

Подробности о каждом ключе метаданных см. в MediaPlayer.metaData.

См. также QMediaMetaData.

muted : bool

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

notifyInterval : int

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

Уведомляемые свойства — это position и bufferProgress.

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

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

orientation : int

Ориентация Video в градусах. Поддерживаются только кратные 90 градусам значения, такие как 0, 90, 180, 270, 360 и т.д.

playbackRate : real

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

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

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

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

По умолчанию состояние MediaPlayer.StoppedState.

playlist : Playlist

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

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

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

position : int

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

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

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

seekable : bool

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

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

source : url

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

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

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

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

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

volume : real

Это свойство содержит значение громкости аудио.

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

Значение громкости по умолчанию равно 1.0.

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

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

paused()

Этот сигнал испускается при приостановке воспроизведения.

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

playing()

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

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

stopped()

Этот сигнал испускается при остановке воспроизведения.

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

Документация по методам

pause()

Приостанавливает воспроизведение медиа.

play()

Запускает воспроизведение медиа.

seek(offset)

Если свойство seekable имеет значение true, переводит текущую позицию воспроизведения на offset.

Переход может быть асинхронным, поэтому свойство position может не обновиться немедленно.

См. также seekable и position.

stop()

Останавливает воспроизведение медиа.

supportedAudioRoles()

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

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

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

См. также audioRole.