收听房间内的声音
功能介绍
本节介绍如何在房间内收听其他参会者的声音,包括:
- 默认收听行为:入会后通过扬声器听到房间内所有开麦人的混音
- 扬声器设备选择与播放音量、静音控制
- 可选:设置音频订阅模式,只收听指定人员的语音(白名单/黑名单)
- 可选:通过自定义音频渲染从 SDK 拉取 PCM 数据自行播放(参见 自定义音频采集/渲染)
1. 默认收听行为
成功进入房间后,SDK 默认使用 混音模式(CRVSDK_ASM_MIXED):房间内所有开麦人的声音会混成一路语音流,由本端扬声器播放。无需额外调用即可听到他人说话。
2. 扬声器音量与静音
在保持默认混音播放的前提下,可调节本端“播放音量”和“是否静音”,仅影响本端听到的声音,不影响房间内其他人。
-
系统音量:直接设置当前扬声器设备的系统音量(0~255)。
-
软件音量:在系统音量基础上再乘以缩放系数,不修改系统设置,适合做“会议音量”独立于系统音量的场景。
-
扬声器静音:关闭本端扬声器输出,即本端不再播放房间内任何人的声音(仅本地生效)。
-
设置/获取扬声器音量示例:
CRVideoSDKMeeting& meeting = g_sdkMain->getSDKMeeting();
// 设置扬声器系统音量(0~255)
meeting.setSpkVolume(180);
int spkVol = meeting.getSpkVolume();
// 设置扬声器音量缩放系数(不改变系统设置)
meeting.setSpkVolumeScaling(1.0f); // 1.0 表示不缩放
float scaling = meeting.getSpkVolumeScaling();
- 扬声器静音示例:
CRVideoSDKMeeting& meeting = g_sdkMain->getSDKMeeting();
// 静音扬声器:本端不再播放房间内声音
meeting.setSpeakerMute(true);
// 取消静音
meeting.setSpeakerMute(false);
bool isMute = meeting.getSpeakerMute();
相关 API 请参考:
扬声器设备选择与设备音量说明见 设备管理 - 默认音频设备与设备选择、设备音量控制。
3. 音频订阅模式(可选)
默认混音模式下会收听房间内所有开麦人的声音。若需要 只收听指定人员 或 排除指定人员 的语音,可切换为独立流模式并设置订阅名单。
- 混音模式 CRVSDK_ASM_MIXED(默认):一个混音流,带宽与 CPU 占用较小,无法按人控制订阅。
- 独立流模式 CRVSDK_ASM_SEPARATE:每人一路流,可设置白名单或黑名单,仅收听名单内或名单外的人。
切换为独立流模式后,默认不订阅任何人,必须调用 setAudioSubscribeListForSeparateMode 设置要收听的对象(白名单)或要排除的对象(黑名单)。
- 设置订阅模式与名单示例:
CRVideoSDKMeeting& meeting = g_sdkMain->getSDKMeeting();
// 切换为独立流模式
meeting.setAudioSubscribeMode(CRVSDK_ASM_SEPARATE);
// 白名单:只收听 user1、user2 的声音(userIds 以 ";" 分隔)
const char* whiteList = "user1;user2";
meeting.setAudioSubscribeListForSeparateMode(CRVSDK_ASLT_INCLUDE, whiteList);
// 黑名单:收听除 user1 外所有人的声音
const char* blackList = "user1";
meeting.setAudioSubscribeListForSeparateMode(CRVSDK_ASLT_EXCLUDE, blackList);
- 恢复默认(收听所有人):
CRVideoSDKMeeting& meeting = g_sdkMain->getSDKMeeting();
meeting.setAudioSubscribeMode(CRVSDK_ASM_MIXED);
此接口在进入房间前后均可调用,程序退出后失效。白名单与黑名单不共存,后一次设置会覆盖前一次。
相关 API 与常量请参考:
- setAudioSubscribeMode
- setAudioSubscribeListForSeparateMode
- CRVSDK_ASUBSCRIB_MODE
- CRVSDK_ASUBSCRIB_LISTTYPE
4. 自定义音频渲染(可选)
若不需要由 SDK 向系统扬声器播放,而是自行处理 PCM 数据(例如送给第三方设备或算法),可开启自定义音频渲染,通过 pullCustomAudioDat 从 SDK 拉取房间内已订阅的混音数据并自行播放。开启后 SDK 内部不再向系统扬声器输出。
具体步骤与格式要求见 自定义音频采集/渲染。
相关 API 请参考: