跳到主要内容

音频设备

列出或读取音频设备,设置默认设备,以及静音、音量。只要播一段提示音,用 播放声音

当前模块定义

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 形如 {0.0.0.00000000}.{2c3a51b4-780e-4290-bc03-8c25dfed52d1},可从「获取设备列表」等操作得到。

音频设备

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

参数说明

操作类型:获取输出/输入设备列表、获取默认输出/输入设备信息、获取指定设备的信息、设置默认设备、设置静音、设置音量。

失败后停止动作:失败是否中止动作。默认开启。

获取设备列表

音频设备

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

返回所有状态的设备:关闭时只返回就绪(Active)设备。默认关闭。

输出:

  • 设备信息列表:每项 [图标]名称(注释)|设备ID,可直接当作 用户选择 的选项。
  • 原始对象列表:内部 MMDevice 对象列表。

获取默认设备 / 指定设备

音频设备

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

设备ID:获取指定设备、设置默认设备、静音、音量时需要。

输出(默认设备或指定设备):设备ID设备名称设备状态是否静音是否正在播放设置音量实时音量原始对象

设置默认设备

音频设备

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

把指定设备设为默认输出或输入。

设置静音

音频设备

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

静音状态:静音、取消静音、切换静音状态。设备ID 为空时操作当前默认输出设备。

设置音量

音频设备

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

音量01.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 随系统变化,不要写死后换电脑仍用旧值。列表为空时先打开 返回所有状态的设备,确认设备是否处于未就绪。

相关链接

更新于