Тип 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 : 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.

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.