音视频通话

音频3A配置

功能介绍

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

1. 获取与设置 3A 参数

  • 调用示例:
// 获取当前音频配置
AudioCfg *aCfg = [[RTCMeeting shareInstance] getAudioCfg];

// 根据业务场景配置 3A
aCfg.agc = 1;   // 是否启用自动增益(自动调节麦克风音量)
aCfg.ans = 1;   // 是否启用降噪(抑制键盘声、空调声等环境噪声)
aCfg.aec = 1;   // 是否启用回声消除(抑制本端扬声器回输到麦克风的回声)

// 生效配置
[[RTCMeeting shareInstance] setAudioCfg:aCfg];

相关结构体与 API 请参考:

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

  • 笔记本/手机外放、小型会议室
    • 扬声器声音容易被麦克风采集产生回声,建议开启完整 3A:
AudioCfg *aCfg = [[RTCMeeting shareInstance] getAudioCfg];
aCfg.agc = 1;   // 适当补偿说话人距离、音量差异
aCfg.ans = 1;   // 抑制环境噪声
aCfg.aec = 1;   // 必须开启,用于消除本端回声
[[RTCMeeting shareInstance] setAudioCfg:aCfg];
  • 佩戴耳机通话
    • 一般不会产生明显回声,可关闭 AEC 以降低运算开销:
AudioCfg *aCfg = [[RTCMeeting shareInstance] getAudioCfg];
aCfg.agc = 1;
aCfg.ans = 1;
aCfg.aec = 0;  // 佩戴耳机时通常可关闭回声消除
[[RTCMeeting shareInstance] setAudioCfg:aCfg];
  • 已有外置音频处理设备(带硬件 AGC/AEC/降噪)
    • 若前级设备已做较强的增益与回声处理,SDK 侧可适当关闭部分 3A,避免多次处理导致音质失真:
AudioCfg *aCfg = [[RTCMeeting shareInstance] getAudioCfg];
aCfg.agc = 0;  // 交由外置设备处理增益
aCfg.ans = 1;   // 保留轻度降噪
aCfg.aec = 0;  // 如设备已具备回声处理,可关闭
[[RTCMeeting shareInstance] setAudioCfg:aCfg];

3. 使用注意事项

  • 生效范围:3A 仅作用于本端采集并发送到房间的音频数据,不会改变远端播放出来的声音内容。
  • 与音量接口的关系:
    • AGC 主要用于自动调节麦克风采集电平,可与 setMicVolume、setMicVolumeScaling 配合使用。
    • 建议优先通过 AGC 做整体电平控制,再用音量接口做精细调节。
  • 与自定义音频采集/渲染的关系:
    • 当使用 SDK 默认音频设备采集/播放时,3A 能获得更完整的处理链路和更佳效果。
    • 若采用自定义音频采集/渲染(参考 [自定义音频采集/渲染](audioCustomize.md),3A 的实际效果可能与默认模式有所差异,建议在目标设备和环境下进行充分测试后确定最终配置。
  • 调试建议:在接入初期,可以分别在“关闭全部 3A”、“仅开启 AGC+ANS”、“全开 3A”三种模式下录制对比样本,结合实际主叫/被叫环境选择最合适的参数组合。