Тип QML Video

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

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

Свойства

• audioRole : перечисление
• autoLoad : bool
• autoPlay : bool
• availability : перечисление
• bufferProgress : real
• duration : int
• error : перечисление
• errorString : строка
• fillMode : перечисление
• hasAudio : bool
• hasVideo : bool
• metaData : объект
• muted : bool
• 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 - аудио для игр.

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

autoLoad : bool

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

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

autoPlay : bool

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

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

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

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

Это одно из:

bufferProgress : real

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

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

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

metaData : объект

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

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

См. также QMediaMetaData.

muted : bool

Это свойство содержит информацию о том, заглушен ли выход аудио.

orientation : int

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

playbackRate : real

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

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

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

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

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

playlist : Playlist

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

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

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

position : int

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

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

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

seekable : bool

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

Если значение истинно, вызов метода 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 (максимальная громкость).

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

paused()

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

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

playing()

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

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

stopped()

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

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

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

pause()

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

play()

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

seek(offset)

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

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

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

stop()

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

supportedAudioRoles()

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

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

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

См. также audioRole.