音视频通话

音频设备管理

功能介绍

本节介绍如何使用 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 请参考: