SoundSwitch 录音设备配置指南：Recording 标签页的设备轮换与麦克风静音热键

本篇指南聚焦 SoundSwitch 设置窗口中的 Recording（录音）标签页，讲解如何挑选麦克风、线路输入等音频输入设备加入轮换队列，以及如何配置"切换录音设备"与"一键静音麦克风"两套独立热键。读完本文，你将掌握录音设备选择、热键绑定与启用开关的完整配置方法，并能理解其背后的 Windows 音频端点（Audio Endpoint）枚举与 COM 音量控制实现原理。

什么是 Recording 标签页

在 SoundSwitch 的设置界面中，Recording 标签页专门管理系统的音频输入设备（EDataFlow.eCapture），包括麦克风、线路输入（Line-in）、立体声混音等。与之相对的是负责音箱/耳机的 Playback（播放） 标签页。从源码实现看，设置表单正是通过 _audioDeviceLister.GetDevices(EDataFlow.eCapture, EDeviceState.Active | EDeviceState.Unplugged) 来加载录音设备列表（见 SoundSwitch/UI/Forms/Settings.cs），只展示"已激活（Active）"与"已拔出（Unplugged）"两类设备，已禁用设备默认不参与热键轮换。

选择要轮换的录音设备

标签页主区域列出 Windows 检测到的全部录音设备，并按连接状态自动分组：

• Connected（已连接）——当前处于活动状态、可立即使用的设备；
• Disconnected（已断开）——当前已拔出或未启用的设备（如未插线的麦克风接口）。

勾选需要加入轮换的设备后，它们会出现在 Selected（已选） 组中。SoundSwitch 只会在已勾选的设备之间进行热键切换，未勾选的设备不会被轮换逻辑触达。

分组列表使用了支持折叠的 ListView 分组（ListViewGroupState.Collapsible，见 Settings.cs），设备按 Selected（已选）与连接状态分组展示，并可通过 SettingsStrings 本地化资源对组头进行多语言翻译。

热键设置

标签页底部提供两套相互独立的热键控件，每套都配有各自的启用复选框：

热键	默认值	作用
Switch device（切换设备）	Ctrl + Alt + F7	在已勾选的录音设备之间循环切换
Toggle mute（切换静音）	Ctrl + Alt + M	立即静音/取消静音默认通信麦克风
Hotkey enabled（启用热键）	各自独立勾选	勾选启用快捷键，取消勾选则禁用

设置方法很简单：点击对应的输入框，按下想要的组合键即可。SoundSwitch 会立即注册该快捷键并生效，无需重启应用。

切换设备热键

用于在已勾选的录音设备间轮换的快捷键，其默认值与持久化配置定义在 SoundSwitchConfiguration.cs：

public HotKey RecordingHotKey { get; set; } = new(Keys.F7, HotKey.ModifierKeys.Alt | HotKey.ModifierKeys.Control);

即默认组合 Ctrl + Alt + F7（F7 + Alt + Control 修饰键）。该配置通过 ISoundSwitchConfiguration.cs 暴露为 RecordingHotKey 属性，并在设置表单中与 HotKeyAction.Recording 绑定（见 Settings.cs 与 HotKeyAction.cs 中的 Playback / Recording / Mute 三种动作枚举）。

切换静音热键

Ctrl + Alt + M 用于一键静音/取消静音默认通信麦克风（Windows 通信角色，ERole.eCommunications）。这里需要特别强调：它只作用于默认通信设备，不会影响系统里其他录音设备，更不会遍历所有麦克风。

源码级实现位于 MicrophoneMuteToggler.cs：热键触发后，ToggleDefaultMute() 首先通过 _switcher.GetDefaultAudioDevice(EDataFlow.eCapture, ERole.eCommunications) 获取默认通信麦克风，随后调用 _switcher.InteractWithDevice 读取 device.EndpointVolume.Mute 并写入相反状态：

var newMuteState = !device.EndpointVolume.Mute;
device.EndpointVolume.Mute = newMuteState;

静音状态的实际读写由 IAudioEndpointVolume COM 接口完成；若设备激活失败（EndpointVolume == null）或找不到默认麦克风，方法会记录日志并返回 null，静音操作不会产生副作用。该热键默认值同样定义在 SoundSwitchConfiguration.cs：

public HotKey MuteRecordingHotKey { get; set; } = new(Keys.M, ModifierKeys.Control | ModifierKeys.Alt);

在设置表单中，muteHotKey 控件直接绑定 AppConfigs.Configuration.MuteRecordingHotKey，其启用状态与 muteHotKeyCheckBox 双向同步（见 Settings.cs）。

热键启用的独立控制

Switch device 与 Toggle mute 各自拥有独立的 Hotkey enabled 复选框：

• 勾选：激活对应快捷键，系统级全局热键注册立即生效；
• 取消勾选：停用该快捷键，但不影响另一组热键和已保存的设备勾选状态。

这一设计让用户可以只保留"切换设备"热键而关闭"静音"热键，避免与第三方软件的热键冲突。两组热键的配置分别持久化在 RecordingHotKey 与 MuteRecordingHotKey 两个独立属性中，互不干扰。

底层原理与相关能力

录音设备枚举

录音设备列表来自 Windows 音频设备枚举（WASAPI 的 IMMDeviceEnumerator），SoundSwitch 的 Audio Manager 层封装了 EDataFlow.eCapture 与 EDeviceState.Active | EDeviceState.Unplugged 的组合查询，从而区分"已连接"与"已断开"两组设备。该枚举实现在 SoundSwitch.Audio.Manager 项目中，是本标签页数据来源的基础。

静音能力的多入口

MicrophoneMuteToggler 除了响应热键外，还提供按设备 ID 精确设置静音状态的方法 SetMicrophoneMuteState(string deviceId, bool muteState)（见 MicrophoneMuteToggler.cs），用于 IPC 管道等场景。例如 SoundSwitchApplicationContext.cs 中处理 MuteRequest 消息时，会调用 AppModel.Instance.SetMicrophoneMuteState 并返回设备的静音状态与名称，供命令行工具（SoundSwitch.CLI 的 mute 命令）或快速菜单使用。这意味着你在 Recording 标签页配置的静音能力，与 CLI、托盘菜单共享同一套底层实现。

小结

Recording 标签页围绕两件事展开：勾选哪些录音设备参与轮换，以及如何用两套独立热键控制切换与静音。默认热键 Ctrl + Alt + F7 负责设备切换，Ctrl + Alt + M 负责默认通信麦克风的静音切换，两者均可独立启用/禁用，配置即时生效并持久化保存。结合 SoundSwitchConfiguration.cs 的默认值定义与 MicrophoneMuteToggler.cs 的实现，你可以清楚知道这些设置在系统中的真实行为边界。