PySide6.QtMultimedia.QMediaDevices¶

class QMediaDevices¶

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

在版本6.1中添加。

概要¶

属性¶

• audioInputsᅟ

• audioOutputsᅟ

• defaultAudioInputᅟ

• defaultAudioOutputᅟ

• defaultVideoInputᅟ

• videoInputsᅟ

方法¶

• def __init__()

信号¶

• def audioInputsChanged()

• def audioOutputsChanged()

• def videoInputsChanged()

静态函数¶

• def audioInputs()

• def audioOutputs()

• def defaultAudioInput()

• def defaultAudioOutput()

• def defaultVideoInput()

• def 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 是一个单例对象，所有的获取方法都是线程安全的。

注意

当使用from __feature__ import true_property时，属性可以直接使用，否则通过访问器函数使用。

property audioInputsᅟ: list of QAudioDevice¶

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

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

Access functions:

• audioInputs()

• 信号 audioInputsChanged()

property audioOutputsᅟ: list of QAudioDevice¶

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

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

Access functions:

• audioOutputs()

• 信号 audioOutputsChanged()

property defaultAudioInputᅟ: QAudioDevice¶

返回默认的音频输入设备。

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

Access functions:

• defaultAudioInput()

• 信号 audioInputsChanged()

property defaultAudioOutputᅟ: QAudioDevice¶

返回默认的音频输出设备。

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

Access functions:

• defaultAudioOutput()

• 信号 audioOutputsChanged()

property defaultVideoInputᅟ: QCameraDevice¶

返回系统上的默认相机。

注意

在使用返回的对象之前，应使用isNull()进行检查，以防没有默认摄像头或根本没有摄像头。

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

另请参阅

videoInputs()

Access functions:

• defaultVideoInput()

• 信号 videoInputsChanged()

property videoInputsᅟ: list of QCameraDevice¶

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

Access functions:

• videoInputs()

• 信号 videoInputsChanged()

__init__([parent=None])¶

Parameters:

父对象 – QObject

static audioInputs()¶

Return type:

QAudioDevice的列表

属性 audioInputsᅟ 的获取器。

audioInputsChanged()¶

属性 audioInputsᅟ 的通知信号。

static audioOutputs()¶

Return type:

QAudioDevice的列表

属性 audioOutputsᅟ 的获取器。

audioOutputsChanged()¶

属性 audioOutputsᅟ 的通知信号。

static defaultAudioInput()¶

Return type:

QAudioDevice

属性 defaultAudioInputᅟ 的获取器。

static defaultAudioOutput()¶

Return type:

QAudioDevice

属性 defaultAudioOutputᅟ 的获取器。

static defaultVideoInput()¶

Return type:

QCameraDevice

属性 defaultVideoInputᅟ 的获取器。

static videoInputs()¶

Return type:

QCameraDevice的列表

属性 videoInputsᅟ 的获取器。

videoInputsChanged()¶

属性 videoInputsᅟ 的通知信号。