Тип QML Video

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

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

Свойства

• audioRole : перечисление
• autoLoad : bool
• autoPlay : bool
• доступность : перечисление
• прогресс буферизации : вещественное число
• длительность : целое число
• ошибка : перечисление
• описание ошибки : строка
• режим заполнения : перечисление
• имеет аудио : bool
• имеет видео : bool
• циклы : целое число
• метаданные : объект
• выключен звук : bool
• интервал уведомлений : целое число
• ориентация : целое число
• скорость воспроизведения : вещественное число
• состояние воспроизведения : перечисление
• список воспроизведения : Список воспроизведения
• позиция : целое число
• доступный для поиска : bool
• источник : url
• состояние : перечисление
• громкость : вещественное число

Сигналы

• приостановлено()
• воспроизведение()
• остановлено()

Методы

• приостановить()
• воспроизвести()
• перейти к(смещение)
• остановить()
• поддерживаемые роли аудио()

Подробное описание

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 поддерживает представление видео без преобразований, растяжение и равномерное масштабирование. Описание растяжения и равномерного масштабирования см. в описании свойства режим заполнения.

См. также 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.

доступность : перечисление

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

Это одно из:

прогресс буферизации : вещественное число

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

длительность : целое число

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

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

ошибка : перечисление

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

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

описание ошибки : строка

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

режим заполнения : перечисление

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

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

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

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

имеет аудио : bool

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

имеет видео : bool

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

циклы : целое число

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

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

По умолчанию 1.

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

metaData : object

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

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

См. также QMediaMetaData.

muted : bool

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

notifyInterval : int

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

Уведомляемые свойства — это position и bufferProgress.

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

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

orientation : int

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

playbackRate : real

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

playbackState : enumeration

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

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

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

playlist : Playlist

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

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

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

position : int

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

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

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

seekable : bool

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

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

source : url

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

Установка свойства источника очищает текущий playlist, если таковой имеется.

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().

Signal Documentation

paused()

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

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

playing()

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

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

stopped()

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

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

Method Documentation

pause()

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

play()

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

seek(offset)

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

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

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

stop()

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

supportedAudioRoles()

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

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

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

См. также audioRole.