音频设备管理
功能介绍
本节介绍如何使用 SDK 管理本地音频设备,包括:
- 枚举系统中的麦克风、扬声器设备
- 监听设备插拔等变化
- 使用系统默认音频设备
- 在多设备中选择指定设备
- 调整设备的音量及静音
1. 设备枚举
通过接口可获得当前系统中所有可用的麦克风、扬声器列表,用于在 UI 中展示给用户选择。
- 调用示例:
// 获取麦克风、扬声器设备列表
const micDevs = sdk_engine.getAudioMics();
const spkDevs = sdk_engine.getAudioSpks();
// 遍历设备列表
for (let i = 0; i < micDevs.length; i++) {
const info = micDevs[i];
// info.id:设备id,info.name:设备名称
}
for (let i = 0; i < spkDevs.length; i++) {
const info = spkDevs[i];
// 在 UI 中展示 info.name,内部保存 info.id 以便后续选择
}
相关结构体与 API 请参考:
2. 设备变化通知
当用户插入/拔出音频设备,或在操作系统中启用/禁用设备时,SDK 会通过回调通知应用。
应用可在回调中重新枚举设备并刷新界面。
// 音频设备变化通知
sdk_engine.on("notifyAudioDevChanged", () => {
// 设备发生变化后,重新获取设备列表并更新 UI
const micDevs = sdk_engine.getAudioMics();
const spkDevs = sdk_engine.getAudioSpks();
// TODO: 刷新本地 UI 中的设备下拉框等控件
})
相关回调请参考:
3. 默认音频设备
SDK 支持沿用操作系统默认音频设备,也支持在多个设备中选择指定设备。
通过 setAudioCfg 可以控制是否使用系统默认设备。
- 设置为系统默认设备示例:
// 先获取当前音频配置
const cfg = sdk_engine.getAudioCfg();
// 置空设备 id,表示跟随系统默认设备
cfg.micID = ""; // 使用系统默认麦克风
cfg.spkID = ""; // 使用系统默认扬声器
sdk_engine.setAudioCfg(cfg);
相关结构体与 API 请参考:
4. 设备选择
在枚举出可用设备后,可根据业务逻辑或用户选择,将某个设备设置为当前使用设备。
- 从枚举结果中选择设备并应用示例:
// 已通过 UI 让用户选择了一个麦克风、扬声器设备
const selMicID = "..."; // 来自设备id
const selSpkID = "..."; // 来自设备id
// 获取当前音频配置
const cfg = sdk_engine.getAudioCfg();
// 设置为用户选中的设备
cfg.micID = selMicID;
cfg.spkID = selSpkID;
// 应用配置
sdk_engine.setAudioCfg(cfg);
在设备被拔出/禁用时,建议在 notifyAudioDevChanged 回调中重新枚举设备并自动恢复到可用设备,或提示用户重新选择。
相关结构体与 API 请参考:
5. 设备音量与静音
可调节麦克风和扬声器的音量以及扬声器静音。
- 设置/获取音量示例:
// 设置麦克风音量(0~255)
sdk_engine.setMicVolume(200);
const micVol = sdk_engine.getMicVolume();
// 设置扬声器音量(0~255)
sdk_engine.setSpkVolume(180);
const spkVol = sdk_engine.getSpkVolume();
- 扬声器静音示例:
// 静音扬声器:本端不再播放房间内声音
sdk_engine.setSpeakerMute(true);
// 取消静音
sdk_engine.setSpeakerMute(false);
const isMute = sdk_engine.getSpeakerMute();
相关 API 请参考: