收听房间内的声音
功能介绍
本节介绍如何在房间内收听其他参会者的声音,包括:
- 默认收听行为:入会后通过扬声器听到房间内所有开麦人的混音
- 扬声器设备选择与播放音量、静音控制
- 可选:设置音频订阅模式,只收听指定人员的语音(白名单/黑名单)
1. 默认收听行为
成功进入房间后,SDK 默认使用 混音模式(CRVSDK_ASM_MIXED):房间内所有开麦人的声音会混成一路语音流,由本端扬声器播放。无需额外调用即可听到他人说话。
2. 扬声器音量与静音
在保持默认混音播放的前提下,可调节本端"播放音量"和"是否静音",仅影响本端听到的声音,不影响房间内其他人。
-
扬声器静音:关闭本端扬声器输出,即本端不再播放房间内任何人的声音(仅本地生效)。
-
设置/获取扬声器音量示例:
// 设置扬声器音量(0~255)
sdk_engine.setSpkVolume(180);
const spkVol = sdk_engine.getSpkVolume();
- 扬声器静音示例:
// 静音扬声器:本端不再播放房间内声音
sdk_engine.setSpeakerMute(true);
// 取消静音
sdk_engine.setSpeakerMute(false);
const isMute = sdk_engine.getSpeakerMute();
相关 API 请参考:
扬声器设备选择与设备音量说明见 设备管理。
3. 音频订阅模式(可选)
默认混音模式下会收听房间内所有开麦人的声音。若需要 只收听指定人员 或 排除指定人员 的语音,可切换为独立流模式并设置订阅名单。
- 混音模式 CRVSDK_ASM_MIXED(默认):一个混音流,带宽与 CPU 占用较小,无法按人控制订阅。
- 独立流模式 CRVSDK_ASM_SEPARATE:每人一路流,可设置白名单或黑名单,仅收听名单内或名单外的人。
切换为独立流模式后,默认不订阅任何人,必须调用 setAudioSubscribeListForSeparateMode 设置要收听的对象(白名单)或要排除的对象(黑名单)。
- 设置订阅模式与名单示例:
// 切换为独立流模式
sdk_engine.setAudioSubscribeMode(CRVSDK_ASM_SEPARATE);
// 白名单:只收听 user1、user2 的声音(userIds 以 ";" 分隔)
const whiteList = "user1;user2";
sdk_engine.setAudioSubscribeListForSeparateMode(CRVSDK_ASLT_INCLUDE, whiteList);
// 黑名单:收听除 user1 外所有人的声音
const blackList = "user1";
sdk_engine.setAudioSubscribeListForSeparateMode(CRVSDK_ASLT_EXCLUDE, blackList);
- 恢复默认(收听所有人):
sdk_engine.setAudioSubscribeMode(CRVSDK_ASM_MIXED);
此接口在进入房间前后均可调用,程序退出后失效。白名单与黑名单不共存,后一次设置会覆盖前一次。
相关 API 与常量请参考: