QtMultimedia QML Тип

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

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

Свойства

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

Методы

• вещественный convertVolume(вещественный volume, МасштабГромкости from, МасштабГромкости 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, МасштабГромкости from, МасштабГромкости to)

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

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

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

• QtMultimedia.ЛинейнаяШкалаГромкости — Линейная шкала. 0.0 (0%) — это тишина, а 1.0 (100%) — это полная громкость. Все типы Qt Multimedia, имеющие громкость звука, используют линейную шкалу.
• QtMultimedia.КубическаяШкалаГромкости — Кубическая шкала. 0.0 (0%) — это тишина, а 1.0 (100%) — это полная громкость.
• QtMultimedia.ЛогарифмическаяШкалаГромкости — Логарифмическая шкала. 0.0 (0%) — это тишина, а 1.0 (100%) — это полная громкость. В пользовательских интерфейсах для управления громкостью обычно используется логарифмическая шкала.
• QtMultimedia.ДецибельнаяШкалаГромкости — Логарифмическая шкала децибел (дБ, амплитуда). -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.