Qt Multimedia QML API

Обзор

Модуль Qt Multimedia предоставляет разработчикам упрощенный способ использования аудио- и видеовоспроизведения, а также доступа к функциям камеры. QML API Multimedia предоставляет QML-совместимый интерфейс для этих функций.

Типы

Аудио

Аудио — простой способ добавления аудиовоспроизведения в сцену Qt Quick. Qt Multimedia предоставляет свойства для управления, методы (функции) и сигналы.

Ниже приведен фрагмент кода, демонстрирующий создание и использование экземпляра Audio.

Item {
    width: 640
    height: 360

    Audio {
        id: playMusic
        source: "music.wav"
    }

    MouseArea {
        id: playArea
        anchors.fill: parent
        onPressed:  { playMusic.play() }
    }
}

Приведенный фрагмент кода демонстрирует, как включение playMusic позволяет использовать аудиофункции в типе, содержащем его. Таким образом, при щелчке области MouseArea родительского элемента вызывается метод play() типа Audio. Доступны и другие типичные методы управления аудио, такие как pause() и stop().

Большая часть операций получения/установки параметров Аудио выполняется через свойства. К ним относятся

Набор доступных сигналов позволяет разработчику создавать пользовательское поведение при наступлении следующих событий:

Камера

Камера позволяет выполнять захват статических изображений и видео с помощью QML. Она имеет ряд свойств, которые помогают в настройке.

Подробное описание использования Камеры приведено в Обзоре камеры и соответствующей справочной документации.

Видео

Добавление видеовоспроизведения (с звуком) в сцену Qt Quick также просто. Процесс очень похож на процесс с Аудио, описанный выше; в действительности Видео разделяет многие имена свойств, методы и сигналы. Вот эквивалентный пример кода для реализации видеовоспроизведения в сцене

Video {
    id: video
    width : 800
    height : 600
    source: "video.avi"

    MouseArea {
        anchors.fill: parent
        onClicked: {
            video.play()
        }
    }

    focus: true
    Keys.onSpacePressed: video.paused = !video.paused
    Keys.onLeftPressed: video.position -= 5000
    Keys.onRightPressed: video.position += 5000
}

Существуют аналогичные функции, такие как play() с новыми функциями, специфичными для видео.

В приведенном выше примере при щелчке родительского элемента MouseArea в области размером 800x600 пикселей с идентификатором 'video' будет воспроизводиться источник "video.avi". Обратите также внимание, что определены сигналы для Клавиш, так что нажатие пробела переключает кнопку паузы; нажатие стрелки влево переместит текущее положение в видео на 5 секунд назад; и нажатие стрелки вправо переместит текущее положение в видео на 5 секунд вперед.

Большинство различий, очевидно, связаны с управлением видео и информацией о нем. Существует множество свойств, связанных с Видео, большинство из них связаны с метаданными, управлением видео и аспектами презентации.

Звуковой эффект

Звуковой эффект предоставляет способ воспроизведения коротких звуковых эффектов, например, в видеоиграх. Несколько экземпляров звуковых эффектов могут воспроизводиться одновременно. Для воспроизведения музыки используйте Аудио.

Item {
    width: 640
    height: 360

    SoundEffect {
        id: effect
        source: "test.wav"
    }
    MouseArea {
        id: playArea
        anchors.fill: parent
        onPressed:  { effect.play() }
    }
}

В приведенном выше примере звуковой эффект будет воспроизводиться при нажатии на MouseArea.

Для получения полного описания этого типа см. Звуковой эффект

Типы QML мультимедиа