Tutorial: SDK 版本发布日志

SDK 版本发布日志

版本号major.minor.patch具体规则如下：

  • major：主版本号，如有重大版本重构则该字段递增，通常各主版本间接口不兼容。
  • minor：次版本号，各次版本号间接口保持兼容，如有接口新增或优化则该字段递增。
  • patch：补丁号，如有功能改善或缺陷修复则该字段递增。

注意：

  • 建议您及时更新至最新版本，以便获得更好的产品稳定性及在线支持。
  • 版本升级注意事项请参见：升级指引。

Version 5.10.1 @2025.05.15

Bug Fixed

  • 修复开启小流/美颜/虚拟背景后，切换摄像头偶现黑屏的问题。
  • 修复与 WebAR SDK 共用时，更新摄像头分辨率失效问题。
  • 修复 iPad Chrome 访问桌面版网站时，无法拉流的问题。
  • 修复使用 receiveWhenViewVisible 参数时，偶现黑屏问题。

Version 5.10.0 @2025.04.17

Breaking Changed

  • 插件产物格式由 iife 转变为 umd，支持了更多接入环境。若您通过 script 标签加载插件，升级时需要注意。
  • npm 包中的 wasm 资源文件统一迁移至 assets 目录，您部署时可以直接部署 assets 目录。

Feature

Improvement

  • 优化软解插件降级策略。
  • 优化 Android H264 检测逻辑。
  • 优化耳返逻辑，耳返播放前处理后的音频。

Bug Fixed

  • 修复复用 WebSocket 时，换 userId 进房出现报错的问题。
  • 修复 PC Chrome 360p 采集时，画幅被裁切问题，需指定参数规避：TRTC.startLocalVideo({ option: { avoidCropping: true }})

Version 5.9.2 @2025.04.10

Improvement

Version 5.9.1 @2025.03.07

Bug Fixed

  • 修复 iOS 中被其他应用播放声音打断后无声的问题。
  • 修复页面切后台后，音频回调频率不均匀的问题。
  • 修复动态更新分辨率可能导致虚拟背景失效的问题。

Version 5.9.0 @2025.02.17

Feature

Improvement

  • 降低秒开耗时，若您需要最佳的秒开体验，请联系技术支持。
  • 优化音量计算逻辑，支持在 http 协议下获取音量。
  • AUTOPLAY_FAILED 事件回调参数新增 resume 方法。

Bug Fixed

  • 修复 iOS 低概率无声问题。
  • 修复 Safari & Firefox 发送 sei 丢消息的问题。
  • 修复特定场景 autoplay failed 事件未触发的问题。
  • 修复 muteRemoteAudio 静音偶现无效的问题。
  • 修复在不支持 h264 的环境下，无法进行纯语音通话的问题。

Version 5.8.6 @2024.12.27

Improvement

  • 优化弱网重连逻辑，提升重连成功率。
  • 优化 setRemoteAudioVolume 接口，支持在拉流之前设置音量。
  • 规避部分荣耀机型拉流无声问题。
  • 规避 iOS 16 & 18 开启水印后，内存泄露导致页面崩溃的问题。

Bug Fixed

  • 修复屏幕分享 + 系统音频时无声问题。
  • 修复 iOS 16 动态更新分辨率后，偶现渲染画面出现拉伸的问题。
  • 修复在 iOS WKWebview 中，偶现 AudioContext 报错的问题。
  • 修复在切换麦克风后，audio-frame 事件的 pcm 空数据的问题。

Version 5.8.5 @2024.12.03

Breaking Changed

  • Debug 插件变为内置插件，无需外部引入。参考：Debug 插件。

Feature

  • 支持从主流推屏幕分享。
  • Debug 插件支持 Dump 音视频能力。
  • CDNStreaming 插件支持混流回推。

Improvement

  • 提升音量回调的准确性和兼容性。

Bug Fixed

  • 修复偶现分享系统音频后，上行无声的问题。
  • 修复 Android X5 内核加载 SDK 报错的问题。
  • 修复在 iOS 16 使用 WebAR SDK 的兼容性问题。
  • 修复特定场景下频繁进退房出现无声问题。
  • 修复跨房连麦时，mute/unmute 画面渲染异常问题。
  • 修复开启虚拟背景时，切换前后台导致渲染卡顿问题。

Version 5.8.3 @2024.10.25

Feature

  • 新增 AUDIO_FRAME 事件，可获取麦克风原始 PCM 数据。

Improvement

  • 提升 Safari 中视频渲染性能
  • 支持在用户未点击页面的情况下，获取麦克风音量

Bug Fixed

  • 修复采集设备时可能采集到非指定设备的问题。
  • 修复 CDNStreaming 插件在未填写 roomId 时可能出现混流异常的问题。

Version 5.8.2 @2024.10.11

Improvement

  • 降低进房耗时。
  • 提升虚拟背景插件的稳定性。

Bug Fixed

  • 修复在采集系统音频情况下，关闭屏幕分享会导致上行无声的问题。
  • 修复特定场景下跨房连麦插件无法重新启动的问题。
  • 修复偶现自定义消息丢失的问题。

Version 5.8.1 @2024.09.12

Feature

  • 支持在 Safari 和 Firefox 中收发 SEI 消息。
  • 新增 VirtualBackground.isSupported 方法检测环境是否支持使用虚拟背景插件。

Improvement

  • 优化类型声明文件。
  • 提升虚拟背景插件兼容性（Firefox 和 Safari）。

Bug Fixed

  • 修复偶现自定义消息丢失的问题。
  • 修复 Firefox 中偶现观看视频黑屏的问题。
  • 修复 Safari 中推视频流最高只有 15fps 的问题。
  • 修复 Safari 16 中移除摄像头 view 会导致推流停止的问题。

Version 5.8.0 @2024.08.23

Feature

Bug Fixed

  • 修复开启 SEI 时偶现推流失败的问题。
  • 修复 Firefox 屏幕分享分辨率与预期不符的问题。

Version 5.7.1 @2024.08.07

Bug Fixed

  • 修复 iOS 17 中视频渲染异常的问题。
  • 修复 unifiedProxy 失效的问题。

Version 5.7.0 @2024.07.19

Feature

Improvement

  • 使用 captureElement 参数采集屏幕分享时，预览框只显示当前页面。
  • 规避 Android Webview 插拔耳机可能导致无声的问题，chrome issue。
  • 提升 Android 设备 h264 支持度检测的准确性。

Bug Fixed

  • 修复在支持 h264 解码，但不支持 h264 编码的环境中，远端视频黑屏的问题。

Version 5.6.3 @2024.06.28

Feature

  • 混音插件支持监听播放进度回调。
  • 虚拟背景插件支持设置虚化程度。

Improvement

  • 提升 iOS 音频自动播放的成功率。
  • 提升 iOS 通话打断后，恢复正常通话的成功率。

Bug Fixed

  • 修复 Chrome 91 以下版本偶现重连的问题。
  • 修复 mute/unmute audio 后，音频播放出现延迟的问题。
  • 修复特定场景下，误抛远端推屏幕分享事件的问题。

Version 5.6.2 @2024.06.07

Improvement

  • 优化观众拉流通话体验，减少卡顿。
  • 提升断网重连成功率。

Bug Fixed

  • 修复移动端偶现自动播放失败后，无法恢复播放的问题。
  • 修复 Mac Safari 采集 1920 * 1280 分辨率失败的问题。
  • 修复偶现拉流无声的问题。
  • 修复特定调用顺序下 muteRemoteAudio 误报 abort error 的问题。

Version 5.6.1 @2024.05.23

Bug Fixed

  • 修复在手动拉音频的场景下，偶现无声的问题。

Version 5.6.0 @2024.05.17

Breaking Changed

Feature

Bug Fixed

  • 修复 Chrome 123 偶现拉流异常的问题。
  • 修复在 iOS 12.0 版本进房失败的问题。
  • 修复编码镜像偶现失效的问题。
  • 修复混流转推 CDN 收不到流的问题。
  • 修复混音插件 loop 不生效的问题。
  • 修复在混用 roomId 和 strRoomId 多次进房后，进房异常的问题。

Version 5.5.2 @2024.04.29

Improvement

  • 优化背景虚化插件资源加载逻辑，可通过自行部署模型文件加快加载速度，参考：开启虚拟背景。
  • 规避 iOS 17 播放视频闪烁的问题，webkit bug。

Bug Fixed

  • 修复 Android qq 浏览器偶现 startLocalVideo 失败的问题。
  • 修复 Chrome 123+ 版本订阅小流时，偶现报错的问题。
  • 修复偶现播放黑屏问题。

Version 5.5.1 @2024.04.12

Improvement

  • 提升弱网重连成功率。
  • 提升设备恢复采集成功率。

Bug Fixed

  • 修复 iOS 15.1 版本播放远端视频没有显示的问题。
  • 修复使用 updateScreenShare 重新推屏幕分享后，从辅流变成主流的问题。
  • 修复 high audio profile 码率不符合预期的问题。
  • 修复水印插件传入 base64 无法渲染的问题。

Version 5.5.0 @2024.03.29

Improvement

  • 优化移动端 AI 降噪插件的兼容性。
  • 提升设备异常自动恢复采集的成功率。

Bug Fixed

  • 修复 iOS 16 中偶现本地视频播放黑屏的问题。
  • 修复 iOS 14 偶现无声的问题。
  • 修复 startLocalAudio 偶现报错问题。

Version 5.4.3 @2024.03.15

Feature

Bug Fixed

  • 修复偶现 setRemoteAudioVolume 0 不生效的问题。
  • 修复 updateScreenShare({ publish: true }) 后，屏幕分享音频没有推流的问题。
  • 修复 Safari 中无法开启虚拟背景的问题。

Version 5.4.2 @2024.03.01

Bug Fixed

  • 修复偶现 startRemoteVideo 失败的问题。
  • 修复偶现取消推流失败的问题。
  • 修复部分低端机型出现音画不同步的问题。
  • 修复 Nginx 代理无法进房的问题。

Version 5.4.1 @2024.02.05

Improvement

  • 优化重连逻辑，提升弱网重连成功率。

Bug Fixed

  • 修复 updateLocalVideo 导致 mirror 失效的问题。
  • 修复 CONNECTION_STATE_CHANGED 事件没有 CONNECTING 状态的问题。

Version 5.4.0 @2024.01.16

Feature

Improvement

  • 优化进房逻辑，降低进房耗时。
  • 优化笔记本合盖重新打开时的重连逻辑。

Bug Fixed

  • 修复 Chrome 69 以下版本偶现推流失败的问题。
  • 修复 iOS 13 & 14 1080P 推流黑屏问题。

Version 5.3.2 @2023.12.22

Feature

Improvement

  • 优化背景虚化插件性能，减少 CPU 占用。
  • 优化音视频编码稳定性，提升编码质量。

Bug Fixed

  • 修复 CDNStreaming 插件的已知问题。
  • 修复 setRemoteAudioVolume 0 后，音量事件返回的音量值为 0 的问题。
  • 修复部分外接麦克风开启降噪偶现丢音的问题。

Version 5.3.1 @2023.12.08

Bug Fixed

  • 修复混音插件异常问题。
  • 修复 Chrome 74 以下版本无法进房问题。
  • 修复开启 AI 降噪时，部分音频接口表现不符合预期的问题。
  • 修复多 trtc 实例场景下，销毁其中一个实例，其他实例收不到 DEVICE_CHANGED 事件的问题。

Version 5.3.0 @2023.12.01

Feature

  • 支持 SEI 消息收发，可用于实现歌词同步、直播答题等功能，参考 sendSEIMessage。
  • 支持动态开关大小流，参考 updateLocalVideo 的 option.small 参数。
  • 支持静音推流，参考 startLocalAudio() 的 mute 参数。
  • 支持切换角色时更新 privateMapKey，参考 switchRole 的 privateMapKey 参数。
  • 新增 TRTC.EVENT.TRACK 事件。

Improvement

  • 优化进房流程，缩短进房耗时。
  • 优化高分辨率通话场景、低版本 Android Chrome 设备的编码质量。
  • 优化获取设备逻辑，在无媒体访问权限的情况下，SDK 可能会暂时请求获取媒体权限，以保证能正常获取到媒体设备，随后会释放媒体设备。
  • 优化混音插件的 url 参数的解析逻辑。
  • 提升 AI 降噪插件的降噪效果。

Bug Fixed

  • 修复 Android Chrome 无法编码 120p 的问题。
  • 修复屏幕分享不推流场景下，停止屏幕分享会导致摄像头推流停止的问题。
  • 修复 CDN 混流插件参数失效问题。

Version 5.2.1 @2023.11.08

Feature

Bug Fixed

Version 5.2.0 @2023.10.30

Feature

Improvement

  • 提升设备采集成功率。
  • 优化“画中画模式”的镜像处理逻辑。
  • 当用户系统拒绝浏览器授权时，可调用 RtcError.handler() 跳转至系统授权设置，引导用户快速打开授权。参考错误码：5302。

Bug Fixed

  • 修复低版本 Chrome 偶现拉流无声问题。

Version 5.1.3 @2023.09.11

Feature

Improvement

  • 规避 iOS 15.1 切换摄像头导致页面崩溃的 iOS bug。

Bug Fixed

  • 修复 Firefox 取消推流后再重新推流失效的问题。
  • 修复 Firefox 采集特定分辨率视频失败的问题，例如：640 * 360。
  • 修复偶现远端视频未播放的问题。

Version 5.1.2 @2023.08.25

Improvement

  • 降低进房耗时。

Bug Fixed

  • 修复 webpack 打包构建 trtc.esm.js 偶现报错的问题。
  • 修复 startLocalAudio 传入自定义采集 audioTrack 不生效的问题。

Version 5.1.1 @2023.08.18

Improvement

  • 默认 video profile 变更为 480p_2，在保障画质的情况下，降低上行带宽消耗。
  • 规避 Android Chrome 115 低于 360p 分辨率偶现无法编码的 Chrome Bug。

Bug Fixed

  • 修复 Chrome 57、iOS 12 无法进房推拉流的问题。
  • 修复仪表盘视频码率异常问题。

Version 5.1.0 @2023.08.11

Breaking Change

  • 限制 trtc.enterRoom 接口的 roomId 参数为 number 类型，不再支持传入 string 类型。若要使用字符串房间号，请使用 strRoomId 参数。升级时需注意，详情参考：升级指引。

Feature

Bug Fixed

  • 修复设置屏幕分享采集分辨率不生效的问题。
  • 修复偶现播放远端屏幕分享失败的问题。

Version 5.0.3 @2023.07.31

Improvement

  • 优化重连机制，提升网络连接稳定性。

Bug Fixed

  • 修复 trtc.stopRemoteVideo 停止播放主流时，辅流也被停止播放的问题。

Version 5.0.2 @2023.07.21

Improvement

  • 优化多人音视频场景下的性能表现及弱网抗性。
  • 优化设备采集逻辑，规避部分联想设备无法开启摄像头的问题。
  • 优化屏幕分享采集参数，规避长时间屏幕分享偶现采集掉帧的问题。

Bug Fixed

  • 修复小流码率设置不生效的问题。
  • 修复 systemAudio 参数不生效的问题。
  • 修复偶现远端用户关闭屏幕分享后，video 标签未销毁的问题。

Version 5.0.1 @2023.06.25

Feature

  • 支持同时在多个位置播放视频

Bug Fixed

  • 修复点击浏览器悬浮窗口关闭屏幕分享后，无法重新开启屏幕分享的问题。

Version 5.0.0 @2023.05.26

TRTC Web SDK 新架构版本，提供扁平化的接口，大幅简化 API，降低接入成本。新 API 的特点：

  • 更易于接入的扁平化 API。
  • 更好的稳定性。
  • 更好的性能表现。