音频设备
列出或读取音频设备,设置默认设备,以及静音、音量。只要播一段提示音,用 播放声音。
当前模块定义
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 形如 {0.0.0.00000000}.{2c3a51b4-780e-4290-bc03-8c25dfed52d1},可从「获取设备列表」等操作得到。
音频设备
获取音频设备信息,设置默认音频设备。
参数说明
操作类型:获取输出/输入设备列表、获取默认输出/输入设备信息、获取指定设备的信息、设置默认设备、设置静音、设置音量。
失败后停止动作:失败是否中止动作。默认开启。
获取设备列表
音频设备
获取音频设备信息,设置默认音频设备。
返回所有状态的设备:关闭时只返回就绪(Active)设备。默认关闭。
输出:
- 设备信息列表:每项
[图标]名称(注释)|设备ID,可直接当作 用户选择 的选项。 - 原始对象列表:内部
MMDevice对象列表。
获取默认设备 / 指定设备
音频设备
获取音频设备信息,设置默认音频设备。
设备ID:获取指定设备、设置默认设备、静音、音量时需要。
输出(默认设备或指定设备):设备ID、设备名称、设备状态、是否静音、是否正在播放、设置音量、实时音量、原始对象。
设置默认设备
音频设备
获取音频设备信息,设置默认音频设备。
把指定设备设为默认输出或输入。
设置静音
音频设备
获取音频设备信息,设置默认音频设备。
静音状态:静音、取消静音、切换静音状态。设备ID 为空时操作当前默认输出设备。
设置音量
音频设备
获取音频设备信息,设置默认音频设备。
音量:0–1.0 的小数。设备ID 为空时操作当前默认输出设备。
输出
- 是否成功
- 其余输出随操作类型变化,见上。
示例
25 步的综合演示只保留安装卡片;下面三个不超过 8 步,可直接看步骤定义。
输出到固定设备
如果/否则判断条件:$= String.IsNullOrEmpty({deviceId}) || {quicker_in_param} == "select"
音频设备获取输出设备列表
用户选择{deviceId}
否则
音频设备设置默认设备{deviceId}
音频设备获取默认输出设备信息
提示消息$$音频输出已设置为:{deviceName}
切换音频设备
注释初始化和设置
如果判断条件:$= String.IsNullOrEmpty({deviceId1}) || {quicker_in_param} == "select"
音频设备获取输出设备列表
多字段表单
注释根据当前设备,确定下一个设备
音频设备获取默认输出设备信息
如果/否则当前输出不是设备1,则设置为设备1,否则设置为设备2
音频设备设置默认设备{deviceId1}
否则
音频设备设置默认设备{deviceId2}
注释得到设置后的
音频设备获取默认输出设备信息
提示消息$${deviceName}
选择音频设备
如果/否则判断条件:$= String.IsNullOrEmpty({quicker_in_param})
注释如果没有传递参数,则选择活动设备并复制设备ID到剪贴板
音频设备获取输出设备列表
用户选择{deviceId}
写入剪贴板自动(纯文本或图片) => 剪贴板
音频设备设置默认设备{deviceId}
否则
音频设备设置默认设备{quicker_in_param}
音频设备获取默认输出设备信息
提示消息$${deviceName}
限制与排障
设备 ID 随系统变化,不要写死后换电脑仍用旧值。列表为空时先打开 返回所有状态的设备,确认设备是否处于未就绪。
相关链接
更新于