音视频通话

音频设备管理

功能介绍

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

  • 枚举系统中的麦克风、扬声器设备
  • 监听设备插拔等变化
  • 使用系统默认音频设备
  • 在多设备中选择指定设备
  • 调整设备的系统音量及软件音量

1. 设备枚举

通过接口可获得当前系统中所有可用的麦克风、扬声器列表,用于在 UI 中展示给用户选择。

  • 调用示例:
CRVideoSDKMeeting& meeting = g_sdkMain->getSDKMeeting();

// 获取麦克风、扬声器设备列表
CRBase::CRArray<CRAudioDevInfo> micDevs = meeting.getAudioMics();
CRBase::CRArray<CRAudioDevInfo> spkDevs = meeting.getAudioSpks();

// 遍历设备列表并打印设备名称和 id
for (size_t i = 0; i < micDevs.size(); ++i)
{
    const CRAudioDevInfo& info = micDevs[i];
    // info._name:设备名称,info._id:设备id
}

for (size_t i = 0; i < spkDevs.size(); ++i)
{
    const CRAudioDevInfo& info = spkDevs[i];
    // 在 UI 中展示 info._name,内部保存 info._id 以便后续选择
}

相关结构体与 API 请参考:

2. 设备变化通知

当用户插入/拔出音频设备,或在操作系统中启用/禁用设备时,SDK 会通过回调通知应用。
应用可在回调中重新枚举设备并刷新界面。

  • 在 CRVideoSDKMeetingCallBack 的子类中重写回调:
// 自定义回调类,继承自 CRVideoSDKMeetingCallBack
class YourCallBack : public CRVideoSDKMeetingCallBack
{
public:
    // 音频设备变化通知
    virtual void notifyAudioDevChanged() override
    {
		CRVideoSDKMeeting& meeting = g_sdkMain->getSDKMeeting();

        // 设备发生变化后,重新获取设备列表并更新 UI
        CRBase::CRArray<CRAudioDevInfo> micDevs = meeting.getAudioMics();
        CRBase::CRArray<CRAudioDevInfo> spkDevs = meeting.getAudioSpks();

        // TODO: 刷新本地 UI 中的设备下拉框等控件
    }
};

相关回调请参考:

3. 默认音频设备

SDK 支持沿用操作系统默认音频设备,也支持在多个设备中选择指定设备。
通过 CRAudioCfg 中的 _micID、_spkID 字段可以控制是否使用系统默认设备。

  • _micID / _spkID 为空字符串:使用系统默认的麦克风 / 扬声器

  • _micID / _spkID 为具体设备 id:使用指定设备

  • 设置为系统默认设备示例:

// 先获取当前音频配置
CRVideoSDKMeeting& meeting = g_sdkMain->getSDKMeeting();
CRAudioCfg cfg = meeting.getAudioCfg();

// 置空设备 id,表示跟随系统默认设备
cfg._micID = "";   // 使用系统默认麦克风
cfg._spkID = "";   // 使用系统默认扬声器

meeting.setAudioCfg(cfg);

相关结构体与 API 请参考:

4. 设备选择

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

  • 从枚举结果中选择设备并应用示例:
CRVideoSDKMeeting& meeting = g_sdkMain->getSDKMeeting();

// 已通过 UI 让用户选择了一个麦克风、扬声器设备
std::string selMicID = "..."; // 来自 CRAudioDevInfo::_id
std::string selSpkID = "..."; // 来自 CRAudioDevInfo::_id

// 获取当前音频配置
CRAudioCfg cfg = meeting.getAudioCfg();

// 设置为用户选中的设备
cfg._micID = selMicID.c_str();
cfg._spkID = selSpkID.c_str();

// 应用配置
meeting.setAudioCfg(cfg);

在设备被拔出/禁用时,建议在 notifyAudioDevChanged 回调中重新枚举设备并自动恢复到可用设备,或提示用户重新选择。

相关结构体与 API 请参考:

5. 设备音量控制

SDK 提供两层音量控制能力:

  • 系统音量:直接调用操作系统接口修改当前设备的系统音量

  • 附加缩放系数(软件音量):在系统音量基础上再乘以一个缩放系数,不改变系统设置

  • 设置/获取系统音量示例:

CRVideoSDKMeeting& meeting = g_sdkMain->getSDKMeeting();

// 设置麦克风系统音量(0~255)
meeting.setMicVolume(200);
int micVol = meeting.getMicVolume();

// 设置扬声器系统音量(0~255)
meeting.setSpkVolume(180);
int spkVol = meeting.getSpkVolume();
  • 设置附加缩放系数示例(不改系统设置,仅在 SDK 内部缩放):
CRVideoSDKMeeting& meeting = g_sdkMain->getSDKMeeting();

// 将麦克风音量缩小为系统音量的 50%
meeting.setMicVolumeScaling(0.5f);

// 将扬声器音量放大到系统音量的 150%
meeting.setSpkVolumeScaling(1.5f);

相关 API 请参考: