音频 3A 处理

---

功能简介

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

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

示例源码下载

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

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

默认配置与推荐配置

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

前提条件

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

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

使用步骤

设置 AEC（回声消除）

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

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

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

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

   枚举值	说明
   ZegoAECModeAggressive	激进的回声抵消，可能会比较明显的影响音质，但是回声会消除得很干净。
   ZegoAECModeMedium	适度的回声抵消，可能会稍微影响一点点音质，但是残留的回声会更少。
   ZegoAECModeSoft	舒适的回声抵消，回声抵消基本不会影响声音的音质，可能有时会残留一点回声，但不会影响正常听音。

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

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

设置 AGC （自动增益控制）

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

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

设置 ANS (噪声抑制)

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

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

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

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

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

   枚举值	说明
   ZegoANSModeAggressive	激进的噪声抑制，有可能明显损伤音质，但有很好的降噪效果。
   ZegoANSModeMedium	适度的噪声抑制，有可能损伤一些音质，但有不错的降噪效果。
   ZegoANSModeSoft	轻度的噪声抑制，基本不会损伤音质，但会残留一些噪声。

   Express SDK 支持 AI 模式噪声抑制，并提供轻量模式、均衡模式及低延迟模式三种模式，在消除稳态噪声的基础上，有效消除瞬态噪声，如键盘、咳嗽、风声、汽车喇叭等瞬态噪声，详情请参考 场景化 AI 降噪。

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

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

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

相关文档

• 怎么处理音频回声问题？
• 怎么处理音频噪声问题？
• 如何获取、上传音频的 Dump 文件？