音视频通话

音频设备管理

功能介绍

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