收听房间内的声音
功能介绍
本节介绍如何在房间内收听其他参会者的声音,包括:
须在成功进入房间后,方可收听房间内声音;CRVideo_SetSpeakerMute 等播放器控制须在入会后调用。
CRVideo_SetAudioSubscribeMode / CRVideo_SetAudioSubscribeList 可在入会前预设,入会后按配置生效。
- 默认收听行为:入会后通过扬声器听到房间内所有开麦人的混音
- 扬声器设备选择与播放静音控制
- 可选:设置音频订阅模式,只收听指定人员的语音(白名单/黑名单)
- 可选:获取 WebRTC 音频流或 PCM 数据自行播放(如自定义播放器、算法处理等)
若不由 SDK 直接向扬声器播放,而是自行处理房间内音频,可使用 CRVideo_NotifyAudioStream 获取 WebRTC 音频流(aSide 为 1 表示远端),可设置 audio 标签的 srcObject 或配合 Web Audio API 播放;也可通过 原始音频数据获取 获取扬声器侧 PCM。
1. 默认收听行为
入会成功后,SDK 默认使用 混音模式(CRVideo_AUDIO_SUBSCRIBE_MODE 值为 0):房间内所有开麦人的声音会混成一路语音流,由本端扬声器播放。无需额外调用即可听到他人说话。
- 扬声器设备:通过 CRVideo_GetAudioCfg / CRVideo_SetAudioCfg 设置
speakerID(设备 ID 来自 CRVideo_GetAudioSpkNames),详见 音频设备管理。 - 若听不到声音,可检查:本端未静音(CRVideo_SetSpeakerMute)、对方已开麦,以及浏览器是否拦截自动播放。
部分场景下,用户进入房间前未与页面交互会导致自动播放失败,此时会收到 CRVideo_NotifyAudioPlayFailed。业务层应提示用户点击按钮后再取消静音;播放成功后会收到 CRVideo_NotifyAudioPlaying。
CRVideo_NotifyAudioPlayFailed.callback = function(){
// 提示用户点击页面后取消静音
CRVideo_SetSpeakerMute(false);
}
2. 扬声器静音
在保持默认混音播放的前提下,可控制本端是否播放房间内声音,仅影响本端听到的效果,不影响房间内其他人。
- 播放器静音:CRVideo_SetSpeakerMute(bMute) 配置房间内音频播放器是否静音(目前主要对全员混流模式生效)。
// 静音:本端不再播放房间内声音
CRVideo_SetSpeakerMute(true);
// 取消静音
CRVideo_SetSpeakerMute(false);
var isMute = CRVideo_GetSpeakerMute();
相关 API 请参考:
- CRVideo_SetSpeakerMute
- CRVideo_GetSpeakerMute
- CRVideo_NotifyAudioPlayFailed
- CRVideo_NotifyAudioPlaying
- CRVideo_GetAudioCfg
- CRVideo_SetAudioCfg
- 音频设备管理
3. 音频订阅模式(可选)
默认混音模式下会收听房间内所有开麦人的声音。若需要 只收听指定人员 或 排除指定人员 的语音,可切换为独立订阅模式并设置订阅名单。
- 全员混流模式(0,默认):一个混音流,带宽与 CPU 占用较小,无法按人控制订阅。
- 独立订阅模式(1):每人一路流,可设置白名单或黑名单。
- 混流 + 独立订阅(2):同时支持混流与独立订阅(具体行为以 SDK 实现为准)。
切换为独立订阅模式后,默认不订阅任何人,必须调用 CRVideo_SetAudioSubscribeList 设置要收听的对象(白名单)或要排除的对象(黑名单)。
// 切换为独立订阅模式
CRVideo_SetAudioSubscribeMode(1).then(function(errCode){
if (errCode == 0){
// 白名单:只收听 user1、user2
CRVideo_SetAudioSubscribeList(["user1", "user2"], 0);
// 黑名单:收听除 user1 外所有人
// CRVideo_SetAudioSubscribeList(["user1"], 1);
}
});
- 恢复默认(收听所有人):
CRVideo_SetAudioSubscribeMode(0);
该接口为全生命周期接口,可在会议外配置,在 SDK 反初始化之前始终生效。白名单与黑名单由 type 参数区分(0 白名单,1 黑名单),后一次设置会覆盖同类型名单。
相关 API 与常量请参考: