## Web SDK 4.68.1 该版本于 2026 年 1 月 20 日发布。 ### 新增功能支持 Alpha 通道视频渲染（仅 Linux 端为发送端时支持）。 ## Web SDK 4.68.0 该版本于 2025 年 12 月 5 日发布。 ### 新增功能 1. Web SDK 支持在 Electron 环境下运行使用。 2. Web SDK 在 macOS 环境下新增支持 360 极速浏览器。 ## Web SDK 4.67.2 该版本于 2025 年 8 月 7 日发布。 ### 新增功能 [AI 语音降噪](/docs/6348/148647)新增支持浏览器 Firefox 80+、Safari 14.1+。 ## Web SDK 4.67.1 该版本于 2025 年 7 月 25 日发布。 ### 新增功能 1. **支持获取本地、远端或 WTN 视频播放器的可见性状态** |接口 |说明 | |---|---| |[getLocalVideoPlayerVisibility](/docs/6348/104478#rtcengine-getlocalvideoplayervisibility) |获取本地视频播放器的可见性状态和不可见原因。 | |[getRemotePlayerVisibility](/docs/6348/104478#rtcengine-getremoteplayervisibility) |获取远端视频播放器的可见性状态和不可见原因。 | |[getWTNVideoPlayerVisibility](/docs/6348/104478#wtnstream-getwtnvideoplayervisibility) |获取 WTN 视频播放器的可见性状态和不可见原因。 | |[onPlayerVisibility](/docs/6348/104479#engineevents-onplayervisibility) |播放器可见性变化事件，每 30 秒触发一次。 | 2. **支持媒体流异常事件回调** |接口 |说明 | |---|---| |[onLocalStatsException](/docs/6348/104479#engineevents-onlocalstatsexception) |SDK 监测到本地流异常事件回调，通常是由于网络或采集/播放设备等外部因素导致。异常事件不是错误，但是一般会引起通话质量问题。发生异常事件后，如果恢复正常，也会收到该回调。 | |[onRemoteStatsException](/docs/6348/104479#engineevents-onremotestatsexception) |SDK 监测到远端流异常事件回调，通常是由于网络或采集/播放设备等外部因素导致。异常事件不是错误，但是一般会引起通话质量问题。发生异常事件后，如果恢复正常，也会收到该回调。 | |[onWTNLocalStatsException](/docs/6348/104479#wtnstreamevents-onwtnlocalstatsexception) |本地 WTN 媒体流异常事件回调。 | |[onWTNRemoteStatsException](/docs/6348/104479#wtnstreamevents-onwtnlocalstatsexception) |远端 WTN 媒体流异常事件回调。 | 3. **支持发布 H.265 格式视频** 通过 [setVideoEncoderConfig](/docs/6348/104478#rtcengine-setvideoencoderconfig) 设置视频流的发布参数时，支持指定视频编码格式为 H.264、VP8、H.265。SDK 会自适应解码，无需手动操作。 :::warning Warning H.265 使用对浏览器和分辨率有限制，具体查看 [Web SDK 浏览器兼容性和已知问题](/docs/6348/2120886#h265)。 ::: ## Web SDK 4.66 该版本于 2025 年 3 月 11 日发布。 ### 新增功能 1. **支持仅创建 RTS 房间** 通过 [joinRoom](/docs/6348/104478#joinroom) 创建房间时，可通过 [RoomConfig](/docs/6348/104481#roomconfig) 新增的字段 `roomMode?: RoomMode`，来设置房间的创建模式： * `ROOM_MODE_RTC` = `0`（默认）：房间内可同时使用 RTC 和 RTS 功能。 * `ROOM_MODE_RTS_ONLY` = `1`：房间内仅可使用 RTS 功能，仅可使用 RTS 相关接口，不可使用 RTC 相关功能（例如 `publishStream`、`subscribeStream`等）。 2. **获取房间的通话 ID** 新增方法 [getCallId](/docs/6348/104478#getcallid)：加入房间后，可调用该方法获取房间的通话 ID，标识该房间的通话。 3. **SEI 功能支持浏览器 Firefox 117+ 、Safari 15.4+** 调用 [sendSEIMessage](/docs/6348/104478#sendseimessage) 发送 SEI 数据时，除 Chromium 86+ 外，新增支持在 Firefox 117+ 和 Safari 15.4+ 使用。 ## Web SDK 4.65 该版本于 2024 年 12 月 23 日发布。 ### 新增功能 1. **AI 语音降噪功能新增选项** * 在使用 AI 语音降噪功能前，可以通过 `isSupported` 接口，判断当前浏览器是否支持使用 AI 语音降噪插件。 * AI 语音降噪等级可以通过 `setAnsMode(ansMode: AnsMode)` 进行设置。 * 此外，采用自定义音频采集时，你可以通过 `streamIndex` 和 `sourceType`，在调用 `enable` 开启 AI 降噪时指定音频流。默认对应的音频流为 SDK 采集到的麦克风音频流。 2. **同时传入多个云代理服务器地址** 通过 [startCloudProxy](/docs/6348/104478#rtcengine-startcloudproxy) 设置云代理时，支持通过数组，同时传入多个云代理服务器地址。 3. **不进房收发媒体流（WTN 流）** 客户端用户无需进房即可通过 `startPushWtn` 发布无房间流。同一 AppId 下的其他用户无需进房，即可通过 `streamId` 订阅该流。和 `startPushPublicStream` 相比，新增的 `startPushWtn` 不要求发布用户进房。如果用户不需要在 RTC 房间内进行音视频互动，推荐使用该接口。 |API |说明 | |---|---| |[getWTNStreamManager](/docs/6348/104478#rtcengine-getwtnstreammanager) |WTN 流接口创建。 | |[startPushWtn](/docs/6348/104479#engineevents-ontokenpublishprivilegewillexpire) |将本地音视频发布为一路 WTN 流，用户无需进房。 | |[stopPushWTN](/docs/6348/104478#wtnstream-stoppushwtn) |停止发布 WTN 流。 | |[muteWTNLocalVideo](/docs/6348/104478#wtnstream-mutewtnlocalvideo) |暂停/继续发布指定 WTN 流的视频。 | |[muteWTNLocalAudio](/docs/6348/104478#wtnstream-mutewtnlocalaudio) |暂停/继续发布指定 WTN 流的音频。 | |[onWTNPushStateChanged](/docs/6348/104479#wtnstreamevents-onwtnpushstatechanged) |WTN 流发布结果回调。 | |[sendWTNSEIMessage](/docs/6348/104478#wtnstream-sendwtnseimessage) |通过 WTN 流视频帧发送 SEI 数据。 | |[onWTNSEIMessageReceived](/docs/6348/104479#wtnstreamevents-onwtnseimessagereceived) |回调 WTN 流中包含的 SEI 信息。 | 订阅端可以通过以下新增回调，获取流状态和媒体统计信息。会在调用 [startPlayWTN](/docs/6348/104478#wtnstream-startplaywtn) 订阅 WTN 流后触发。 |API |说明 | |---|---| |[onWTNPlayStateChanged](/docs/6348/104479#wtnstreamevents-onwtnplaystatechanged) |订阅 WTN 流后，结果通过此回调通知用户。 | |[onWTNRemoteAudioStateChanged](/docs/6348/104479#wtnstreamevents-onwtnremoteaudiostatechanged) |订阅 WTN 流后，音频订阅状态通过此回调通知用户。 | |[onWTNRemoteVideoStateChanged](/docs/6348/104479#wtnstreamevents-onwtnremotevideostatechanged) |订阅 WTN 流后，视频订阅状态通过此回调通知用户。 | |[onWTNRemoteVideoStats](/docs/6348/104479#wtnstreamevents-onwtnremotevideostats) |订阅 WTN 流，后将触发此回调，周期为 2s，包含视频统计信息。 | |[onWTNRemoteAudioStats](/docs/6348/104479#wtnstreamevents-onwtnremoteaudiostats) |订阅 WTN 流，后将触发此回调，周期为 2s，包含音频统计信息。 | 此外，本版本的 WTN 流的订阅相关接口发生不兼容变更，详见下方的**不兼容变更**小节。 ### 不兼容变更从此前版本升级到 V4.65 时，如果你的项目使用了 WTN 流（原公共流）功能，你需要参考以下说明，对项目进行适配。更新后，播放 WTN 流相关方法和回调将由 [IWTNStream](/docs/6348/104478#wtnstream) 接口统一管理。你需要通过 [getWTNStreamManager](/docs/6348/104478#rtcengine-getwtnstreammanager) 方法获取 IWTNStream 的实例。 |变更前 |变更后 |详情 | |---|---|---| |`startPlayPublicStream` |[startPlayWTN: (token: string \\| null, streamId: string, videoMute: boolean, audioMute: boolean) => Promise;](/docs/6348/104478#wtnstream-startplaywtn) |订阅指定 WTN 流。变更后的方法增加了 `token`、`videoMute`、`audioMute` 三个必填参数。 | |`stopPlayPublicStream` |[stopPlayWTN](/docs/6348/104478#wtnstream-stopplaywtn) |取消订阅指定 WTN 流。 | |`setPublicStreamVideoPlayer` |[setWTNRemoteVideoPlayer](/docs/6348/104478#wtnstream-setwtnremotevideoplayer) |为指定 WTN 流设置使用的视图和渲染模式。 | |`setPublicStreamVolume` |[setWTNRemoteAudioPlaybackVolume](/docs/6348/104478#wtnstream-setwtnremoteaudioplaybackvolume) |调节本地播放的 WTN 流播放音量。 | |`onPublicStreamStats` |[onWTNRemoteVideoStats](/docs/6348/104479#wtnstreamevents-onwtnremotevideostats)、[onWTNRemoteAudioStats](/docs/6348/104479#wtnstreamevents-onwtnremoteaudiostats) |本地播放的 WTN 流的各项统计信息。 | |`onFirstPublicStreamAudioFrameDecoded` |无 |本地播放的 WTN 音频首帧解码成功。你可以通过 [onWTNRemoteAudioStateChanged](/docs/6348/104479#wtnstreamevents-onwtnremoteaudiostatechanged) 监听 WTN 流在本地的播放状态。 | |`onFirstPublicStreamVideoFrameDecoded` |[onWTNFirstRemoteVideoFrameDecoded](/docs/6348/104479#wtnstreamevents-onwtnfirstremotevideoframedecoded) |本地播放的 WTN 视频首帧解码成功。 | |`onFirstPublicStreamVideoFrameRendered` |无 |本地播放的 WTN 音频首帧渲染成功。你可以通过 [onWTNRemoteVideoStateChanged](/docs/6348/104479#wtnstreamevents-onwtnremotevideostatechanged) 监听 WTN 流在本地的播放状态。 | ## Web SDK 4.63.2 该版本于 2024 年 12 月 19 日发布。修复了美颜插件相关的一些已知问题。 ## Web SDK 4.63 该版本于 2024 年 10 月 24 日发布。 ### 新增功能 1. **耳返** 在音乐类互动，比如在线 KTV、合唱等场景中，主播可能需要收听耳返音频。自 V4.63 你可以通过 [setEarMonitorMode](/docs/6348/104478#rtcengine-setearmonitormode) 开启耳返。耳返音量可以通过 [setEarMonitorVolume](/docs/6348/104478#rtcengine-setearmonitorvolume) 随时进行调节。 2. **屏幕共享** 自 V4.63 开始，Web SDK 在 Electron 框架中使用时，也支持屏幕共享功能了。你可以通过 [getElectronScreenSources](/docs/6348/104478#vertc-getelectronscreensources) 获取屏幕共享源，包括屏幕和应用窗口的 `sourceId`、名称和缩略图，然后在调用 [startScreenCapture](/docs/6348/104478#rtcengine-startscreencapture) 时，传入 `sourceId`，指定屏幕共享源。如果不传入 `sourceId`，将弹出默认弹窗供用户选择屏幕共享源。 3. **视频流信息统计** 你可以通过 [onRemoteStreamStats](/docs/6348/104479#engineevents-onremotestreamstats) 回调的 [RemoteStreamStats.RemoteVideoStats.codecType](/docs/6348/104481#remotevideostats-codectype) 参数，感知远端视频编码类型。 4. **实时消息** 优化了[发送消息接口](/docs/6348/104477#消息)的体验。当发送频率超出限制时，会自动丢弃消息，并返回错误码 `USER_MESSAGE_EXCEED_QPS`。 ### 功能优化 Web SDK 支持在 HarmonyOS Next 系统的华为浏览器上正常运行。具体功能支持情况和已知问题参见 [Web SDK 浏览器兼容性和已知问题](/docs/6348/2120886)。 ### 升级必看发布端视频流回退规则变更，将按照传入的 Simulcast 流依次回退，不再按照 SDK 预设档位的分辨流进行回退。以发送端设置了 1080P(大)、360P(中)、180P(小)为例。 * 之前的版本中，回退路径是 1080P(大) \-\> 720P(大) \-\> 630P(大) \-\> 540P(大) \-\> 450P(大) \-\> 360P(中) \-\> 270P(中) \-\> 180P(小) \-\> 144P(小)。 * 当前版本中，回退路径是 1080P(大) \-\> 360P(中) \-\> 180P(小)。此外，发布和订阅 Simulcast 流的方法变更参见下表。 > 旧接口在本版本已废弃，虽然可以正常使用，但我们不会再对其进行维护，建议尽快按照下表迁移到新接口。 |变更详情 |变更前方法 |变更后方法 |说明 | |---|---|---|---| |API 替换 |`enableSimulcastMode`|[setLocalSimulcastMode](/docs/6348/104478#rtcengine-setlocalsimulcastmode)|开启 Simulcast 发布功能。|\ | |开启后会发布所有已设置的 Simulcast 流。 |将 `mode` 参数设置为 `VIDEO_ALWAYS_SIMULCAST`=`2` 时会发布所有已设置的 Simulcast 流。 |新增了按需订阅模式，只发布订阅端已经指定的 Simulcast 流。 | |API 行为变更 |`setVideoEncoderConfig` |[setLocalSimulcastMode](/docs/6348/104478#rtcengine-setlocalsimulcastmode) |通过 `setLocalSimulcastMode` 指定和更新 Simulcast 流的编码参数。`setVideoEncoderConfig` 只能用于指定和更新大流的编码参数。 | |API 替换 |`setRemoteVideoConfig` |[setRemoteSimulcastStreamType](/docs/6348/104478#rtcengine-setremotesimulcaststreamtype) |设置 Simulcast 流订阅偏好。不再需要指定具体数值，你可以通过传入枚举值指定订阅偏好。 | ## Web SDK 4.62.1 该版本于 2024 年 9 月 13 日发布。修复了一些已知问题。 ## Web SDK 4.62.0 该版本于 2024 年 8 月 28 日发布。 ### 新增功能 1. 除了通过周期回调 [onLocalStreamStats](/docs/6348/104479#engineevents-onlocalstreamstats) 或 [onRemoteStreamStats](/docs/6348/104479#engineevents-onremotestreamstats) 获取媒体流的统计信息以及网络状况，自 V4.62 你也可以通过以下方法随时获取媒体流信息。 * [getRemoteVideoStats](/docs/6348/104478#rtcengine-getremotevideostats) * [getRemoteAudioStats](/docs/6348/104478#rtcengine-getremoteaudiostats) * [getLocalVideoStats](/docs/6348/104478#rtcengine-getlocalvideostats) * [getLocalAudioStats](/docs/6348/104478#rtcengine-getlocalaudiostats) 2. 你可能需要获取音频帧 PCM 数据，完成例如，本地音频录制、音频审核等功能。自 V4.62 你可以通过 [IRTCEngine.setAudioFrameCallback](/docs/6348/104478#rtcengine-setaudioframecallback)，开启和指定用于接收本地和远端的音频帧数据的回调。通过 [IAudioMixingManager.setAudioFrameCallback](/docs/6348/104478#audiomixingmanager-setaudioframecallback) 开启和指定用于接收混音后的音频帧数据的回调。 3. 在娱乐、教学和医疗等场景中，你可能需要镜像显示远端视频流。自 V4.62 你可以通过 [setRemoteVideoMirrorType](/docs/6348/104478#rtcengine-setremotevideomirrortype) 指定视频流的镜像模式。设置成功后，指定模式会在已经绑定或后续绑定的播放器生效，即在调用 [setRemoteVideoPlayer](/docs/6348/104478#rtcengine-setremotevideoplayer) 之前或之后都可以进行镜像模式设置。 ## Web SDK 4.61.3 该版本于 2024 年 8 月 19 日发布。 ### 问题修复修复了断网状态下取消订阅不生效等 3 个已知问题。 ## Web SDK 4.61.1 该版本于 2024 年 7 月 15 日发布。 Google 计划在 8 月中旬发布 Chrome 128，其中包含了一项破坏性变更。该变更将导致 2024 年 7 月 15 日之前发布的 RTC Web SDK 发布和订阅失败，严重影响 SDK 正常使用。本版本的 SDK 修复了此问题。为确保您的应用在新版本的 Chrome 浏览器中继续稳定运行，我们强烈建议您升级到本版本或更新版本。 ## Web SDK 4.61 该版本于 2024 年 7 月 3 日发布。 ### 升级必看从 4.61 版本开始，即使开启镜像模式，通过 [takeLocalSnapshot](/docs/6348/104478#rtcengine-takelocalsnapshot) 和 [takeRemoteSnapshot](/docs/6348/104478#rtcengine-takeremotesnapshot) 截图时也不会应用镜像模式。如果你需要镜像后的截图，需要自行实现图片镜像处理逻辑。 ### 新增功能 1. 为了更好地满足国际化会议、跨国在线课程等的多语种需求，自 V4.61 你可以在已开启实时字幕的通话中切换源语种，参见 [updateSubtitleConfig](/docs/6348/104478#rtcengine-updatesubtitleconfig) 方法。此外，你可以同时在调用 [startSubtitle](/docs/6348/104478#startsubtitle) 开启字幕翻译时，同时指定多个目标语种。并通过 [onSubtitleMessageReceived](/docs/6348/104479#onsubtitlemessagereceived) 回调获取语种字幕。 2. 你可以在不取消订阅的情况下，停止媒体播放，以便后续更快速地恢复音视频通话。参见 [stop](/docs/6348/104478#rtcengine-stop)。 3. 除了通过周期回调 [onLocalAudioPropertiesReport](/docs/6348/104479#onlocalaudiopropertiesreport) 或 [onRemoteAudioPropertiesReport](/docs/6348/104479#engineevents-onremoteaudiopropertiesreport) 获取采集音频音量，自 V4.61 你也可以通过 [getAudioVolume](/docs/6348/104478#rtcengine-getaudiovolume) 方法随时获取采集音频音量。 4. 通常在会议场景中，你需要在两个不同的视图中渲染一路音视频流，比如主画面和侧边栏中，自 V4.61 你可以通过多次调用 [setLocalVideoPlayer](/docs/6348/104478#rtcengine-setlocalvideoplayer)、[setRemoteVideoPlayer](/docs/6348/104478#rtcengine-setremotevideoplayer) 或 [setPublicStreamVideoPlayer](/docs/6348/104478#rtcengine-setpublicstreamvideoplayer) 为同一路流设置不同的渲染视图。 5. 为兼容 Chrome 107 和 Edge 107 的屏幕共享新增功能，[startScreenCapture](/docs/6348/104478#rtcengine-startscreencapture) 的 [ScreenConfig](/docs/6348/104481#screenconfig) 参数新增 `displaySurface`、`selfBrowserSurface`、`surfaceSwitching` 和 `systemAudio` 属性。详见 [Chrome 文档](https://developer.chrome.com/docs/web-platform/screen-sharing-controls/)。 6. 你可以通过 [onUserJoined](/docs/6348/104479#engineevents-onuserjoined) 的新增参数 `publishState`，区分远端用户的音、视频发布状态。这个功能可以用于本端用户进房时或远端用户进房时，根据远端用户的音、视频发布状态展示对应的 UI 组件，例如加载闭麦还是开麦图标。 ### 问题修复 1. 修复了 360 安全浏览器 32 位版的兼容性问题。 ## Web SDK 4.60.2 该版本于 2024 年 1 月 17 日发布。 ### 重要变更 * 基础美颜功能的浏览器兼容性变动，同时增加鉴权步骤，你需要在创建美颜插件实例时传入鉴权文件，参看[基础美颜功能](/docs/6348/148646)。 * 虚拟背景功能的浏览器兼容性变动，同时修改了部分枚举类型中的字面量值，参看[虚拟背景](/docs/6348/697417)。 ### 新增功能 [虚拟背景](/docs/6348/697417)功能新增了视频和纯色背景。此外，背景模糊功能支持自定义模糊半径。 ## Web SDK 4.60 该版本于 2024 年 1 月 4 日发布。 ### 新增功能 1. 新增 Token 发布/订阅权限即将过期和过期的回调，用于提示用户及时更新 Token 相关权限，以保证正常的音视频通话。 |API |说明 | |---|---| |[onTokenPublishPrivilegeWillExpire](/docs/6348/104479#engineevents-ontokenpublishprivilegewillexpire) |Token 发布权限过期前 30 秒将触发该回调 | |[onTokenPublishPrivilegeDidExpired](/docs/6348/104479#engineevents-ontokenpublishprivilegedidexpired) |Token 发布权限过期时触发该回调 | |[onTokenSubscribePrivilegeWillExpire](/docs/6348/104479#engineevents-ontokensubscribeprivilegewillexpire) |Token 订阅权限过期前 30 秒将触发该回调 | |[onTokenSubscribePrivilegeDidExpired](/docs/6348/104479#engineevents-ontokensubscribeprivilegedidexpired) |Token 订阅权限过期时触发该回调 | 2. 支持语音通话场景下发送 SEI 信息，调用 [sendSEIMessage](/docs/6348/104478#sendseimessage) 接口后，SDK 内部会生成黑帧视频用于发送 SEI 信息，并通过 [onSEIStreamUpdate](/docs/6348/104479#engineevents-onseistreamupdate) 事件回调远端用户黑帧视频流的发布状态。 ### 功能优化 1. 开启[音频选路](https://console.volcengine.com/rtc/cloudRTC?tab=roomMode&from=doc)后，支持本端发布的音频流不参与音频选路，适用于要求指定用户的发言能一直被收听到的场景，例如设置固定的主持人麦位，具体参看 [setAudioSelectionConfig](/docs/6348/104478#rtcengine-setaudioselectionconfig)。 ## Web SDK 4.58 该版本于 2023 年 11 月 8 日发布。本次发布提升了某些场景下数据报告的准确性并修复了一些已知问题。 ## Web SDK 4.56 该版本于 2023 年 9 月 7 日发布。 ### 新增功能 1. 支持同时开启音视频采集功能。调用该方法时，浏览器会同时请求麦克风和摄像头权限，用户只需授权一次。参看 [startAudioAndVideoCapture](/docs/6348/104478#startaudioandvideocapture)。 2. 支持配置本地主流音量回调模式和本地主流音量回调的数据范围（控制回调中是否包含混音），新增功能可能影响 [onActiveSpeaker](/docs/6348/104479#onactivespeaker) 回调。参看 [enableAudioPropertiesReport](/docs/6348/104478#enableaudiopropertiesreport) 接口中新增参数 [LocalMainReportMode](/docs/6348/104481#localmainreportmode) 和 [AudioReportMode](/docs/6348/104481#audioreportmode)。 3. [onError](/docs/6348/104479#engineevents-onerror) 回调细化房间解散、被踢、封禁等错误码；[joinRoom](/docs/6348/104478#rtcengine-joinroom) 增加用户/房间封禁导致的进房失败回调。 4. 支持设置主流的内容类型 [VideoEncoderConfig.contentHint](/docs/6348/104481#videoencoderconfig-contenthint)，在不同场景下提升视频体验。 5. 在渲染远端视频流时，支持通过 [setRemoteVideoPlayer.videoPlayerOption](/docs/6348/104478#setremotevideoplayer) 设置视频的旋转角度。 ## Web SDK 4.55 该版本于 2023 年 8 月 11 日发布。 ### 新增功能 1. [NetworkQuality](/docs/6348/104481#networkquality) 新增网络连接断开枚举值 `DOWN = 6`，你可以通过 [onNetworkQuality](/docs/6348/104479#engineevents-onnetworkquality) 感知网络断连。 2. [startAudioCapture](/docs/6348/104478#rtcengine-startaudiocapture) 新增返回值 [MediaTrackSettings](https://developer.mozilla.org/en-US/docs/Web/API/MediaTrackSettings)，返回实际生效的音频采集参数。 ## Web SDK 4.54 该版本于 2023 年 7 月 13 日发布。 ### 新增功能 1. 支持跨房间转发媒体流功能。跨房间转发媒体流指将可见用户的媒体流同时转发到多个房间，观众在原来的房间中就能够接收到来自其他房间主播的媒体流。相关接口及示例代码请参看[跨房间转发媒体流](/docs/6348/104398)。 ## Web SDK 4.53 该版本于 2023 年 6 月 15 日发布。 ### 新增功能 1. 支持通过 [onRemoteStreamStats](/docs/6348/104479#onremotestreamstats) 获取 rtt 时间。参看 [RemoteAudioStats](/docs/6348/104481#remoteaudiostats) 和 [RemoteVideoStats](/docs/6348/104481#remotevideostats)。 2. 内部视频渲染支持拉伸模式，视频帧非等比缩放，拉伸至填满视窗区域，参看 [VideoRenderMode.RENDER_MODE_FILL](/docs/6348/104481#videorendermode)。 3. 虚拟背景功能新增 GPU 模式，支持在初始化时选择使用，参看[虚拟背景功能](/docs/6348/697417)。 ## Web SDK 4.52 该版本于 2023 年 5 月 18 日发布。 ### 新增功能 1. 支持调节音频的采集音量和播放音量，具体参看以下接口： |API |说明 | |---|---| |[setCaptureVolume](/docs/6348/104478#setcapturevolume) |调节音频采集音量 | |[setPlaybackVolume](/docs/6348/104478#setplaybackvolume) |调节本地播放的单个远端用户的音量 | |[setPublicStreamVolume](/docs/6348/104478#setpublicstreamvolume) |调节本地播放的公共流播放音量 | 2. 提供虚拟背景插件，你可以通过此插件，将用户人像和背景分离，采用模糊背景或自定义图片作为虚拟背景。该功能需单独付费使用，具体参看[虚拟背景功能](/docs/6348/697417)。 ## Web SDK 4.51 该版本于 2023 年 4 月 13 日发布。 ### 新增功能 1. 支持设置远端音视频流是否同步渲染，参看 [setRemoteStreamRenderSync](/docs/6348/104478#setremotestreamrendersync)。 2. 支持对房间内说话人的语音进行识别和翻译。使用该功能前，你需要[开通机器翻译服务](https://www.volcengine.com/docs/4640/130262)并前往 [RTC 控制台](https://console.volcengine.com/rtc/cloudRTC?tab=subtitle&from=doc)，在功能配置页面开启字幕功能。参看 [startSubtitle](/docs/6348/104478#startsubtitle) 和 [stopSubtitle](/docs/6348/104478#stopsubtitle)。 ## Web SDK 4.49 该版本于 2023 年 2 月 23 日发布。 ### 新增功能 1. 支持设置本地缓存的日志输出等级以及可使用的最大缓存空间，参看 [setLogConfig](/docs/6348/104478#setlogconfig) 和 [downloadLog](/docs/6348/104478#downloadlog)。 ### 功能优化 1. 提升合流转推功能易用性，统一 RTC SDK 与 OpenAPI 的合流转推音视频参数限制范围及默认值，并在 SDK 层面进行参数校验。优化部分合流转推参数不合法时的处理方式，实现自动修正为默认值。参看 [LiveTranscodeConfig](/docs/6348/104481#livetranscodeconfig)。 ## Web SDK 4.47 该版本于 2022 年 12 月 30 日发布。 ### 新增功能 1. 支持在客户端上，对本地/远端的视频流进行截图。参看 [takeLocalSnapshot](/docs/6348/104478#takelocalsnapshot) 和 [takeRemoteSnapshot](/docs/6348/104478#takeremotesnapshot)。 2. 支持获取浏览器的原生接口 [MediaStreamTrack](https://developer.mozilla.org/en-US/docs/Web/API/MediaStreamTrack)，并通过该接口控制音视频，获取媒体信息。 3. 提供基础美颜插件，你可以通过此插件，实现美白、磨皮、锐化等基础美颜功能，参看[基础美颜功能](/docs/6348/148646)。 4. 提供 AI 降噪插件，你可以通过此插件满足不同场景的降噪需求，参看 [AI 降噪功能](/docs/6348/148647)。 ## Web SDK 4.46 该版本于 2022 年 9 月 21 日发布。 ### 新增功能 1. 成功调用 [enableAudioPropertiesReport](/docs/6348/104478#enableaudiopropertiesreport) 后，SDK 会持续监测音量最大的远端用户。当房间内用户数量大于或等于 2 且有活跃用户时，SDK 会触发回调 [onActiveSpeaker](/docs/6348/104479#onactivespeaker) 并周期性报告最活跃用户的信息。 2. 封禁/解禁指定房间内的指定用户的音/视频流时，房间内所有用户都会收到 [onAudioStreamBanned](/docs/6348/104479#onaudiostreambanned)/[onVideoStreamBanned](/docs/6348/104479#onvideostreambanned)的回调。 3. 支持设置共享屏幕时的内容类型参数 [ScreenEncoderConfig.contentHint](/docs/6348/104481#screenencoderconfig)，在不同场景下提升屏幕共享的视频质量。 ### 问题修复 1. 删除了头文件和文档中两个实时消息相关错误码 `USER_MESSAGE_EXCEED_MAX_LENGTH` 和 `USER_MESSAGE_EMPTY_USER`，相应的错误实际是通过 [INVALID_PARAMS](/docs/6348/104480) 抛出，例如， `SDKError('INVALID_PARAMS', 'The message length must be less than 64K')`。 ## Web SDK 4.45 该版本于 2022 年 8 月 31 日发布。 ### 新增功能 1. 支持在调用 [createEngine](/docs/6348/104478#createengine) 时根据业务场景，设置自动播放策略。扩展 [play](/docs/6348/104478#play) 接口能力，当音视频流因自动播放策略设置或自动播放失败不播放时，都可以调用 play 接口开启播放。[onAutoPlayFailed](/docs/6348/104479#onautoplayfailed) 回调增加了对本地媒体流自动播放失败情况的支持，不带 userId 参数时，表示本地媒体流自动播放失败。更多自动播放策略信息，详见 [Web 端自动播放策略](/docs/6348/130302)。 2. 设置共享屏幕的视频编码参数，同时对视频采集生效。若设置的参数浏览器不支持，RTC SDK 按照浏览器支持的参数范围进行采集，并通过回调 [onLocalVideoSizeChanged](/docs/6348/104479#onlocalvideosizechanged) 通知实际参数。 ## Web SDK 4.44 该版本于 2022 年 7 月 29 日发布。 ### 新增功能 1. 支持订阅音视频流回退功能。在弱网情况下，你可以开启订阅的音视频流自动回退策略，保证用户的音视频体验，功能详细介绍和使用信息参看[音视频流回退](/docs/6348/70137)。 2. 新增按需订阅功能，发布端开启大小流模式后，订阅端可以根据需要设置期望订阅的视频编码参数，发布端将会自动匹配一路参数相近的流进行发布，具体参看 API：`setRemoteVideoConfig`。此功能需联系技术支持人员通过配置下发开启 ### 功能优化 1. 细化了转推直播相关事件、错误码和错误码信息。你能根据不同推流事件和错误码及时修改直播间的状态提示。可通过新增接口 [onStreamMixingEvent](/docs/6348/104479#onstreammixingevent) 查看事件类型、错误码和错误码信息。 2. 重新设计媒体流和音视频设备接口，实现了摄像头/麦克风采集的媒体流与屏幕共享媒体流的分离控制，同时支持灵活控制媒体流的发布/取消发布、订阅/取消订阅，具体接口变更参看[升级指南](/docs/6348/125706)。 ## Web SDK 4.43 该版本于 2022 年 7 月 18 日发布。 ### 新增功能 1. 新增音频场景 `RoomProfileType`（已于 v4.51 废弃）和音质选项设置接口 [setAudioProfile](/docs/6348/104478#setaudioprofile)，满足更多不同场景的音视频算法和参数以及网络参数配置需要。 `RoomProfileType` 既可以在客户端设置，也可以通过配置下发。在选定的音频场景 `RoomProfileType` 基础上，调用 `setAudioProfile` 切换音质档位。 ### 问题修复 1. 修复了 Web 端与 Native 端进行 SEI 消息互通时，消息可能解析错误的问题。 ## Web SDK 4.42 该版本于 2022 年 7 月 1 日发布。 ### 新增功能 1. 支持音频采集和播放设备测试功能 |接口 |说明 | |---|---| |[startAudioPlaybackDeviceTest](/docs/6348/104478#startaudioplaybackdevicetest) |开始播放测试 | |[stopAudioPlaybackDeviceTest](/docs/6348/104478#stopaudioplaybackdevicetest) |停止播放测试 | |[startAudioDeviceRecordTest](/docs/6348/104478#startaudiodevicerecordtest) |开启录播测试 | |[stopAudioDeviceRecordAndPlayTest](/docs/6348/104478#stopaudiodevicerecordandplaytest) |停止录制，并开始播放测试语音 | |[stopAudioDevicePlayTest](/docs/6348/104478#stopaudiodeviceplaytest) |停止录播测试 | 2. 支持在本地视频采集暂停时，使用指定的图片填充上行视频流。使用这一功能时，你可以在录制音视频通话时，避免某一用户画面黑帧的情况。参看 [setDummyCaptureImagePath](/docs/6348/104478#setdummycaptureimagepath)。 3. 支持发布视频大小流，并为一路或多路流设置视频编码参数。参看 `enableSimulcastMode` 和 [setVideoEncoderConfig](/docs/6348/104478#setvideoencoderconfig) 。 ### 功能优化 1. 使用 SDK 内部机制进行视频采集时，可以通过返回值获取实际视频采集参数。参看 [startVideoCapture](/docs/6348/104478#startvideocapture)。 ## Web SDK 4.41 该版本于 2022 年 6 月 16 日发布。 ### 新增功能 1. 支持发布和订阅公共流。新增接口如下： |接口 |说明 | |---|---| |[startPushPublicStream](/docs/6348/104478#startpushpublicstream) |发布一路公共流 | |[updatePublicStreamParam](/docs/6348/104478#updatepublicstreamparam) |更新公共流参数 | |[stopPushPublicStream](/docs/6348/104478#stoppushpublicstream) |停止发布公共流 | |[startPlayPublicStream](/docs/6348/104478#startplaypublicstream) |订阅指定公共流 | |[stopPlayPublicStream](/docs/6348/104478#stopplaypublicstream) |取消订阅指定公共流 | |[setPublicStreamVideoPlayer](/docs/6348/104478#setpublicstreamvideoplayer) |为指定公共流设置使用的视图和渲染模式 | |[onPublicStreamStats](/docs/6348/104479#onpublicstreamstats) |用户订阅的公共流统计信息以及网络状况 | |[onPushPublicStreamResult](/docs/6348/104479#onpushpublicstreamresult) |公共流发布结果回调 | |[onPublicStreamSEIMessageReceived](/docs/6348/104479#onpublicstreamseimessagereceived) |回调公共流中包含的 SEI 信息 | |[onFirstPublicStreamVideoFrameDecoded](/docs/6348/104479#onfirstpublicstreamvideoframedecoded) |公共流的视频首帧解码成功 | |[onFirstPublicStreamAudioFrameDecoded](/docs/6348/104479#onfirstpublicstreamaudioframedecoded) |公共流的音频首帧解码成功 | |[onFirstPublicStreamAudioFrameDecoded](/docs/6348/104479#onfirstpublicstreamaudioframedecoded) |公共流的首帧视频渲染成功 | 2. 支持 vp8 编码模式，你可以调用 [getSupportedCodecs](/docs/6348/104478#getsupportedcodecs) 查看当前浏览器是否支持 vp8 编码类型。 3. 支持云代理功能。能够在有防火墙限制的情况下，通过云代理实现正常的音视频通话。参看 [startCloudProxy](/docs/6348/104478#startcloudproxy)。 ## Web SDK 4.40 该版本于 2022 年 6 月 1 日发布。 ### 新增功能 1. 支持收发房间外实时消息。新增接口如下： |接口 |说明 | |---|---| |[login](/docs/6348/104478#login) |发送房间外消息和服务器消息前需要先登录 | |[logout](/docs/6348/104478#logout) |登出 | |[updateLoginToken](/docs/6348/104478#updatelogintoken) |更新登录 Token | |[getPeerOnlineStatus](/docs/6348/104478#getpeeronlinestatus) |查询对端用户或本端用户的登录状态|\ | |已登录的用户才能接收信息，发送消息前先获取状态确保发送成功 | |[sendUserMessageOutsideRoom](/docs/6348/104478#sendusermessageoutsideroom) |向指定用户发送房间外消息 | |[sendUserBinaryMessageOutsideRoom](/docs/6348/104478#senduserbinarymessageoutsideroom) |向指定用户发送房间外二进制消息 | |[setServerParams](/docs/6348/104478#setserverparams) |设置目标服务器地址和签名 | |[sendServerMessage](/docs/6348/104478#sendservermessage) |向服务器发送实时消息 | |[sendServerBinaryMessage](/docs/6348/104478#sendserverbinarymessage) |向服务器发送实时二进制消息 | 2. 转推直播的音频和视频参数增加默认值。调用 startLiveTranscoding 时如果没有传相应参数，RTC 将使用默认参数发起转推直播任务。调用 [defaultTranscoding](/docs/6348/104478#defaulttranscoding) 可获取转推直播的音频和视频参数增加默认值。 ## Web SDK 4.38 该版本于 2022 年 5 月 6 日发布。 ### 性能优化 1. 优化 [isSupported](/docs/6348/104478#issupported) 接口，返回当前浏览器是否支持 Web SDK，详见 [Web SDK 的浏览器兼容性](/docs/6348/2120886)。 2. 增加了房间内发送即时消息的错误码。 ## Web SDK 4.36 该版本于 2022 年 4 月 1 日发布。 4.0 版本是基于 3.0 版本的全量重构版本，不向下兼容。

实时音视频