实时音视频
实时音视频
文档指南
请输入
实时音视频
快速入门
场景方案
开发指南
Token 鉴权
音频管理
视频管理
屏幕共享
SDK 升级指南
客户端 API 参考
服务端 API 参考
房间管理
转推直播
输入在线媒体流
WTN 流（原公共流）
实时数据监控
历史数据查询
业务标识管理
实时消息通信
历史版本（文档停止维护）
2023-08-01
2023-06-01
转推直播
2022-06-01
2020-12-01
转推直播
输入在线媒体流
获取数据指标
常见问题
集成相关
质量相关
AI 音视频互动方案
开始使用
开发指南
API 参考
硬件对话智能体
用户指南
服务端 API
智能体
实时信令
互动白板
客户端 API 参考
服务端 API 参考
- 文档首页
实时音视频实时音视频开发指南音频管理Web 端音频降噪
复制全文
下载 pdfWeb 端音频降噪
文档反馈
问问助手在实时音视频通话中，背景噪声可能会影响通话质量，RTC SDK 提供了两种降噪方式：浏览器内置降噪和 AI 音频降噪插件。本文档将介绍如何选择和集成适合你业务场景的降噪方式。
选择降噪方式
你可以根据噪声类型，选择不同的降噪方式。
噪声类型 | 特点 | 推荐降噪方式 |
噪声类型 | 特点 | 推荐降噪方式 |
平稳噪声 | 持续且音量稳定的背景噪声，如空调、风扇或电子设备的嗡嗡声。 | 浏览器内置降噪 AI 音频降噪插件 |
非平稳噪声 | 出现时机或响度都不可预测的瞬时噪声，如键盘敲击、物体碰撞、人声干扰。 | AI 音频降噪插件 |
方式 1：开启浏览器内置降噪（可抑制平稳噪声）
在开始采集和发布音频前，调用 setAudioCaptureConfig 并将 noiseSuppression、echoCancellation 和 autoGainControl 均设置为 true。
// 必须在 startAudioCapture() 和 publishStream() 之前设置
await engine.setAudioCaptureConfig({
noiseSuppression: true,
echoCancellation: true,
autoGainControl:true,
});
await engine.startAudioCapture();
await engine.publishStream(MediaType.AUDIO);
方式 2：通过 AI 音频降噪插件（可抑制平稳噪声和非平稳噪声）
前提条件
- 已集成 RTC SDK V4.47 或更高版本。
- 已实现了音频通话功能。具体操作，可参见实现音频通话。
- AI 降噪插件仅支持以下 PC 端浏览器：Chrome 94+、Edge 94+、Firefox 80+、Safari 14.1+
- 设备建议（为保证最佳体验）：
- 双核 Intel Core i5+
- RAM 8 GB+
- 64 位操作系统
操作步骤
- 在你的项目中引入 AI 降噪插件，可通过以下任一方式：
- 方式1：直接引入
确保插件来自本地工程中已引入的 RTC SDK。避免因插件版本不匹配导致的引用错误。
import RTCAIAnsExtension from '@volcengine/rtc/extension-ainr';
- 方式2：通过 UMD 方式引入（仅 v4.51.1 及以上版本支持）
const {RTCAIAnsExtension} = window.VERTCExtensions;
- 初始化插件并检查浏览器是否支持。
- // 创建插件实例const AIAnsExtension = new RTCAIAnsExtension();// 检查当前浏览器环境是否支持 AI 降噪插件const isSupported = await AIAnsExtension.isSupported();
- 注册 AI 插件并设置监听事件。
- import VERTC from '@volcengine/rtc';// 直接引入import {EventTypes as AIAnsEventTypes} from '@volcengine/rtc/extension-ainr';// 创建引擎实例const engine = VERTC.createEngine('<YOUR_APP_ID>');// 注册 AI 降噪插件try {await engine.registerExtension(AIAnsExtension);} catch (error) {// 注册失败，详细信息见：error.message}AIAnsExtension.on(AIAnsEventTypes.onUnsupported, ({message}) => {// 降噪插件运行时遇到不支持情况，详细信息见：message})AIAnsExtension.on(AIAnsEventTypes.onOverload, ({elapsedTime}) => {// 系统负载过高，降噪插件运算耗时过长。建议降低档位或者关闭降噪插件。})AIAnsExtension.on(AIAnsEventTypes.onError, ({message}) => {// 降噪插件运行时遇到错误。详细信息见：message// 根据错误信息情况可以考虑尝试恢复降噪插件运行，或者关闭降噪插件AIAnsExtension.resume();})
- 开启内部音频采集。
engine.startAudioCapture();
- 开启/关闭 AI 降噪。
- 你可以在通话过程中随时开启或关闭 AI 降噪，将立即生效。
- 自 V4.65.0 版本起，你可以为指定音频流开启 AI 降噪功能。
// 为外部屏幕流开启降噪
AIAnsExtension.enable({
streamIndex: StreamIndex.STREAM_INDEX_SCREEN,
sourceType: AudioSourceType.AUDIO_SOURCE_TYPE_EXTERNAL,
});
// 对内部主流关闭降噪
AIAnsExtension.disable({
streamIndex: StreamIndex.STREAM_INDEX_MAIN,
sourceType: AudioSourceType.AUDIO_SOURCE_TYPE_INTERNAL,
});
- 不指定音频流时，默认为内部主流。使用 V4.65.0 之前的版本，默认对内部主流开启降噪。
// 开启降噪
AIAnsExtension.enable();
// 关闭降噪
AIAnsExtension.disable();
- 设置降噪模式。
// 自动模式
await AIAnsExtension.setAnsMode(AnsMode.AUTO);
降噪模式说明如下：
模式 | 取值 | 说明 |
模式 | 取值 | 说明 |
LOW | 'low' | 适用于微弱平稳噪声。 |
MEDIUM | 'medium' | 适用于抑制中度平稳噪声，如空调声、风扇声。 |
HIGH | 'high' | 适用于抑制嘈杂非平稳噪声，如键盘声、敲击声、碰撞声、动物叫声。 |
AUTO | 'auto' | 启用音频降噪能力。具体的降噪算法由 AI 降噪插件决定。 |
更多说明
同时使用两种降噪方式
插件状态 | autoGainControl | echoCancellation | noiseSuppression |
插件状态 | autoGainControl | echoCancellation | noiseSuppression |
插件已注册未开启 | 有效 | 有效 | 固定为 true |
插件已注册已开启 | 固定为 true | 有效 | 固定为 false |
关闭采样率转换提升 AI 降噪插件的性能
AI 降噪插件默认处理 48kHz 采样率、音频帧大小为 480 的音频流，并默认开启了采样率转换功能。如果待处理的音频流满足上述条件，可参照以下设置，关闭采样率转换以获得更优性能。
const AIAnsExtension = new RTCAIAnsExtension({
resample: false,
});
最近更新时间：2026.08.05 16:08:44
这个页面对您有帮助吗？
有用
有用
无用
无用