1 概述
在实时音视频通话时，可以对音频进行 3A 处理，提高通话质量和用户体验。主要包括 AEC（Acoustic Echo Cancelling，回声消除），AGC（Automatic Gain Control，自动增益控制）和 ANS（Active Noise Control，降噪）。
- AEC（回声消除）：对采集到的音频数据进行过滤以减少音频中的回声。
- AGC（自动增益控制）：自动调节麦克风音量，适应远近拾音，保持音量稳定。
- ANS（降噪）：识别声音中的背景噪声并进行消除，开启该功能后可以使人声更加清晰。
2 源码下载
下载示例源码
参考目录文件： /ZegoExpressExample/AdvancedAudioProcessing/src/main/java/im/zego/advancedaudioprocessing/audio3a
3 环境准备
在使用音频 3A 处理之前，请确保：
- 已在项目中集成 ZEGO Express SDK，实现基本的实时音视频功能，详情请参考 快速开始 - 集成 和 快速开始 - 实现流程。
- 已在 ZEGO 控制台 创建项目，并申请有效的 AppID，详情请参考 控制台 - 项目管理 中的“项目信息”。
4 使用步骤
4.1 设置 AEC（回声消除）
可以按照以下步骤完成回声消除相关设置：
调用 enableAEC 接口开启回声消除，该功能开启后，SDK 会对采集到的音频数据进行过滤以减少音频中的回声。
（可选）可通过调用 enableHeadphoneAEC 接口设置是否在使用耳机的时候开启回声消除。
开启回声消除后，可通过调用 setAECMode 接口设置回声消除模式。SDK 支持以下三种回声消除模式：
| 枚举值 | 说明 |
|---|---|
| ZegoAECMode.AGGRESSIVE | 激进的回声抵消，可能会比较明显的影响音质，但是回声会消除得很干净。 |
| ZegoAECMode.MEDIUM | 适度的回声抵消，可能会稍微影响一点点音质，但是残留的回声会更少。 |
| ZegoAECMode.SOFT | 舒适的回声抵消，回声抵消基本不会影响声音的音质，可能有时会残留一点回声，但不会影响正常听音。 |
以设置适度的回声抵消为例：
// 开启 AEC
engine.enableAEC(true);
// 在使用耳机时开启 AEC
engine.enableHeadphoneAEC(true);
// 设置 AEC 模式为 ZegoAECMode.MEDIUM
engine.setAECMode(ZegoAECMode.MEDIUM);
4.2 设置 AGC （自动增益控制）
调用 enableAGC 接口开启自动增益控制，开启该功能后，SDK 能够自动调节麦克风音量，适应远近拾音，保持音量稳定。
// 开启 AGC
engine.enableAGC(true);
4.3 设置 ANS (噪声抑制)
可以按照以下步骤完成噪声抑制相关设置：
调用 enableANS 接口开启噪声抑制，该功能开启后可以使人声更加清晰。
（可选）可通过调用 enableTransientANS 接口设置是否开启瞬态噪声抑制，瞬态噪声抑制用于抑制敲击键盘、桌子等瞬态噪声。
开启噪声抑制后，可通过调用 setANSMode 接口设置噪声抑制模式，默认值为 “MEDIUM”。SDK 支持以下三种噪声抑制模式：
| 枚举值 | 说明 |
|---|---|
| ZegoANSMode.AGGRESSIVE | 激进的噪声抑制，有可能明显损伤音质，但有很好的降噪效果。 |
| ZegoANSMode.MEDIUM | （默认值）适度的噪声抑制，有可能损伤一些音质，但有不错的降噪效果。 |
| ZegoANSMode.SOFT | 轻度的噪声抑制，基本不会损伤音质，但会残留一些噪声。 |
| ZegoANSMode.AI | AI 模式噪声抑制，会对音乐有较大损伤，可用于处理非稳态噪声，但不能用于需要采集背景音的音源处理，详情请参考 AI 降噪。 |
以设置轻度的噪声抑制为例：
// 开启 ANS
engine.enableANS(true);
// 开启瞬态噪声抑制
engine.enableTransientANS(true);
// 设置 ANS 模式为 ZegoANSMode.SOFT
engine.setANSMode(ZegoANSMode.SOFT);
5 推荐配置
SDK 中音频 3A 处理的默认配置和推荐配置如下：
| 接口名称 | 接口描述 | 默认配置 | 推荐配置 |
|---|---|---|---|
| enableAEC | 开/关回声消除 | True | 在一般使用场景中，建议不修改该配置，保持默认即可。 |
| enableHeadphoneAEC | 是否在使用耳机时开启回声消除 | False | 在普通语聊或游戏开黑时，建议启用该功能，其他情况下一般无需启用。 |
| setAECMode | 设置回声消除模式 | ZegoAECMode.AGGRESSIVE（激进的回声抵消） | 在一般使用场景中，建议不修改该配置，保持默认即可。 |
| enableAGC | 开/关自动增益控制 | True | <ul><li>在普通语聊场景中，建议使用默认配置。</li><li>在音乐电台场景中，建议不开启自动增益控制以还原人声。</li><li>在教育场景中，如大班课、小班课和 1V1 等，建议开启自动增益控制。</li></ul> |
| enableANS | 开/关噪声抑制 | True | 在一般使用场景中，建议不修改该配置，保持默认即可。 |
| setANSMode | 设置音频噪声抑制模式 | ZegoANSMode.MEDIUM（适度的噪声抑制） | 在一般使用场景中，建议不修改该配置，保持默认即可。 |
6 API 参考列表
| 方法 | 描述 |
|---|---|
| enableAEC | 开/关回声消除 |
| enableHeadphoneAEC | 是否在使用耳机时开启回声消除 |
| setAECMode | 设置回声消除模式 |
| enableAGC | 开/关自动增益控制 |
| enableANS | 开/关噪声抑制 |
| enableTransientANS | 开/关瞬态噪声抑制 |
| setANSMode | 设置音频噪声抑制模式 |
