畅直播
  • iOS
  • Android : Java
  • macOS
  • Windows
  • Web
  • Flutter
  • 产品简介
    • 概述
    • 发布日志
    • 基本概念
    • 产品优势
    • 应用场景
    • 限制说明
    • 升级指南
  • 计费说明
  • 下载
  • 快速开始
  • 直播推流
  • 直播拉流
  • 通信能力
  • 房间能力
  • 音频能力
  • 视频能力
  • 直播能力
  • 其他能力
  • 最佳实践
  • 客户端 API
  • 服务端 API
  • 常用错误码
  • 常见问题
  • 文档中心
  • 畅直播
  • 音频能力
  • 音频 3A 处理

音频 3A 处理

更新时间:2024-02-26 17:44

功能简介

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

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

如需使用音乐场景检测能力,请联系 ZEGO 技术支持进行特殊编包与配置。

示例源码下载

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

相关源码请查看 “/ZegoExpressExample/AdvancedAudioProcessing/src/main/java/im/zego/advancedaudioprocessing/audio3a” 目录下的文件。

默认配置与推荐配置

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

接口名称 接口描述 默认配置 推荐配置
enableAEC 开/关回声消除。 未调用此函数前,SDK 内部会自动判断是否需要使用 AEC,一旦调用此函数,则 SDK 不再自动判断。 在一般使用场景中,建议不修改该配置,保持默认即可。
enableHeadphoneAEC 是否在使用耳机时开启回声消除。 不开启。 在普通语聊或游戏开黑时,建议启用该功能,其他情况下一般无需启用。
setAECMode 设置回声消除模式。 ZegoAECMode.AGGRESSIVE(激进的回声抵消)。 在一般使用场景中,建议不修改该配置,保持默认即可。
enableAGC 开/关自动增益控制。 未调用此函数前,SDK 内部会自动判断是否需要使用 AGC,一旦调用此函数,则 SDK 不再自动判断。
  • 在普通语聊场景中,建议使用默认配置。
  • 在音乐电台场景中,建议不开启自动增益控制以还原人声。
  • 在教育场景中,如大班课、小班课和 1v1 等,建议开启自动增益控制。
enableANS 开/关噪声抑制。 未调用此函数前,SDK 内部会自动判断是否需要使用 ANS,一旦调用此函数,则不再自动判断。 在一般使用场景中,建议不修改该配置,保持默认即可。
enableTransientANS 开/关瞬态噪声抑制。 未调用此函数时,默认不开启瞬态噪声抑制。 在一般使用场景中,建议不修改该配置,保持默认即可。
setANSMode 设置音频噪声抑制模式。 ZegoANSMode.MEDIUM(适度的噪声抑制)。 在一般使用场景中,建议不修改该配置,保持默认即可。

前提条件

在使用音频 3A 处理之前,请确保:

使用步骤

设置 AEC(回声消除)

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

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

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

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

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

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

// 开启 AEC
engine.enableAEC(true);
// 在使用耳机时开启 AEC
engine.enableHeadphoneAEC(true);
// 设置 AEC 模式为 ZegoAECMode.MEDIUM
engine.setAECMode(ZegoAECMode.MEDIUM);

设置 AGC(自动增益控制)

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

// 开启 AGC
engine.enableAGC(true);

设置 ANS (噪声抑制)

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

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

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

  3. 开启噪声抑制后,开发者可通过调用 setANSMode 接口设置噪声抑制模式,默认值为 “ZegoANSMode.MEDIUM”。 SDK 支持以下四种噪声抑制模式:

    枚举值 说明
    ZegoANSMode.AGGRESSIVE 激进的噪声抑制,有可能明显损伤音质,但有很好的降噪效果。
    ZegoANSMode.MEDIUM (默认值)适度的噪声抑制,有可能损伤一些音质,但有不错的降噪效果。
    ZegoANSMode.SOFT 轻度的噪声抑制,基本不会损伤音质,但会残留一些噪声。
    ZegoANSMode.AI AI 模式噪声抑制,会对音乐有较大损伤,可用于处理非稳态噪声,但不能用于需要采集背景音的音源处理,详情请参考 AI 降噪
  4. (可选)开启音乐检测。请联系 ZEGO 技术支持配置开启音乐检测功能。

以设置轻度的噪声抑制为例:

// 开启 ANS
engine.enableANS(true);
// 开启瞬态噪声抑制
engine.enableTransientANS(true);
// 设置 ANS 模式为 ZegoANSMode.SOFT
engine.setANSMode(ZegoANSMode.SOFT);

相关文档

本篇目录