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.