# 插件发版说明 (/zh-CN/realtime-media/rtc/build/extensions/web/release) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). :::warning[注意] 使用 AI 降噪插件和虚拟背景插件可能会产生费用。请与 sales@shengwang.cn 沟通后再使用。 ::: ## AI 降噪插件 [#ai-降噪插件] 如果当前提供的降噪效果不能满足你的场景,你可以联系 sales@shengwang.cn 定制降噪效果。 实时互动场景降噪 AI 场景专用降噪 ### v2.0.1 [#v201] #### 升级必看 [#升级必看] 该版本不再支持在 `pipe` 前调用 `disable` 方法关闭 Processor。在调用 `disable` 前,请确保已调用 `pipe`。 #### 新特性 [#新特性] - 在 `IAIDenoiserExtension` 接口类中新增 `setLogLevel` 方法,用于设置插件和 WASM 模块的日志等级。 - AI 降噪新增了低延迟模式,你可以在 `IAIDenoiserProcessor` 接口类中调用新增的 `setLatency` 方法,用于设置降噪处理的时延。 #### 改进 [#改进] - 迭代降噪算法,在噪声抑制、人声保真度和整体鲁棒性方面实现提升。 - 大幅提升 16 kHz 及以上采样率场景下,AI 降噪后的人声保真度。 - 优化 CPU 资源分配策略,提升运行效率。 #### API 变更 [#api-变更] 该版本对回调的实现形式进行了调整。废弃了原来的 `onloaderror`, `onoverload`, `ondump`, `ondumpend` 回调,分别改用 `on("pipeerror"|"overload"|"dump"|"dumpend")` 方法监听对应事件。 ### v1.1.0 [#v110] #### 升级必看 [#升级必看-1] 升级到 v1.1.0 后,你需要关注 AI 降噪插件的以下变更: - 必须和 v4.15.0 或以上版本的 Web SDK 搭配使用。 - 只需要动态加载 Wasm 文件。由于不再依赖外部 JS 文件,你需要重新发布 `node_modules/agora-extension-ai-denoiser/external` 目录下的 Wasm 文件。如果你开启了 CSP(Content Security Policy),还需要修改 CSP 配置。详见[使用 AI 降噪插件](/zh-CN/realtime-media/rtc/build/extensions/web/noise-reduction#实现步骤)。 - 转储的音频数据以 PCM 格式保存,而不是 WAV。 - 调整降噪强度时推荐调用 `setLevel`,而非其它接口。 #### 新增特性 [#新增特性] 该版本新增以下 API 和参数: - `checkCompatibility`:快速测试当前浏览器是否支持 AI 降噪插件。 - `setMode`:调整降噪模式为 AI 降噪或稳态降噪。 - `setLevel`:调整降噪强度。 - `onoverload` 增加回调参数 `elapsedTime`:报告插件处理一帧音频的时间。 API 描述详见[使用 AI 降噪插件](/zh-CN/realtime-media/rtc/build/extensions/web/noise-reduction)。 #### 改进 [#改进-1] 该版本优化了 AI 降噪算法的计算性能。 ### v1.0.0 [#v100] AI 降噪插件 [agora-extension-ai-denoiser](https://www.npmjs.com/package/agora-extension-ai-denoiser)由 Beta 发布转变为正式发布。 相比之前的版本,v1.0.0 版本的 AI 降噪具有更好的人声保真度、更干净的噪声抑制,并新增了去混响 (Dereverberation) 能力。 ### v1.0.0-beta2 [#v100-beta2] AI 场景专用降噪插件 [agora-conversational-ai-denoiser](https://www.npmjs.com/package/agora-conversational-ai-denoiser) v1.0.0-beta2 于 2025 年 3 月 5 日发布,用于更好地支持[声网对话式 AI 引擎](/zh-CN/ai)的应用效果。 :::warning[注意] `agora-conversational-ai-denoiser` 插件对 CPU 消耗较高,我们建议你仅在 AI 场景下集成并使用该插件。 ::: 主要特性如下: - 显著提升人声(尤其是歌声)保护。 - 降低运行中音频采集播放卡顿的风险。 - 开启 AI 降噪后,AGC 最大增益的默认值从 24dB 下调至 12dB。 ## VAD 语音活动监测插件 [#vad-语音活动监测插件] ### v1.0.0-beta.2 [#v100-beta2-1] VAD 语音活动监测插件 [agora-extension-vad](https://www.npmjs.com/package/agora-extension-vad) v1.0.0-beta.2 于 2024 年 10 月 15 日发布,是 VAD 插件的第一个版本。详细集成步骤可以参考[使用 VAD 插件](/zh-CN/realtime-media/rtc/build/extensions/web/voice-activity-detection)。 ## 虚拟背景插件 [#虚拟背景插件] ### v2.1.0 [#v210] 该版本包含如下改动: - 优化了内存及 CPU 开销。 - 修复了特定分辨率时产生的黑屏问题。 ### v2.0.0 [#v200] 该版本将虚拟背景算法升级到 2.0.0 版本。新版本对人像算法进行全面升级,提供更加分明的人像边缘以及更加清晰稳定的视频画面。 ### v1.2.0 [#v120] #### 升级必看 [#升级必看-2] 自该版本起,虚拟背景插件内置了依赖的 Wasm 模块,你不需要再单独发布 Wasm 文件,调用 `init` 方法初始化插件时也不需要传入 `wasmDir` 参数。 升级到该版本后,请修改相关代码。 #### 改进 [#改进-2] 该版本升级了插件的背景分割算法,优化了复杂的静态背景和动态背景下对人像主体、边缘、手指的分割效果。 #### 问题修复 [#问题修复] 该版本修复了 `checkCompatibility` 在特定设备上检查结果不准确的问题。 #### API 变更 [#api-变更-1] `init` 方法的 `wasmDir` 参数改为可选。 ### v1.1.3 [#v113] #### 问题修复 [#问题修复-1] 该版本修复了 Android 端 Chrome 浏览器上背景图片偶现锯齿状效果的问题。 ### v1.1.2 [#v112] #### 升级必看 [#升级必看-3] 自 v1.1.2 起,虚拟背景插件必须和 v4.15.0 或以上版本的 Web SDK 搭配使用。 #### 新增特性 [#新增特性-1] 该版本支持在调用 `setOptions` 方法时设置 `fit` 属性,用于设置虚拟背景的填充方式。API 描述详见[使用虚拟背景插件](/zh-CN/realtime-media/rtc/build/extensions/web/virtual-background)。 ### v1.1.1 [#v111] #### 新增特性 [#新增特性-2] 该版本新增 `checkCompatibility` 方法,用于快速测试当前浏览器是否支持虚拟背景插件。API 描述详见[使用虚拟背景插件](/zh-CN/realtime-media/rtc/build/extensions/web/virtual-background)。 #### 问题修复 [#问题修复-2] 该版本修复了背景左侧出现黑边的问题。 ### v1.1.0 [#v110-1] #### 新增特性 [#新增特性-3] 自 v1.1.0 起,你可以创建多个 `VirtualBackgroundProcessor` 实例,同时处理多路视频流。 ### v1.0.0 [#v100-1] 虚拟背景插件 [agora-extension-virtual-background](https://www.npmjs.com/package/agora-extension-virtual-background) 由 Beta 发布转变为正式发布。 ## 美颜插件 [#美颜插件] ### v1.0.2-beta [#v102-beta] 美颜插件 [agora-extension-beauty-effect](https://www.npmjs.com/package/agora-extension-beauty-effect) v1.0.2 于 2022 年 11 月 26 日发布。这是美颜插件的第一个版本,详细集成步骤可以参考[使用美颜插件](/zh-CN/realtime-media/rtc/build/extensions/web/image-enhancement)。 ## 合图插件 [#合图插件] ### v1.0.0-beta [#v100-beta] 合图插件 [agora-extension-videp-compositor](https://www.npmjs.com/package/agora-extension-video-compositor) v1.0.0-beta 该版本于 2022 年 10 月 25 日发布。这是合图插件的第一个版本,详细集成步骤可以参考[使用合图插件](/zh-CN/realtime-media/rtc/build/extensions/web/video-compositing)。 ## AI 画质插件 [#ai-画质插件] ### v2.0.1 [#v201-1] 该版本对插件的锐化算法进行了优化,提升了部分场景下的视频体验。 ### v2.0.0 [#v200-1] #### 升级必看 [#升级必看-4] 该版本对插件算法进行了优化,新的算法库依赖浏览器具备 SIMD 指令集支持。你可以使用 [WASM SIMD](https://caniuse.com/wasm-simd) 网站提供的测试工具,检测当前浏览器是否支持 SIMD。 #### 改进 [#改进-3] - 插件安装包体积减少约 30%。 - 增加对 WebGL 上下文丢失的恢复机制,提升视频渲染稳定性。 - 优化应用切换至后台时的帧率同步策略,改善操作流畅度。 - 提升在 Safari 浏览器上的兼容性与功能稳定性。 ### v1.0.1 [#v101] AI 画质插件 [agora-extension-super-clarity](https://www.npmjs.com/package/agora-extension-super-clarity) v1.0.1 于 2024 年 11 月 10 日发布,这是 AI 画质插件的第一个版本,详细集成步骤可以参考[使用 AI 画质插件](/zh-CN/realtime-media/rtc/build/extensions/web/super-clarity)。 ## 水印插件 (BETA) [#水印插件-beta] ### v1.0.0-beta [#v100-beta-1] 水印插件 [agora-extension-video-watermark](https://www.npmjs.com/package/agora-extension-video-watermark) v1.0.0-beta 于 2025 年 11 月 25 日发布。这是水印插件的第一个版本,与 Web SDK v4.24.0 及以上搭配使用,可以实现在视频流中添加图像水印的功能。更详细的插件能力和集成步骤可以参考[使用水印插件](/zh-CN/realtime-media/rtc/build/extensions/web/watermark)。