QtMultimedia QML Тип

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

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

Свойства

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

Методы

• вещественное число convertVolume(громкость, МасштабГромкости из, МасштабГромкости в)

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

Объект 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(громкость, МасштабГромкости из, МасштабГромкости в)

Преобразует аудио громкость из одного масштаба громкости в другой и возвращает результат.

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

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

• 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 — логарифмическая шкала децибел (дБ, амплитуда). -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.