跳到主要内容

音频设备

获取音频设备信息,设置默认音频设备。

当前模块定义

sys:audioControlWindows系统Action
标准模块
输入 7 · 输出 11 · 枚举 2

输入参数

  • 操作类型operationEnum必填
    填写 固定输入默认 GetOutputDeviceList
    8 个选项获取输出设备列表、获取默认输出设备信息、获取输入设备列表
    获取输出设备列表默认GetOutputDeviceList
    获取默认输出设备信息GetOutputDefaultDevice
    获取输入设备列表GetInputDeviceList
    获取默认输入设备信息GetInputDefaultDevice
    获取指定设备的信息GetDeviceById
    设置默认设备SetDefaultDeviceById
    设置静音SetDeviceMute
    设置音量SetDeviceVolume
  • 设备IDidText必填

    要获取或更新信息的设备ID。

    填写 输入或变量条件 仅:GetDeviceById, SetDefaultDeviceById, SetDeviceMute, SetDeviceVolume
  • 静音状态muteText必填

    可选值 true/false/toggle 静音、取消静音或切换状态。

    填写 输入或变量条件 仅:SetDeviceMute默认 true
    静音默认true
    取消静音false
    切换静音状态toggle
  • 音量volumeNumber必填

    0-1.0之间的小数数字。

    填写 输入或变量条件 仅:SetDeviceVolume默认 0.1
  • 返回所有状态的设备returnAllBoolean可选

    否则只返回就绪状态 (Active) 的设备

    填写 固定输入条件 仅:GetOutputDeviceList, GetInputDeviceList默认 false
  • 蓝牙设备名称deviceNameText可选
    填写 输入或变量条件 仅:ConnectBluetoothDevice
  • 失败后停止动作stopIfFailBoolean可选

    失败后是否停止动作

    填写 固定输入默认 true

输出参数

  • 是否成功isSuccessBoolean

    操作是否成功

  • 设备信息列表deviceListList

    每项的格式为:[图标]名称(注释)|设备ID

    条件 仅:GetOutputDeviceList, GetInputDeviceList
  • 设备IDdeviceIdText
    条件 仅:GetOutputDefaultDevice, GetInputDefaultDevice
  • 设备名称deviceNameText
    条件 仅:GetOutputDefaultDevice, GetInputDefaultDevice, GetDeviceById
  • 设备状态deviceStateText
    条件 仅:GetOutputDefaultDevice, GetInputDefaultDevice, GetDeviceById
  • 是否静音muteBoolean
    条件 仅:GetOutputDefaultDevice, GetInputDefaultDevice, GetDeviceById
  • 是否正在播放isPlayingBoolean
    条件 仅:GetOutputDefaultDevice, GetInputDefaultDevice, GetDeviceById
  • 设置音量volumeNumber
    条件 仅:GetOutputDefaultDevice, GetInputDefaultDevice, GetDeviceById
  • 实时音量masterPeakValueNumber
    条件 仅:GetOutputDefaultDevice, GetInputDefaultDevice, GetDeviceById
  • 原始对象deviceObjectObject

    原始MMDevice对象

    条件 仅:GetOutputDefaultDevice, GetInputDefaultDevice, GetDeviceById
  • 原始对象列表deviceObjectListObject

    原始MMDevice对象的列表(IList<MMDevice>)

    条件 仅:GetOutputDeviceList, GetInputDeviceList

用于获取音频设备信息或设置默认设备、调整静音、音量。

音频设备

获取音频设备信息,设置默认音频设备。
操作类型
是否成功
-- 选择变量 --
操作是否成功
设备信息列表
-- 选择变量 --
每项的格式为:[图标]名称(注释)|设备ID
原始对象列表
-- 选择变量 --
原始MMDevice对象的列表(IList<MMDevice>)
步骤注释
 

支持的操作类型

获取设备列表

【获取输出设备列表】

【获取输入设备列表】

音频设备

获取音频设备信息,设置默认音频设备。
操作类型

输出:

【设备信息列表】

返回系统内当前可用的输入和输出设备的列表。

每项格式为: [图标]设备名|设备ID 

可以直接将得到的列表作为“用户选择”模块的“选项”参数的值。

【原始对象列表】表示设备的内部c#对象列表。类型为(List<NAudio.CoreAudioApi.MMDevice>)

获取默认设备

【获取默认的输出设备信息】

【获取默认的输入设备信息】

音频设备

获取音频设备信息,设置默认音频设备。
操作类型

获取系统里当前选择的默认输出和输入设备,并且得到设备ID、设备名称、是否静音、音量等信息。原始对象为C#的NAudio.CoreAudioApi.MMDevice类型。

获取指定设备的信息

音频设备

获取音频设备信息,设置默认音频设备。
操作类型
设备ID
deviceId
要获取或更新信息的设备ID。

根据提供的设备ID,获取其信息。

设备ID是一个类似于这样的文本: {0.0.0.00000000}.{2c3a51b4-780e-4290-bc03-8c25dfed52d1} 

可以从“获取设备列表”等操作方式里得到。

设置默认设备

音频设备

获取音频设备信息,设置默认音频设备。
操作类型
设备ID
deviceId
要获取或更新信息的设备ID。

将指定的设备设置为默认的输出或输入设备。

设置设备静音

音频设备

获取音频设备信息,设置默认音频设备。
操作类型
设备ID
deviceId
要获取或更新信息的设备ID。
静音状态
可选值 true/false/toggle 静音、取消静音或切换状态。

可选值:true(静音)、false(取消静音)、toggle(切换静音状态)。

当设备ID为空时,设置当前默认输出设备。

设置设备音量

音频设备

获取音频设备信息,设置默认音频设备。
操作类型
设备ID
deviceId
要获取或更新信息的设备ID。
音量
0.1
0-1.0之间的小数数字。

设置指定设备的音量。当设备ID为空时,设置当前默认输出设备的音量。

音量值参数:0-1.0之间的小数。

示例动作

更新历史

  • 20250120 更新文档,以匹配实际功能。

更新于