音频 3A 处理
功能简介
在实时音视频通话或直播时，可以对音频进行 3A 处理，主要包括 AEC（Acoustic Echo Cancelling，回声消除）、AGC（Automatic Gain Control，自动增益控制）和 ANS（Active Noise Control，降噪），以提高通话或直播质量和用户体验。
- AEC（回声消除）：对采集到的音频数据进行过滤以减少音频中的回声。
- AGC（自动增益控制）：开启该功能后，SDK 能够自动调节麦克风音量，适应远近拾音，保持音量稳定。
- ANS（降噪）：识别声音中的背景噪声并进行消除，开启该功能后可以使人声更加清晰。
本功能不支持在 WebGL 环境中运行使用。
示例源码下载
请参考 下载示例源码 获取源码。
相关源码请查看 “Assets/ZegoExpressExample/Examples/AdvancedAudioProcessing/AEC_ANS_AGC.cs” 文件。
默认配置与推荐配置
SDK 中音频 3A 处理的默认配置和推荐配置如下：
| 接口名称 | 接口描述 | 默认配置 | 推荐配置 |
|---|---|---|---|
| EnableAEC | 开/关回声消除。 | 未调用此函数前，SDK 内部会自动判断是否需要使用 AEC，一旦调用此函数，则 SDK 不再自动判断。 | 在一般使用场景中，建议不修改该配置，保持默认即可。 |
| SetAECMode | 设置回声消除模式。 | Aggressive（激进的回声抵消）。 | 在一般使用场景中，建议不修改该配置，保持默认即可。 |
| EnableAGC | 开/关自动增益控制。 | 未调用此函数前，SDK 内部会自动判断是否需要使用 AGC，一旦调用此函数，则不再自动判断。 |
|
| EnableANS | 开/关噪声抑制。 | 未调用此函数前，SDK 内部会自动判断是否需要使用 ANS，一旦调用此函数，则不再自动判断。 | 在一般使用场景中，建议不修改该配置，保持默认即可。 |
| enableTransientANS | 开/关瞬态噪声抑制。 | 未调用此函数时，默认不开启瞬态噪声抑制。 | 在一般使用场景中，建议不修改该配置，保持默认即可。 |
| SetANSMode | 设置音频噪声抑制模式。 | Medium（适度的噪声抑制）。 | 在一般使用场景中，建议不修改该配置，保持默认即可。 |
前提条件
在使用音频 3A 处理之前，请确保：
- 已在 ZEGO 控制台 创建项目，并申请有效的 AppID 和 AppSign，详情请参考 控制台 - 项目信息。
- 已在项目中集成 ZEGO Express SDK，并实现了基本的音视频推拉流功能，详情请参考 快速开始 - 集成 和 快速开始 - 实现流程。
使用步骤
设置 AEC（回声消除）
EnableAEC 和 SetAECMode 都需要在 StartPublishingStream、StartPlayingStream、StartPreview、CreateMediaPlayer 和 CreateAudioEffectPlayer 这些接口之前调用才有效。
开发者可以按照以下步骤完成回声消除相关设置：
-
调用 EnableAEC 接口开启回声消除，该功能开启后，SDK 会对采集到的音频数据进行过滤以减少音频中的回声。
-
开启回声消除后，开发者可通过调用 SetAECMode 接口，设置回声消除模式。SDK 支持以下三种回声消除模式：
枚举值 说明 Aggressive 激进的回声抵消，可能会比较明显的影响音质，但是回声会消除得很干净。 Medium 适度的回声抵消，可能会稍微影响一点点音质，但是残留的回声会更少。 Soft 舒适的回声抵消，回声抵消基本不会影响声音的音质，可能有时会残留一点回声，但不会影响正常听音。
以设置适度的回声抵消为例：
// 开启 AEC
engine.EnableAEC(true);
// 设置 AEC 模式为 Medium
engine.SetAECMode(Medium);设置 AGC （自动增益控制）
调用 EnableAGC 接口开启自动增益控制，开启该功能后，SDK 能够自动调节麦克风音量，适应远近拾音，保持音量稳定。
// 开启 AGC
engine.EnableAGC(true);设置 ANS (噪声抑制)
开发者可以按照以下步骤完成噪声抑制相关设置：
-
调用 EnableANS 接口开启噪声抑制，该功能开启后可以使人声更加清晰。
-
（可选）开发者可通过调用 EnableTransientANS 接口设置是否开启瞬态噪声抑制，瞬态噪声抑制用于抑制敲击键盘、桌子等瞬态噪声。
-
开启噪声抑制后，开发者可通过调用 SetANSMode 接口设置噪声抑制模式，默认值为 “ZegoANSMode.Medium”。SDK 支持以下四种噪声抑制模式：
枚举值 说明 Soft 轻度的噪声抑制，基本不会损伤音质，但会残留一些噪声。 Medium （默认值）适度的噪声抑制，有可能损伤一些音质，但有不错的降噪效果。 Aggressive 激进的噪声抑制，有可能明显损伤音质，但有很好的降噪效果。 AI AI 模式噪声抑制，会对音乐有较大损伤，故不能用于对需要采集背景音的音源进行噪声抑制。如需使用，请联系技术支持。 -
（可选）开启音乐检测。请联系 ZEGO 技术支持配置开启音乐检测功能。
以设置轻度的噪声抑制为例：
// 开启 ANS
engine.EnableANS(true);
// 开启瞬态噪声抑制
engine.EnableTransientANS(true);
// 设置 ANS 模式为 Soft
engine.SetANSMode(Soft);