以下 SDK 版本存在接口变更或 Breaking Change，升级时需要注意。
从 4.x 升级到 5.x
TRTC Web SDK 5.x 版本是 Web 端全新升级版，提供扁平化接口、大幅简化 API、降低您的接入成本；在多人音视频场景下，具有更好的性能表现及弱网抗性。
注意：5.x 版本的接口与 4.x 版本的接口不兼容，因此您无法从 4.x 版本平滑升级到 5.x 版本。
下面是 4.x 与 5.x 功能教程，升级时需要注意各个教程的实现差异：
基础教程
| 4.x 实现教程 | 5.x 实现教程 |
|---|---|
| 实现基础音视频通话 | 实现基础音视频通话 |
| 实现互动连麦直播 | 实现互动连麦直播 |
| 切换摄像头和麦克风 | 切换摄像头和麦克风 |
| 设置本地视频属性 | 设置本地视频属性 |
| 动态开关摄像头、麦克风 | 动态开关摄像头、麦克风 |
| 实现屏幕分享 | 实现屏幕分享 |
| 音量大小检测 | 音量大小检测 |
进阶教程
| 4.x 实现教程 | 5.x 实现教程 |
|---|---|
| 自定义采集与自定义播放渲染 | 自定义采集与自定义播放渲染 |
| 背景音乐和音效实现方案 | 背景音乐和音效实现方案 |
| 通话前环境与设备检测 | 通话前环境与设备检测 |
| 检测网络质量 | 检测网络质量 |
| 检测设备插拔行为 | 检测设备插拔行为 |
| 开启大小流 | 开启大小流 |
| 开启水印 | 开启水印 |
| 开启 AI 降噪 | 开启 AI 降噪 |
| 实现云端混流 实现推流到 CDN |
云端混流与转推 CDN |
| 实现 3D 空间音频 | 排期开发中，敬请期待 |
| 实现变声 | 排期开发中，敬请期待 |
最佳实践
| 4.x 实现教程 | 5.x 实现教程 |
|---|---|
| 自动播放受限处理建议 | 自动播放受限处理建议 |
| 应对防火墙受限 | 应对防火墙受限 |
Version 5.1.0 @2023.08.11
【背景】
- TRTC 数字类型和字符串类型房间号不互通。
- 在 v5.1.0 之前的版本，trtc.enterRoom 接口的 roomId 参数支持传入 number 和 string 两种类型。很容易出现因房间号类型不同，导致多端无法互通的情况。例如：TRTC Web 端使用了字符串类型 roomId "123"，而 TRTC Android 使用了数字类型的 roomId 123。
【变更】
为防止出现上述情况，自 v5.1.0 版本开始，限制 trtc.enterRoom 接口的 roomId 参数为 number 类型，不再支持传入 string 类型。若要使用字符串房间号，请使用 strRoomId 参数。