PuppyIP 资源中心
开发接入 6 分钟 发布于 2026-11-14

RealtimeKit 网页降噪接入:麦克风控制与实例清理

RealtimeKit 降噪在支持的网页浏览器中,于音频发往会议前处理背景噪声;集成重点是先初始化 meeting,并按实例生命周期管理降噪器。

Cloudflare RealtimeKit 网页降噪 麦克风管理 JavaScript

服务对象与地域限制

PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。

代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。

本文要点

  • 2026 年 11 月 12 日的公告介绍了网页降噪包;支持范围包括 React、Angular、JavaScript 与指定浏览器,不包括 RealtimeKit 原生 iOS、Android SDK。
  • 先初始化 meeting,再为每个 meeting instance 创建一个降噪器;将异步初始化与 join 或界面启动分开。
  • autoManage 默认开启,随可用麦克风自动处理;关闭后要自行启停和清理,enable() 需要麦克风处于活动且未静音状态。
  • enabled 为 false 时有多种可能;仅在处理活动时调用 getStatus()。异步 promise 错误与 onError 各自处理,dispose() 不会停止麦克风轨道或关闭 AudioContext。

先确认网页支持范围,再安排初始化顺序

Cloudflare 于 2026 年 11 月 12 日宣布,RealtimeKit 网页应用可以使用 @cloudflare/realtimekit-noise-cancellation 在参与者设备上、音频发送到会议前过滤背景噪声。网页接入适用于 React、Angular 和 JavaScript 应用中的 Chrome、Edge、Firefox、Safari,也包括移动浏览器;RealtimeKit 的 iOS、Android 原生 SDK 目前不支持这项能力。

下一步是通过项目使用的包管理器安装该包,先完成 RealtimeKit meeting 初始化,再调用 RealtimeKitNoiseCancellation.init({ meeting })。每个 meeting instance 只创建一个降噪器。降噪初始化应与 join() 和界面启动分开,避免处理加载拖住参会;若使用 UI Kit,先把 meeting 绑定到 meeting element。公告没有说明套餐或费用、逐账号资格、地域开放状态或各设备性能基准;这些条件仍需单独确认。

默认自动管理会跟随麦克风状态,但不会替用户开麦

autoManage 默认为 true。降噪器会在麦克风可用时启动处理,并跟随静音、取消静音和重连状态继续管理。如果初始化时麦克风已静音,处理会等到用户取消静音后才开始;它不会自动取消麦克风静音。

读取 enabled 可以判断当前处理是否开启,但 false 也可能表示尚未开始、已关闭或实例已经 dispose。只有在降噪处理确实活动、enabled 为 true 时才调用 getStatus();不要把 false 当成唯一故障信号,也不要在处理未启动时读取状态元数据。

关闭自动管理时,由应用明确负责启停与清理

设置 autoManage: false 后,初始化只创建实例,不会自动开始处理,也不会注册离会时的自动清理。等麦克风处于活动且未静音状态后再调用 enable()。调用 disable() 可暂时停止降噪并恢复麦克风原先的处理设置;需要继续过滤时,再按可用麦克风状态调用 enable()。

应用应在离会、切换 meeting 或组件卸载时调用 dispose()。也可以把 AbortController 的 signal 传给 init(),并在应用或组件 teardown 时 abort;即使 autoManage 为 false,abort 也会 dispose 该实例。请单独管理麦克风轨道和 RealtimeKit AudioContext:dispose() 不会停止麦克风轨道,也不会关闭这个 AudioContext。

把 promise 错误与自动运行时错误分别处理

init() 以及显式调用的 enable()、disable()、dispose() 都返回 Promise。应用应为这些调用处理 rejection,例如在各自调用链上添加 .catch(...);可选的 onError 用于接收运行时和自动生命周期错误,不能代替 promise 错误处理。若初始化失败,先按对应 rejection 记录和处理,不要假定 onError 一定会覆盖显式调用失败。

在 autoManage: true 下,参与者离会时降噪器会自动 dispose;临时断线不会 dispose。切换到另一个已连接 meeting 时,旧 meeting 的实例会被 dispose,新 meeting object 需要重新初始化一个降噪器。若使用 autoManage: false,应用负责启用和清理,并应明确自己的离会、断线恢复和 meeting 切换流程如何处理实例;不要把“临时断线”误当作“离会”。

按实际设备验证,并正确理解文档日期

Noise Cancellation 文档页标注的最后更新时间为 2026 年 11 月 10 日,功能公告日期则是 11 月 12 日。前者是文档页面的更新时间,不是逐账户开放或地区 rollout 的时间证据。

准备接入时,可先在目标网页应用中核对 meeting 初始化时机、麦克风静音/取消静音与重连路径,再为离会、切换会议和组件卸载验证释放逻辑,并按需要记录 getStatus()。本文依据 Cloudflare 公告和文档整理,没有实际安装该包、加入会议、采集麦克风音频、检查账户资格或运行设备基准测试;这些步骤须在自己的授权测试环境中完成。

资料来源

常见问题

在参与者设备上过滤,是否表示音频不会发送到会议?

不能这样推断。文档说明过滤发生在设备端、音频发送到会议之前;这描述的是处理位置和顺序,不等于音频从不发送,也没有说明传输、保存或其他隐私与留存规则。应继续遵循适用的产品说明与组织要求。

支持移动浏览器,是否代表它与桌面设备有相同性能?

不代表。浏览器列表确认网页应用支持范围,但这些页面没有提供逐设备基准或一致性能承诺;RealtimeKit 原生 iOS 和 Android SDK 也尚不支持。应在目标浏览器和设备上自行验证。