音频设备管理
功能介绍
本节介绍如何使用 SDK 管理本地音频设备,包括:
- 枚举系统中的麦克风、扬声器设备
- 监听设备插拔等变化
- 使用系统默认音频设备
- 在多设备中选择指定设备
- 调整设备音量
注意:成功进入房间后,才可以设置音频设备。
1. 设备枚举
- 调用接口:
// 获取麦克风、扬声器设备列表
AudioDevInfoList micDevs = g_sdkMain.getSDKMeeting().getAudioMics();
AudioDevInfoList spkDevs = g_sdkMain.getSDKMeeting().getAudioSpks();
// 遍历设备列表
foreach (var mic in micDevs)
{
// mic._name:设备名称,mic._id:设备 id
}
foreach (var spk in spkDevs)
{
// 在 UI 中展示 spk._name,保存 spk._id 供后续选择
}
相关 API 请参考:
2. 设备变化通知
当用户插入/拔出音频设备时,SDK 会通过回调通知应用,可在回调中重新枚举设备并刷新界面。
private void notifyAudioDevChanged()
{
// 重新获取设备列表并更新 UI
AudioDevInfoList micDevs = g_sdkMain.getSDKMeeting().getAudioMics();
AudioDevInfoList spkDevs = g_sdkMain.getSDKMeeting().getAudioSpks();
}
相关 API 请参考:
3. 默认音频设备
通过 sdkAudioCfg 中的 _micGuid、_spkGuid 控制是否使用系统默认设备:
- 空字符串:使用系统默认麦克风/扬声器
- 具体设备 id:使用指定设备
sdkAudioCfg cfg = g_sdkMain.getSDKMeeting().getAudioCfg();
cfg._micGuid = ""; // 系统默认麦克风
cfg._spkGuid = ""; // 系统默认扬声器
g_sdkMain.getSDKMeeting().setAudioCfg(cfg);
相关 API 请参考:
4. 设备选择
sdkAudioCfg cfg = g_sdkMain.getSDKMeeting().getAudioCfg();
cfg._micGuid = selMicId; // 用户选中的麦克风 id
cfg._spkGuid = selSpkId; // 用户选中的扬声器 id
g_sdkMain.getSDKMeeting().setAudioCfg(cfg);
5. 设备音量控制
// 设置麦克风系统音量(0~255)
g_sdkMain.getSDKMeeting().setMicVolume(200);
int micVol = g_sdkMain.getSDKMeeting().getMicVolume();
// 设置扬声器系统音量(0~255)
g_sdkMain.getSDKMeeting().setSpkVolume(180);
int spkVol = g_sdkMain.getSDKMeeting().getSpkVolume();
相关 API 请参考: