发版说明

  • Web

更新时间

查看实时互动 RTC 的版本更新、问题修复、行为变更和兼容性说明,评估升级影响。

Web SDK 4.x 是通过 HTML 网页加载的 JavaScript 和 TypeScript 库。你可以使用 SDK 在网页浏览器中调用 API 建立连接,控制音视频通话和直播服务。

信息

本文仅适用于声网 Web SDK 4.x。这是基于 Web SDK 3.x 的全量重构版本,不向下兼容。声网已经停止维护 Web SDK 3.x 版本。建议你选择合适的时机,参考迁移指南从 3.x 及以下版本升级至 4.x 版本。

已知问题和兼容性

浏览器兼容性说明

为保证最佳的用户体验,声网强烈推荐使用桌面端 Google Chrome 浏览器官方最新版本。详见 Web SDK 的浏览器兼容性。

Chrome 弃用和删除 Plan B 语义

根据 Google 官方说明,Chrome 浏览器计划弃用和删除 WebRTC 中的 Plan B 语义。该改动影响声网 Web SDK 如下版本的使用和体验。如你使用下述版本的 Web SDK,请尽快升级至最新版本。

Web SDK 版本影响范围
2.5.0-2.9.0 和 3.0.0-3.6.1在调用 publish 方法后再调用 switchDevice 方法,出现视频卡顿或无声问题。
4.0.0-4.0.1publish 和 subscribe 方法不生效。
表格内容超出当前宽度,可横向滚动查看更多列。

该版本于 2026 年 11 月 16 日发布。

新增特性

Multiopus 多声道音频

支持 4、6、8 声道音频的发送和接收,满足多声道音频传输及处理需求。应用可通过以下配置和接口使用该功能:

  • 将 createClient 的 multiopus 配置设置为 true,启用 Multiopus。
  • 通过 createCustomAudioTrack 的 channelCount 配置指定自定义音轨的声道数。
  • 调用本地及远端音轨的 selectChannels 方法,选择需要使用的声道。
  • 调用本地及远端音轨的 getVolumeLevels 方法,查询各声道的音量。

注意

Multiopus 支持 Chrome 94 及以上版本,不支持 Firefox 和 Safari。

改进

优化部分场景下的进频道流程,减少入会等待时间。

问题修复

修复部分场景下调用 leave() 后延迟退出频道的问题。

API 变更

新增

  • ClientConfig.multiopus。
  • CustomAudioTrackInitConfig.channelCount。
  • AudioRenderMode。
  • ILocalAudioTrack 和 IRemoteAudioTrack 的 selectChannels、getVolumeLevels 方法。