Тип QML Video

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

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

Свойства

• audioRole : перечисление
• autoLoad : bool
• autoPlay : bool
• availability : перечисление
• bufferProgress : real
• customAudioRole : string
• duration : int
• error : перечисление
• errorString : string
• fillMode : перечисление
• flushMode : перечисление
• hasAudio : bool
• hasVideo : bool
• loops : int
• metaData : object
• muted : bool
• notifyInterval : int
• orientation : int
• playbackRate : real
• playbackState : перечисление
• playlist : 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 : enumeration

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

Это может быть одно из следующих значений:

bufferProgress : real

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

customAudioRole : string

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

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

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

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

duration : int

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

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

error : enumeration

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

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

errorString : string

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

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

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

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

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

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

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

Установите это свойство, чтобы определить, что должно отображаться Video, когда воспроизведение завершено или остановлено.

• VideoOutput.EmptyFrame - очищает вывод видео.
• VideoOutput.FirstFrame - отображает первый допустимый кадр.
• VideoOutput.LastFrame - отображает последний допустимый кадр.

По умолчанию режим flush — EmptyFrame.

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

hasAudio : bool

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

hasVideo : bool

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

loops : int

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

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

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

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

metaData : объект

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

См. MediaPlayer.metaData для получения подробностей о каждом ключе метаданных.

См. также QMediaMetaData.

muted : bool

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

notifyInterval : int

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

Оповещаемые свойства — position и bufferProgress.

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

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

orientation : int

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

playbackRate : вещественное

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

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

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

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

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

playlist : Плейлист

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

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

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

position : int

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

Чтобы изменить эту позицию, используйте метод seek().

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

seekable : bool

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

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

source : url

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

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

status : enumeration

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

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

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

playing()

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

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

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

stopped()

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

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

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

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

pause()

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

play()

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

seek(offset)

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

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

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

stop()

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

supportedAudioRoles()

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

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

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

См. также audioRole.