音视频通话

收听房间内的声音

功能介绍

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

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

1. 默认收听行为

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

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

2. 扬声器音量与静音

在保持默认混音播放的前提下,可调节本端“播放音量”和“是否静音”,仅影响本端听到的声音,不影响房间内其他人。

  • 系统音量:直接设置当前扬声器设备的系统音量(0~255)。

  • 软件音量:在系统音量基础上再乘以缩放系数,不修改系统设置,适合做“会议音量”独立于系统音量的场景。

  • 扬声器静音:关闭本端扬声器输出,即本端不再播放房间内任何人的声音(仅本地生效)。

  • 设置/获取扬声器音量示例:

CRVideoSDKMeeting& meeting = g_sdkMain->getSDKMeeting();

// 设置扬声器系统音量(0~255)
meeting.setSpkVolume(180);
int spkVol = meeting.getSpkVolume();

// 设置扬声器音量缩放系数(不改变系统设置)
meeting.setSpkVolumeScaling(1.0f);  // 1.0 表示不缩放
float scaling = meeting.getSpkVolumeScaling();
  • 扬声器静音示例:
CRVideoSDKMeeting& meeting = g_sdkMain->getSDKMeeting();

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

相关 API 请参考:

扬声器设备选择与设备音量说明见 设备管理 - 默认音频设备与设备选择、设备音量控制。

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

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

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

切换为独立流模式后,默认不订阅任何人,必须调用 setAudioSubscribeListForSeparateMode 设置要收听的对象(白名单)或要排除的对象(黑名单)。

  • 设置订阅模式与名单示例:
CRVideoSDKMeeting& meeting = g_sdkMain->getSDKMeeting();

// 切换为独立流模式
meeting.setAudioSubscribeMode(CRVSDK_ASM_SEPARATE);

// 白名单:只收听 user1、user2 的声音(userIds 以 ";" 分隔)
const char* whiteList = "user1;user2";
meeting.setAudioSubscribeListForSeparateMode(CRVSDK_ASLT_INCLUDE, whiteList);

// 黑名单:收听除 user1 外所有人的声音
const char* blackList = "user1";
meeting.setAudioSubscribeListForSeparateMode(CRVSDK_ASLT_EXCLUDE, blackList);
  • 恢复默认(收听所有人):
CRVideoSDKMeeting& meeting = g_sdkMain->getSDKMeeting();
meeting.setAudioSubscribeMode(CRVSDK_ASM_MIXED);

此接口在进入房间前后均可调用,程序退出后失效。白名单与黑名单不共存,后一次设置会覆盖前一次。

相关 API 与常量请参考:

4. 自定义音频渲染(可选)

若不需要由 SDK 向系统扬声器播放,而是自行处理 PCM 数据(例如送给第三方设备或算法),可开启自定义音频渲染,通过 pullCustomAudioDat 从 SDK 拉取房间内已订阅的混音数据并自行播放。开启后 SDK 内部不再向系统扬声器输出。

具体步骤与格式要求见 自定义音频采集/渲染。

相关 API 请参考: