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 в другую, и возвращает результат.

В зависимости от контекста для представления громкости звука используются разные шкалы. Все классы 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
}

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