Тип QML MediaDevices
MediaDevices предоставляет информацию об имеющихся мультимедийных устройствах ввода и вывода. Подробнее...
| Заявление об импорте: | import QtMultimedia |
| Инициализирует: | QMediaDevices |
Свойства
- audioInputs : список<audioDevice>
- audioOutputs : список<audioDevice>
- defaultAudioInput : audioDevice
- defaultAudioOutput : audioDevice
- defaultVideoInput : cameraDevice
- videoInputs : список<cameraDevice>
Подробное описание
Тип MediaDevices предоставляет информацию о доступных мультимедийных устройствах и системных значениях по умолчанию. Он отслеживает следующие три группы:
- Устройства аудиоввода (микрофоны)
- Устройства аудиовывода (динамики, гарнитуры)
- Устройства видеоввода (камеры)
MediaDevices предоставляет отдельный список для каждой группы устройств. Если обнаруживается подключение нового устройства к системе или отключение подключённого устройства, список соответствующих устройств обновляется, и генерируется сигнал об изменении.
MediaDevices отслеживает системные значения по умолчанию для каждой группы устройств. Он будет оповещать о любых изменениях, внесённых через системные настройки. Например, если пользователь выбирает новый аудиовыход по умолчанию в системных настройках, MediaDevices соответствующим образом обновит значение аудиовыхода по умолчанию и сгенерирует сигнал. Если система не предоставляет значения по умолчанию для камеры или аудиоввода, MediaDevices выберет первое устройство из списка в качестве устройства по умолчанию.
Хотя использование устройств ввода и вывода по умолчанию часто достаточно для воспроизведения или записи мультимедиа, часто возникает необходимость в явном выборе устройства для использования.
Например, фрагмент кода ниже обеспечит, что медиаплеер всегда будет использовать системное устройство аудиовывода по умолчанию для воспроизведения:
MediaDevices {
id: devices
}
MediaPlayer {
...
audioOutput: AudioOutput {
device: devices.defaultAudioOutput
}
} См. также Camera, AudioInput и VideoOutput.
Документация по свойствам
audioInputs : список<audioDevice>
Содержит список доступных устройств аудиоввода в системе.
Эти устройства обычно являются микрофонами. Устройства могут быть встроенными или подключенными, например, через USB или Bluetooth.
audioOutputs : список<audioDevice>
Содержит список доступных устройств аудиовывода в системе.
Эти устройства обычно являются динамиками или гарнитурами. Устройства могут быть встроенными или подключенными, например, через USB или Bluetooth.
defaultAudioInput : audioDevice
Возвращает устройство аудиоввода по умолчанию.
Устройство по умолчанию может меняться во время работы приложения. Значение этого свойства автоматически корректируется в соответствии с такими изменениями.
defaultAudioOutput : audioDevice
Возвращает устройство аудиовывода по умолчанию.
Устройство по умолчанию может меняться во время работы приложения. Значение этого свойства автоматически корректируется в соответствии с такими изменениями.
defaultVideoInput : cameraDevice
Возвращает камеру по умолчанию в системе.
Примечание: Возвращаемый объект следует проверять с помощью isNull() перед использованием, на случай, если камера недоступна.
Устройство по умолчанию может меняться во время работы приложения. Значение этого свойства автоматически корректируется в соответствии с такими изменениями.
videoInputs : список<cameraDevice>
Содержит список камер в системе.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qml-qtmultimedia-mediadevices.html