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