音视频通话

音频 3A 配置

功能介绍

音频 3A 是指 SDK 内置的三种音频处理能力:自动增益(AGC)、降噪(ANS)、回声消除(AEC)。
合理配置 3A 能够在不同终端、不同环境下明显提升语音清晰度和通话体验。

注意:

成功进入房间后,才可以设置音频 3A 参数。

1. 获取与设置 3A 参数

// 获取当前音频配置
AudioCfg aCfg = RTCMeeting.getInstance().getAudioCfg();

// 根据业务场景配置 3A
aCfg.agc = true;  // 自动增益
aCfg.ans = true;  // 降噪
aCfg.aec = true;  // 回声消除

// 生效配置
RTCMeeting.getInstance().setAudioCfg(aCfg);

相关结构体与 API 请参考:

2. 不同场景下的推荐配置

  • 手机外放、小型会议室
    • 扬声器声音容易被麦克风采集产生回声,建议开启完整 3A:
AudioCfg aCfg = RTCMeeting.getInstance().getAudioCfg();
aCfg.agc = true;
aCfg.ans = true;
aCfg.aec = true;
RTCMeeting.getInstance().setAudioCfg(aCfg);
  • 佩戴耳机通话
    • 一般不会产生明显回声,可关闭 AEC 以降低运算开销:
AudioCfg aCfg = RTCMeeting.getInstance().getAudioCfg();
aCfg.agc = true;
aCfg.ans = true;
aCfg.aec = false;
RTCMeeting.getInstance().setAudioCfg(aCfg);

3. 使用注意事项

  • 生效范围:3A 仅作用于本端采集并发送到房间的音频数据。
  • 与音量接口的关系:AGC 可与 setMicVolume、setMicVolumeScaling 配合使用。
  • 与自定义音频采集的关系:若采用 自定义音频采集/渲染,3A 的实际效果可能与默认模式有所差异,建议在目标设备上进行充分测试。