音频设备管理
功能介绍
本节介绍如何使用 SDK 管理本地音频设备,包括:
- 枚举系统中的麦克风、扬声器设备
- 监听设备插拔等变化
- 使用系统默认音频设备
- 在多设备中选择指定设备
- 调整设备的系统音量及软件音量
1. 设备枚举
通过接口可获得当前系统中所有可用的麦克风、扬声器列表,用于在 UI 中展示给用户选择。
- 调用示例:
const rtcsdk = new RTCSDK();
// 获取麦克风、扬声器设备列表
const micDevs = rtcsdk.getAudioMics();
const spkDevs = rtcsdk.getAudioSpks();
// 遍历设备列表并打印设备名称和 id
micDevs.forEach((info) => {
console.log(info.name, info.id);
});
spkDevs.forEach((info) => {
console.log(info.name, info.id);
});
相关结构体与 API 请参考:
2. 设备变化通知
当用户插入/拔出音频设备,或在操作系统中启用/禁用设备时,SDK 会通过回调通知应用。应用可在回调中重新枚举设备并刷新界面。
rtcsdk.on('notifyAudioDevChanged', () => {
// 设备发生变化后,重新获取设备列表并更新 UI
const micDevs = rtcsdk.getAudioMics();
const spkDevs = rtcsdk.getAudioSpks();
// 刷新本地 UI 中的设备下拉框等控件
});
相关回调请参考:
3. 设备选择
SDK 支持沿用操作系统默认音频设备,也支持在多个设备中选择指定设备。通过 AudioCfg 中的 micID、spkID 字段可以控制是否使用系统默认设备。
设置为系统默认设备示例:
const rtcsdk = new RTCSDK();
const cfg = rtcsdk.getAudioCfg();
cfg.micID = ""; // 使用系统默认麦克风
cfg.spkID = ""; // 使用系统默认扬声器
rtcsdk.setAudioCfg(cfg);
在枚举出可用设备后,可根据业务逻辑或用户选择,将某个设备设置为当前使用设备:
const rtcsdk = new RTCSDK();
const cfg = rtcsdk.getAudioCfg();
// 已通过 UI 让用户选择了一个麦克风、扬声器设备
cfg.micID = "selected_mic_id";
cfg.spkID = "selected_spk_id";
rtcsdk.setAudioCfg(cfg);
相关 API 请参考:
4. 设备音量控制
系统音量
直接调用操作系统接口修改当前设备的系统音量。
const rtcsdk = new RTCSDK();
// 设置麦克风系统音量(0~255)
rtcsdk.setMicVolume(200);
const micVol = rtcsdk.getMicVolume();
// 设置扬声器系统音量(0~255)
rtcsdk.setSpkVolume(180);
const spkVol = rtcsdk.getSpkVolume();
相关 API 请参考: