音频设备管理
功能介绍
本节介绍如何使用 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 请参考: