# SoundSetMute

更改声音设备的静音设置.

    SoundSetMute NewSetting , Component, Device

## 参数

NewSetting

  类型: 数字或字符串

  任何正数都将打开设置(静音), 0 将关闭设置(不静音). 但是, 如果数字以加号或减号开头, 则设置将被切换(设置为与当前状态相反的状态).

Component

  类型: 字符串或整数

  组件的显示名称和/或索引. 例如, `1`, `"Line in"` 或 `"Line in:2"`.

  如果省略或为空, 则更改主静音设置.

  有关详情, 请参阅 Component (Sound 函数).

Device

  类型: 字符串或整数

  设备的显示名称和/或索引. 例如, `1`, `"Speakers"`, `"Speakers:2"` 或 `"Speakers (Example HD Audio)"`.

  如果省略该参数, 则它默认为系统的默认回放设备(不一定是设备 1).

  有关详情, 请参阅 Device (Sound 函数).

## 错误处理

失败时可能会抛出以下异常之一:

Error 类 | 消息
--- | ---
TargetError | Device not found(无法找到设备)
Component not found(无法找到组件)
Component doesn't support this control type(组件不支持此控件类型)
OSError | System-generated.(由系统生成)

## 备注

切换默认回放设备的主静音设置的另一种方法是让脚本发送一个击键, 如下例所示:

    Send "{Volume_Mute}"  ; 静音/不静音主音量.

要发现系统上安装的声音设备的功能 -- 比如名称和可用的组件 -- 请运行这个声卡分析脚本.

使用 SoundGetMute 来获取当前静音设置.

## 相关

Sound 函数

## 示例

设置主音量静音(开启静音).

    SoundSetMute true

切换主静音(设置到相反的状态).

    SoundSetMute -1

静音 Line In.

    SoundSetMute 1, "Line In"

静音麦克风录音.

    SoundSetMute 1, , "Microphone"

dftg