Tutorial: SDK 版本发布日志

SDK 版本发布日志

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

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

注意:

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

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。
  • 更好的稳定性。
  • 更好的性能表现。