音频设备
获取音频设备信息,设置默认音频设备。
当前模块定义
sys:audioControl输入 7 · 输出 11 · 枚举 2
输入参数
- 操作类型
operationEnum必填8 个选项获取输出设备列表、获取默认输出设备信息、获取输入设备列表
获取输出设备列表默认GetOutputDeviceList获取默认输出设备信息GetOutputDefaultDevice获取输入设备列表GetInputDeviceList获取默认输入设备信息GetInputDefaultDevice获取指定设备的信息GetDeviceById设置默认设备SetDefaultDeviceById设置静音SetDeviceMute设置音量SetDeviceVolume - 设备ID
idText必填要获取或更新信息的设备ID。
- 静音状态
muteText必填可选值 true/false/toggle 静音、取消静音或切换状态。
静音默认true取消静音false切换静音状态toggle - 音量
volumeNumber必填0-1.0之间的小数数字。
- 返回所有状态的设备
returnAllBoolean可选否则只返回就绪状态 (Active) 的设备
- 蓝牙设备名称
deviceNameText可选 - 失败后停止动作
stopIfFailBoolean可选失败后是否停止动作
输出参数
- 是否成功
isSuccessBoolean操作是否成功
- 设备信息列表
deviceListList每项的格式为:[图标]名称(注释)|设备ID
- 设备ID
deviceIdText - 设备名称
deviceNameText - 设备状态
deviceStateText - 是否静音
muteBoolean - 是否正在播放
isPlayingBoolean - 设置音量
volumeNumber - 实时音量
masterPeakValueNumber - 原始对象
deviceObjectObject原始MMDevice对象
- 原始对象列表
deviceObjectListObject原始MMDevice对象的列表(IList<MMDevice>)
用于获取音频设备信息或设置默认设备、调整静音、音量。
音频设备
获取音频设备信息,设置默认音频设备。
支持的操作类型
获取设备列表
【获取输出设备列表】
【获取输入设备列表】
音频设备
获取音频设备信息,设置默认音频设备。
输出:
【设备信息列表】
返回系统内当前可用的输入和输出设备的列表。
每项格式为: [图标]设备名|设备ID
可以直接将得到的列表作为“用户选择”模块的“选项”参数的值。
【原始对象列表】表示设备的内部c#对象列表。类型为(List<NAudio.CoreAudioApi.MMDevice>)
获取默认设备
【获取默认的输出设备信息】
【获取默认的输入设备信息】
音频设备
获取音频设备信息,设置默认音频设备。
获取系统里当前选择的默认输出和输入设备,并且得到设备ID、设备名称、是否静音、音量等信息。原始对象为C#的NAudio.CoreAudioApi.MMDevice类型。
获取指定设备的信息
音频设备
获取音频设备信息,设置默认音频设备。
根据提供的设备ID,获取其信息。
设备ID是一个类似于这样的文本: {0.0.0.00000000}.{2c3a51b4-780e-4290-bc03-8c25dfed52d1}
可以从“获取设备列表”等操作方式里得到。
设置默认设备
音频设备
获取音频设备信息,设置默认音频设备。
将指定的设备设置为默认的输出或输入设备。
设置设备静音
音频设备
获取音频设备信息,设置默认音频设备。
可选值:true(静音)、false(取消静音)、toggle(切换静音状态)。
当设备ID为空时,设置当前默认输出设备。
设置设备音量
音频设备
获取音频设备信息,设置默认音频设备。
设置指定设备的音量。当设备ID为空时,设置当前默认输出设备的音量。
音量值参数:0-1.0之间的小数。
示例动作
- 音频设备操作示例
- 将输出设置为指定的设备
- 在两个音频设备之间切换
- 选择音频设备(选择复制设备ID 或 传递设备ID参数可直接设置设备为默认输出设备)
更新历史
- 20250120 更新文档,以匹配实际功能。
更新于