QMediaDevices Class

详细说明

QMediaDevices 类提供有关可用多媒体设备及系统默认设置的信息。它监视以下三类设备：

• 音频输入设备（麦克风）
• 音频输出设备（扬声器、耳机）
• 视频输入设备（摄像头）

QMediaDevices 为每个设备组提供独立的列表。如果检测到有新设备连接到系统，或者已连接的设备已从系统断开，它将更新相应的设备列表，并发出信号以通知该变化。

可使用QMediaDevices::audioInputs 和QMediaDevices::audioOutputs 函数枚举系统上的所有麦克风和扬声器/耳机。本示例首先获取所有已连接麦克风的列表，然后打印其标识符、描述以及是否为默认设备。

const QList<QAudioDevice> audioDevices = QMediaDevices::audioInputs();
for (const QAudioDevice &device : audioDevices)
{
    out << "ID: " << device.id() << Qt::endl;
    out << "Description: " << device.description() << Qt::endl;
    out << "Is default: " << (device.isDefault() ? "Yes" : "No") << Qt::endl;
}

同样地，QMediaDevices::videoInputs 将返回所有已连接摄像头的列表。在此示例中，我们将列出所有已连接的摄像头及其标识符、描述，以及是否为默认摄像头。

const QList<QCameraDevice> videoDevices = QMediaDevices::videoInputs();
for (const QCameraDevice &device : videoDevices)
{
    out << "ID: " << device.id() << Qt::endl;
    out << "Description: " << device.description() << Qt::endl;
    out << "Is default: " << (device.isDefault() ? "Yes" : "No") << Qt::endl;
}

QMediaDevices 会监控每个设备组的系统默认设置，并会在系统设置发生任何变更时发出通知。 例如，如果用户在系统设置中选择了新的默认音频输出设备，QMediaDevices 将相应地更新默认音频输出并发出信号。如果系统未为摄像头或音频输入提供默认设备，QMediaDevices 将从列表中选择第一个设备作为默认设备。

虽然使用默认的输入和输出设备通常足以满足多媒体的播放或录制需求，但往往需要显式地选择要使用的设备。

QMediaDevices 的静态方法是线程安全的，并引用底层的单例对象。