音频 3A 处理

---

1 功能简介

在实时音视频通话或直播时，可以对音频进行 3A 处理，主要包括 AEC（Acoustic Echo Cancelling，回声消除），AGC（Automatic Gain Control，自动增益控制）和 ANS（Active Noise Control，降噪），以提高通话或直播质量和用户体验。

• AEC（回声消除）：对采集到的音频数据进行过滤以减少音频中的回声。
• AGC（自动增益控制）：开启该功能后，SDK 能够自动调节麦克风音量，适应远近拾音，保持音量稳定。
• ANS（降噪）：识别声音中的背景噪声并进行消除，开启该功能后可以使人声更加清晰。同时您可以开启音乐场景检测，实时无消耗识别通讯和音乐场景，在音乐场景对人声以及音乐的音质进一步保真。如果用户需要更加激进的降噪策略，可使用 场景化 AI 降噪 功能。

2 示例源码下载

请参考 下载示例源码 获取源码。

相关源码请查看 “/ZegoExpressExample/Examples/AdvancedAudioProcessing/AECANSAGC” 目录下的文件。

3 前提条件

在使用音频 3A 处理之前，请确保：

• 已在项目中集成 ZEGO Express SDK，实现基本的实时音视频功能，详情请参考 快速开始 - 集成 和 快速开始 - 实现流程。
• 已在 ZEGO 控制台 创建项目，并申请有效的 AppID 和 AppSign，详情请参考 控制台 - 项目信息。

4 使用步骤

4.1 设置 AEC（回声消除）

开发者可以按照以下步骤完成回声消除相关设置：

1. 调用 enableAEC 接口开启回声消除，该功能开启后，SDK 会对采集到的音频数据进行过滤以减少音频中的回声。

2. （可选）开发者可通过调用 enableHeadphoneAEC 接口设置是否在使用耳机的时候开启回声消除。

3. 开启回声消除后，开发者可通过调用 setAECMode 接口设置回声消除模式。SDK 支持以下三种回声消除模式：

以设置适度的回声抵消为例：

// 开启 AEC
[[ZegoExpressEngine sharedEngine] enableAEC:YES];
// 在使用耳机时开启 AEC
[[ZegoExpressEngine sharedEngine] enableHeadphoneAEC:YES];
// 设置 AEC 模式为 ZegoAECModeMedium
[[ZegoExpressEngine sharedEngine] setAECMode:ZegoAECModeMedium];

4.2 设置 AGC （自动增益控制）

调用 enableAGC 接口开启自动增益控制，开启该功能后，SDK 能够自动调节麦克风音量，适应远近拾音，保持音量稳定。

// 开启 AGC
[[ZegoExpressEngine sharedEngine] enableAGC:YES];

4.3 设置 ANS (噪声抑制)

开发者可以按照以下步骤完成噪声抑制相关设置：

1. 调用 enableANS 接口开启噪声抑制，该功能开启后可以使人声更加清晰。

2. （可选）开发者可通过调用 enableTransientANS 接口设置是否开启瞬态噪声抑制。瞬态噪声抑制用于抑制敲击键盘、桌子等瞬态噪声。

3. 开启噪声抑制后，开发者可通过调用 setANSMode 接口设置噪声抑制模式，默认值为 “ZegoANSModeMedium”。

SDK 支持以下四种噪声抑制模式：

以设置适度的噪声抑制为例：

// 开启 ANS
[[ZegoExpressEngine sharedEngine] enableANS:YES];
// 开启瞬态噪声抑制
[[ZegoExpressEngine sharedEngine] enableTransientANS:YES];
// 设置 ANS 模式为 ZegoANSModeMedium
[[ZegoExpressEngine sharedEngine] setANSMode:ZegoANSModeMedium];

4. （可选）开启音乐检测。请联系 ZEGO 技术支持配置开启音乐检测功能。

5 推荐配置

SDK 中音频 3A 处理的默认配置和推荐配置如下：

6 API 参考列表

相关文档

• 怎么处理音频回声问题？
• 怎么处理音频噪声问题？