QtMultimedia QML Тип

Предоставляет глобальный объект с полезными функциями из Qt Multimedia. Подробнее...

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

Свойства

• availableCameras : список<объект>
• defaultCamera : объект

Методы

• вещественное convertVolume(вещественное volume, VolumeScale from, VolumeScale to)

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

Объект QtMultimedia — глобальный объект с полезными функциями и свойствами.

Он не может быть создан; чтобы использовать его, вызовите члены глобального объекта QtMultimedia напрямую. Например:

Camera {
    deviceId: QtMultimedia.defaultCamera.deviceId
}

Документация по свойствам

[только для чтения] availableCameras : список<объект>

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

Каждый объект в списке имеет следующие свойства:

Примечание: Это свойство статическое; оно не обновляется при добавлении или удалении камер из системы, например, USB-камер на настольной платформе.

Следующий пример демонстрирует, как отобразить список доступных камер. Пользователь может изменить активную камеру, выбрав один из элементов в списке.

Item {

    Camera {
        id: camera
    }

    VideoOutput {
        anchors.fill: parent
        source: camera
    }

    ListView {
        anchors.fill: parent

        model: QtMultimedia.availableCameras
        delegate: Text {
            text: modelData.displayName

            MouseArea {
                anchors.fill: parent
                onClicked: camera.deviceId = modelData.deviceId
            }
        }
    }
}

[только для чтения] defaultCamera : объект

Объект defaultCamera предоставляет информацию о стандартной камере в системе.

Его свойства — deviceId, displayName, position и orientation. См. availableCameras для описания каждого из них.

Если стандартной камеры нет, defaultCamera.deviceId будет содержать пустую строку.

Примечание: Это свойство статическое; оно не обновляется, если стандартная камера системы изменяется после запуска приложения.

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

вещественное convertVolume(вещественное volume, VolumeScale from, VolumeScale to)

Преобразует значение громкости volume из одной шкалы from в другую to и возвращает результат.

В зависимости от контекста используются разные шкалы для представления громкости звука. Все классы Qt Multimedia, имеющие громкость звука, используют линейную шкалу, поскольку громкость динамика регулируется путем модуляции его напряжения по линейной шкале. Однако человеческое ухо воспринимает громкость по логарифмической шкале. Поэтому в большинстве приложений целесообразно использовать логарифмическую шкалу для управления громкостью. Шкала децибел (dB) по своей природе логарифмическая и обычно используется для определения уровня звука, она обычно используется для управления громкостью в пользовательском интерфейсе профессиональных аудиоприложений. Кубическая шкала является вычислительно недорогим приближением логарифмической шкалы, позволяющим лучше управлять более низкими уровнями громкости.

Допустимые значения для from и to:

• QtMultimedia.LinearVolumeScale — Линейная шкала. 0.0 (0%) — это тишина, а 1.0 (100%) — это полная громкость. Все типы Qt Multimedia, имеющие громкость звука, используют линейную шкалу.
• QtMultimedia.CubicVolumeScale — Кубическая шкала. 0.0 (0%) — это тишина, а 1.0 (100%) — это полная громкость.
• QtMultimedia.LogarithmicVolumeScale — Логарифмическая шкала. 0.0 (0%) — это тишина, а 1.0 (100%) — это полная громкость. В управления громкостью пользовательского интерфейса обычно следует использовать логарифмическую шкалу.
• QtMultimedia.DecibelVolumeScale — Логарифмическая шкала децибелов (dB, амплитуда). -200 — это тишина, а 0 — это полная громкость.

Следующий пример демонстрирует, как значение громкости из управления громкостью в пользовательском интерфейсе можно преобразовать таким образом, чтобы воспринимаемое увеличение громкости было одинаковым при увеличении громкости от 0,2 до 0,3 и от 0,5 до 0,6:

Slider {
    id: volumeSlider

    property real volume: QtMultimedia.convertVolume(volumeSlider.value,
                                                     QtMultimedia.LogarithmicVolumeScale,
                                                     QtMultimedia.LinearVolumeScale)
}

MediaPlayer {
    volume: volumeSlider.volume
}

Этот QML-метод был введен в Qt 5.8.