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