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