音视频通话

音频设备管理

功能介绍

本节介绍如何使用 SDK 管理本地音频采集与播放设备,包括:

  • 枚举系统中的麦克风、扬声器设备
  • 监听设备列表变化
  • 在多设备中选择指定设备
注意:

须在成功进入房间后,方可调用本节音频设备相关接口(含设备枚举、选择与 CRVideo_SetAudioCfg 配置);入会前调用枚举接口可能返回空列表。

1. 设备枚举

通过接口可获得当前浏览器可用的麦克风、扬声器列表,用于在 UI 中展示供用户选择。

  • 调用示例:
// 获取麦克风、扬声器设备列表
var micDevs = CRVideo_GetAudioMicNames();
var spkDevs = CRVideo_GetAudioSpkNames();

// 遍历并展示设备名称,保存 micID / speakerID 供后续选择
for (var i = 0; i < micDevs.length; i++) {
    var info = micDevs[i];
    // info.micName:设备名称,info.micID:设备 ID
}

for (var j = 0; j < spkDevs.length; j++) {
    var spk = spkDevs[j];
    // spk.speakerName:设备名称,spk.speakerID:设备 ID
}

相关类型与 API 请参考:

2. 设备变化通知

当用户插入/拔出音频设备,或在浏览器中切换默认设备导致枚举列表变化时,SDK 会通过回调通知应用。应用可在回调中重新枚举设备并刷新界面。

  • 注册回调示例:
CRVideo_MicDeviceChanged.callback = function(UID){
    // 设备列表变化后,重新获取麦克风列表并更新 UI
    var micDevs = CRVideo_GetAudioMicNames();
    // TODO: 刷新本地 UI 中的设备下拉框等控件
}

CRVideo_SpkDeviceChanged.callback = function(UID){
    var spkDevs = CRVideo_GetAudioSpkNames();
    // TODO: 刷新扬声器设备列表
}

相关回调请参考:

3. 默认音频设备

浏览器会为当前环境选定默认的麦克风与扬声器,枚举接口返回的列表中通常包含这些设备。若业务侧不指定 micID / speakerID,SDK 将按当前 CRVideo_AudioCfg 与浏览器默认策略使用设备。

  • 获取当前音频配置:
var cfg = CRVideo_GetAudioCfg();
// cfg.micID、cfg.speakerID 为当前使用的设备 ID
  • 若需显式使用枚举结果中的默认项,可从列表中选取(例如列表首项,以实际枚举顺序为准):
var micDevs = CRVideo_GetAudioMicNames();
var spkDevs = CRVideo_GetAudioSpkNames();
if (micDevs.length > 0 && spkDevs.length > 0) {
    var cfg = CRVideo_GetAudioCfg();
    cfg.micID = micDevs[0].micID;
    cfg.speakerID = spkDevs[0].speakerID;
    CRVideo_SetAudioCfg(cfg);
}

相关类型与 API 请参考:

4. 设备选择

在枚举出可用设备后,可根据业务逻辑或用户选择,将某个设备设置为当前使用设备。

  • 从枚举结果中选择并应用示例:
// 用户已在 UI 中选择了麦克风、扬声器
var selMicID = micDevs[0].micID;   // 来自 CRVideo_MicInfoObj
var selSpkID = spkDevs[0].speakerID; // 来自 CRVideo_SpeakerInfoObj

var cfg = CRVideo_GetAudioCfg();
cfg.micID = selMicID;
cfg.speakerID = selSpkID;
CRVideo_SetAudioCfg(cfg);

设备被拔出或不可用时,建议在 CRVideo_MicDeviceChanged / CRVideo_SpkDeviceChanged 回调中重新枚举,并自动切换到仍可用设备,或提示用户重新选择。打开麦克风失败时可参考 CRVideo_OpenMicFailed 处理授权、占用等问题。

相关类型与 API 请参考: