音视频通话

收听房间内的声音

功能介绍

本节介绍如何在房间内收听其他参会者的声音,包括:

  • 默认收听行为:入会后通过扬声器听到房间内所有开麦人的混音
  • 扬声器设备选择与播放音量、静音控制
  • 可选:设置音频订阅模式,只收听指定人员的语音(白名单/黑名单)

1. 默认收听行为

成功进入房间后,SDK 默认使用 混音模式(CRVSDK_ASM_MIXED):房间内所有开麦人的声音会混成一路语音流,由本端扬声器播放。无需额外调用即可听到他人说话。

  • 扬声器设备:使用 音频设备管理 中的 spkID(空为系统默认扬声器)。
  • 若听不到声音,可检查:本端扬声器未静音、音量合适、对方已开麦,以及 设备管理 中的扬声器选择与音量。

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 与常量请参考: