Тип QML Video

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

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

Свойства

• 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

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

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