Класс QMediaDevices
Класс QMediaDevices предоставляет информацию об имеющихся устройствах ввода и вывода мультимедиа. Подробнее...
| Заголовок: | #include <QMediaDevices> |
| CMake: | find_package(Qt6 COMPONENTS Multimedia REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake: | QT += multimedia |
| Создаётся из: | MediaDevices |
| Наследует: | QObject |
Сигналы
| void | audioInputsChanged() |
| void | audioOutputsChanged() |
| void | videoInputsChanged() |
Статические публичные члены
| QList<QAudioDevice> | audioInputs() |
| QList<QAudioDevice> | audioOutputs() |
| QAudioDevice | defaultAudioInput() |
| QAudioDevice | defaultAudioOutput() |
| QCameraDevice | defaultVideoInput() |
| QList<QCameraDevice> | videoInputs() |
Подробное описание
Класс QMediaDevices предоставляет информацию об имеющихся мультимедийных устройствах и значениях по умолчанию для системы. Он отслеживает три группы:
- Устройства ввода аудио (Микрофоны)
- Устройства вывода аудио (Динамики, наушники)
- Устройства ввода видео (Камеры)
QMediaDevices предоставляет отдельный список для каждой группы устройств. Если он обнаруживает подключение нового устройства к системе или отключение подключённого устройства, он обновит соответствующий список устройств и отправит сигнал, уведомляющий об изменении.
QMediaDevices отслеживает значения по умолчанию для каждой группы устройств. Он будет сообщать о любых изменениях, сделанных через системные настройки. Например, если пользователь выбирает новый стандартный аудиовыход в системных настройках, QMediaDevices обновит стандартный аудиовыход соответственно и отправит сигнал. Если система не предоставляет значение по умолчанию для камеры или устройства ввода аудио, QMediaDevices выберет первое устройство из списка в качестве устройства по умолчанию.
Хотя часто достаточно использовать устройства по умолчанию для воспроизведения или записи мультимедиа, часто требуется явно выбрать используемое устройство.
QMediaDevices — это объект-синглтон, и все методы-получатели являются потокобезопасными.
Документация по функциям-членам
[static] QList<QAudioDevice> QMediaDevices::audioInputs()
Возвращает список доступных устройств ввода аудио в системе.
Эти устройства обычно являются микрофонами. Устройства могут быть встроенными или подключенными, например, через USB или Bluetooth.
Примечание: Метод-получатель для свойства audioInputs.
[static] QList<QAudioDevice> QMediaDevices::audioOutputs()
Возвращает список доступных устройств вывода аудио в системе.
Эти устройства обычно являются динамиками или гарнитурами. Устройства могут быть встроенными или подключенными, например, через USB или Bluetooth.
Примечание: Метод-получатель для свойства audioOutputs.
[static] QAudioDevice QMediaDevices::defaultAudioInput()
Возвращает устройство ввода аудио по умолчанию.
Устройство по умолчанию может измениться во время работы приложения. В этом случае испускается сигнал audioInputsChanged().
Примечание: Метод-получатель для свойства defaultAudioInput.
[static] QAudioDevice QMediaDevices::defaultAudioOutput()
Возвращает устройство вывода аудио по умолчанию.
Устройство по умолчанию может измениться во время работы приложения. В этом случае испускается сигнал audioOutputsChanged().
Примечание: Метод-получатель для свойства defaultAudioOutput.
[static] QCameraDevice QMediaDevices::defaultVideoInput()
Возвращает стандартную камеру в системе.
/note Возвращаемый объект должен быть проверен с помощью isNull() перед использованием, на случай, если нет камеры по умолчанию или вообще нет камер.
Устройство по умолчанию может измениться во время работы приложения. В этом случае испускается сигнал videoInputsChanged().
Примечание: Метод-получатель для свойства defaultVideoInput.
См. также videoInputs().
[static] QList<QCameraDevice> QMediaDevices::videoInputs()
Возвращает список доступных камер в системе.
Примечание: Метод-получатель для свойства videoInputs.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qmediadevices.html
