class QMediaDevices

QMediaDevices类提供有关可用多媒体输入和输出设备的信息。更多…

自版本6.1起引入。

概述

属性

• audioInputsᅟ

• audioOutputsᅟ

• defaultAudioInputᅟ

• defaultAudioOutputᅟ

• defaultVideoInputᅟ

• videoInputsᅟ

方法

• def __init__()

信号

• 定义 audioInputsChanged()

• 定义 audioOutputsChanged()

• 定义 videoInputsChanged()

静态函数

• 定义 audioInputs()

• 定义 audioOutputs()

• 定义 defaultAudioInput()

• 定义 defaultAudioOutput()

• 定义 defaultVideoInput()

• 定义 videoInputs()

注意

本文档可能包含从C++自动翻译成Python的代码片段。我们始终欢迎对片段翻译的贡献。如果您发现翻译问题，也可以通过在https:/bugreports.qt.io/projects/PYSIDE创建票证来告知我们

详细信息

警告

本节包含从C++自动翻译为Python的代码片段，可能存在错误。

QMediaDevices类提供了有关可用多媒体设备和系统默认值的信息。它监视以下三个组

• 音频输入设备（麦克风）

• 音频输出设备（扬声器、耳机）

• 视频输入设备（摄像头）

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

您可以使用audioInputs和audioOutputs函数来列出系统上所有的麦克风和扬声器/耳机。此示例首先获取所有连接麦克风的列表，然后打印它们的标识符、描述，以及它是否是默认设备。

audioDevices = QMediaDevices.audioInputs()
for device in audioDevices:

    print( out, "ID: ", device.id())
    print( out, "Description: ", device.description())
    print( out, "Is default: ", (device.isDefault() if "Yes" else "No"))

同样，videoInputs将返回所有连接摄像头的列表。在这个示例中，我们列出所有连接的摄像头以及它们的标识符、描述，以及它是否是默认摄像头。

videoDevices = QMediaDevices.videoInputs()
for device in videoDevices:

    print( out, "ID: ", device.id())
    print( out, "Description: ", device.description())
    print( out, "Is default: ", (device.isDefault() if "Yes" else "No"))

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

在播放或录制多媒体时，通常可以使用默认输入和输出设备，但通常需要显式选择要使用的设备。

QMediaDevices 是一个单例对象，所有获取器都是线程安全的。

注意

可以使用属性或访问器函数来直接使用属性。

property audioInputsᅟ: list of QAudioDevice

返回系统上可用的音频输入设备列表。

这些设备通常是麦克风。设备可以是内置的，也可以通过USB或蓝牙等连接。

访问函数

• audioInputs()

• 信号 audioInputsChanged()

property audioOutputsᅟ: list of QAudioDevice

返回系统上可用的音频输出设备列表。

这些设备通常是扬声器或耳机。设备可以是内置的，也可以通过USB或蓝牙等连接。

访问函数

• audioOutputs()

• 信号 audioOutputsChanged()

property defaultAudioInputᅟ: QAudioDevice

返回默认音频输入设备。

默认设备可以在应用程序运行时更改。在这种情况下，将发出 audioInputsChanged() 信号。

访问函数

• defaultAudioInput()

• 信号 audioInputsChanged()

property defaultAudioOutputᅟ: QAudioDevice

返回默认音频输出设备。

默认设备在应用程序运行期间可能会改变。在这种情况下，会发出 audioOutputsChanged() 信号。

访问函数

• defaultAudioOutput()

• 信号 audioOutputsChanged()

属性 defaultVideoInputᅟ: QCameraDevice

返回系统上的默认摄像头。

注意

在使用返回对象之前，应使用 isNull() 检查该对象，以防没有默认摄像头或没有任何摄像头。

默认设备在应用程序运行期间可能会改变。在这种情况下，会发出 videoInputsChanged() 信号。

参见

videoInputs()

访问函数

• defaultVideoInput()

• 信号 videoInputsChanged()

属性 videoInputsᅟ: QCameraDevice 的列表

返回系统上可用的摄像头列表。

访问函数

• videoInputs()

• 信号 videoInputsChanged()

__init__([parent=None])

参数：:

parent – QObject

静态 audioInputs()

返回类型：:

. QAudioDevice 的列表

属性 audioInputsᅟ 的获取器。

audioInputsChanged()

属性 audioInputsᅟ 的通知信号。

静态 audioOutputs()

返回类型：:

. QAudioDevice 的列表

属性 audioOutputsᅟ 的获取器。

audioOutputsChanged()

属性 audioOutputsᅟ 的通知信号。

静态 defaultAudioInput()

返回类型：:

QAudioDevice

属性 defaultAudioInputᅟ 的获取器。

静态 defaultAudioOutput()

返回类型：:

QAudioDevice

属性 defaultAudioOutputᅟ 的获取器。

静态 defaultVideoInput()

返回类型：:

QCameraDevice

属性 defaultVideoInputᅟ 的获取器。

静态 videoInputs()

返回类型：:

. QCameraDevice 列表

属性 videoInputsᅟ 的获取器。

videoInputsChanged()

属性 videoInputsᅟ 的通知信号。