音视频通话

收听房间内的声音

功能介绍

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

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

1. 默认收听行为

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

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

2. 扬声器音量与静音

在保持默认混音播放的前提下,可调节本端播放音量和是否静音,仅影响本端听到的声音。

  • 设置/获取扬声器音量示例:
const rtcsdk = new RTCSDK();

// 设置扬声器系统音量(0~255)
rtcsdk.setSpkVolume(180);
const spkVol = rtcsdk.getSpkVolume();
  • 扬声器静音示例:
const rtcsdk = new RTCSDK();

// 静音扬声器:本端不再播放房间内声音
rtcsdk.setSpeakerMute(true);
// 取消静音
rtcsdk.setSpeakerMute(false);
const isMute = rtcsdk.getSpeakerMute();

相关 API 请参考:

3. 音频订阅模式(可选)

默认混音模式下会收听房间内所有开麦人的声音。若需要只收听指定人员或排除指定人员的语音,可切换为独立流模式并设置订阅名单。

  • 混音模式(默认):一个混音流,带宽与 CPU 占用较小,无法按人控制订阅。
  • 独立流模式:每人一路流,可设置白名单或黑名单。

切换为独立流模式后,默认不订阅任何人,必须调用 setAudioSubscribeListForSeparateMode 设置要收听的对象。

  • 设置订阅模式与名单示例:
const rtcsdk = new RTCSDK();

// 切换为独立流模式
rtcsdk.setAudioSubscribeMode(1);

// 白名单:只收听 user1、user2 的声音(userIds 以 ";" 分隔)
rtcsdk.setAudioSubscribeListForSeparateMode(0, "user1;user2");

// 黑名单:收听除 user1 外所有人的声音
rtcsdk.setAudioSubscribeListForSeparateMode(1, "user1");
  • 恢复默认(收听所有人):
rtcsdk.setAudioSubscribeMode(0);

相关 API 请参考: