SDK 版本发布日志

[3.1.3] (2024-08-09)

新增

• 新增 getTRTCCloudInstance API 用来获取 TRTCCloud 实例。

优化

• 优化通话中主叫收到对端忙线/拒绝通话时的 TUICallEvent 抛出顺序，由 CALLING_CANCEL -> LINE_BUSY/REJECT 顺序变更为 LINE_BUSY/REJECT -> CALLING_CANCEL。

修复

• 修复邀请通话时，被叫因忙线拒绝没有抛出 LINE_BUSY 事件。
• 修复邀请通话时，其他的被叫超时后，被叫最后挂断时没有抛出 CALLING_END 事件。

[3.1.2] (2024-07-12)

新增

• ON_CALL_RECEIVED、ON_CALL_CANCELED、ON_CALL_BEGIN、CALLING_END 事件增加 strRoomID 的抛出。

[3.1.1] (2024-06-26)

新增

• 新增支持虚拟背景等级设置。

修复

• 修复忙线拒绝时没有修改消息 consumed 字段，从而导致重新登录抛出邀请事件。
• 通话记录上报字符串房间号存在的问题。

[3.1.0] (2024-06-24)

新增

• 新增事件到声明文件中，例如：开始、结束、网络质量等。

修复

• 通话记录上报的房间号异常问题修复。

[3.0.9] (2024-06-14)

新增

• 新增支持传入自定义字符串房间号。

优化

• 扩展 offlinePushInfo 参数，支持离线推送声音设置等功能。
• 默认的视频分辨率由 480p 调整为 1080p。

修复

• 修复被叫接通后，立刻自己超时后通话异常问题。

[3.0.8] (2024-05-27)

新增

• 暴露日志上报接口。

[3.0.7] (2024-05-17)

新增

• 新增网络质量事件抛出。

[3.0.6] (2024-05-06)

新增

• 新增 setBlurBackground 背景虚化接口。
• 新增 setVirtualBackground 图片背景虚化接口。

修复

• 修复消息编辑数据结构，解决和客户端互通时多端登录问题。

[3.0.4] (2024-04-19)

新增

• 新增 TUICallEngine SDK API 英文文档。

优化

• 优化通话记录上报。
• 优化 tuicall-engine-webrtc Readme。

[3.0.3] (2024-03-26)

修复

• 修复 tuicall-engine-webrtc 没有抛出内部权限问题。

[3.0.2] (2024-03-22)

新增

• 新增单独使用 tuicall-engine-webrtc 的上报。

优化

• 优化日志显示的背景色。

修复

• 修复通话中被移除群组后, 挂断失败不上报通话记录的问题。

[3.0.1] (2024-02-23)

新增

• 信令数据增加 inviter 字段，解决和客户端互通时的消息上屏问题。

优化

• 优化日志模块儿，提升日志的清晰度（例如：参数校验给出清晰的提示信息）。
• 优化 setLogLevel 进一步降低日志打印量。

修复

• 修复日志上报中的 version 字段。

[3.0.0] (2024-01-12)

新增

• 底层依赖的 trtc-js-sdk 升级至 trtc-sdk-v5。
• 支持被叫接通前进行本地预览。
• 支持移动端切换前后置。
• 新增进房前本地预览。
• openCamera 增加 isFrontCamera 参数。该参数仅在移动端上有效。
• DEVICED_UPDATED 事件增加了 speakerList、currentSpeaker。
• getDeviceList 增加 speaker 的获取。
• switchDevice 增加 speaker 的切换。
• 新增 switchCamera 接口，支持移动端切换前后置摄像头。

优化

• 优化呼叫邀请逻辑，主叫发送信令时间由原来的 4s 降至 1s，极大提升通话体验。

修复

• 修复 USER_VIDEO_AVAILABLE 抛出状态偶现不对的问题。
• 修复设备插拔后，设备切换不正确的问题。
• 修复移除设备列表中的最后一个设备时，导致的设备切换失败问题。

[2.1.2] (2023-12-29)

新增

• 新增多设备登录模式 enableMultiDeviceAbility 接口的参数及套餐校验。
• 增加对 @tencentcloud/chat 的检测，并给出明确的提示。

优化

• 优化登录逻辑及 sdk_ready 事件的抛出。

修复

• 修复多端登录状态复位不及时，导致的 IM 状态无法清除问题。

[2.1.1] (2023-12-15)

增加

• 增加 开启/关闭 TUICallEngine 的多设备登录模式 enableMultiDeviceAbility 接口。

优化

• 优化通话记录的心跳上报。

[2.1.0] (2023-12-01)

增加

• 增加对 HTTP 的检测并给出明确的提示信息。
• 增加对浏览器的关闭检测及上报。

优化

• 优化通过 userId 过滤时日志缺失的问题。

[2.0.9] (2023-11-17)

优化

• 优化并整理错误码信息，错误码表。

修复

• 修复多端登录下都可以接通的多端登录问题。

[2.0.8] (2023-11-03)

优化

• 优化无摄像头、麦克风设备和设备无权限的提示信息，详见: 错误码。

修复

• 修复邀请他人存在挂断报错问题。
• 修复通话结束后，插拔设备报错问题。

[2.0.7] (2023-10-20)

增加

• 增加呼叫黑名单用户的错误处理。

优化

• 优化通话记录中的心跳上报时机。

[2.0.6] (2023-10-08)

增加

• 增加日志上报，方便问题排查及数据分析。

优化

• 优化呼叫失败提示信息。
• 优化 AI 降噪处理，增加超时处理，减少对接通影响。

[2.0.5] (2023-09-19)

修复

• 修复融合到 TUIKit 中消息上屏解析失败问题。

[2.0.4] (2023-09-15)

优化

• 优化针对不同的 sdkAppId（国内和国际）提示不同的购买信息、链接。

新增

• 新增对邀请信令的修改，解决对端已经取消通话，用户登录后依然收到邀请的问题。

修复

• 修复多端登录时，一端忙线后，另一端挂断抛出错误的事件问题。
• 修复升级 @tencentcloud/chat 后，销毁实例没有清除信令的监听事件问题。
• 修复信令中自定义字段 userData 和客户端不一致的问题。

[2.0.3] (2023-09-04)

修复

• 修复传入的 tim 已登录状态下，不能抛出 SDK_READY 事件的问题。

[2.0.2] (2023-08-31)

修复

• 修复呼叫未登录 TIM 用户的错误码。

[2.0.1] (2023-08-21)

修复

• 修复通话记录上报接口异常时对通话的影响。

[2.0.0] (2023-08-03)

新增

• 将底层依赖 tim-js-sdk 升级到 @tencentcloud/chat，不再支持 tim-js-sdk 创建 tim 实例，如需创建 tim 实例，请使用 @tencentcloud/chat 创建。

[1.6.1] (2024-02-23)

新增

• 信令数据增加 inviter 字段，解决和客户端互通时的消息上屏问题。

[1.5.7] (2023-11-03)

优化

• 优化无摄像头、麦克风设备和设备无权限的提示信息。

修复

• 修复邀请他人存在挂断报错问题。
• 修复通话结束后，插拔设备报错问题。

[1.5.6] (2023-10-20)

增加

• 增加呼叫黑名单用户的错误处理。

优化

• 优化通话记录中的心跳上报时机。

[1.5.5] (2023-10-08)

增加

• 增加日志上报，方便问题排查及数据分析。

优化

• 优化 AI 降噪处理，增加超时处理，减少对接通影响。

[1.5.0] (2023-09-15)

优化

• 优化针对不同的 sdkAppId（国内和国际）提示不同的购买信息、链接。

修复

• 修复多端登录时，一端忙线后，另一端挂断抛出错误的事件问题。

[1.4.10] (2023-09-01)

修复

• 修复 startLocalView 在本地流不存在时引起的日志上报异常。

优化

• 增加邀请信令日志上报。

[1.4.9] (2023-08-18)

优化

• 优化日志上报，方便问题排查。

[1.4.7] (2023-07-14)

修复

• 修复摄像头切换后，关闭再打开时无法采集之前切换的摄像头的问题。

[1.4.6] (2023-07-03)

新增

• 新增 TypeScript 声明文件。
• 新增通话记录上报功能，以支持后续的通话记录查询。
• 新增 onCallBegin、onCallReceived、onCallCanceled 事件。

修复

• 修复 joinGroupCall 后无法挂断的问题。
• 修复 startRemoteView、stopRemoteView 频繁调用导致的远端视频预览问题。

[1.4.5] (2023-06-08)

新增

• 新增 设备权限 文档，介绍设备权限相关问题。
• 新增 能力检测 文档，根据文档介绍，可检测当前浏览器是否支持音视频通话。

优化

• 优化无设备权限时的错误提示。

修复

• 修复无设备权限下，groupCall 报错不一致问题。
• 修复 实现双人通话 里面的错误引导。

[1.4.4] (2023-05-25)

优化

• 优化 API 文档。

修复

• 修复设备权限检查，解决 iOS safari 上出现的黑屏问题。

[1.4.3] (2023-05-17)

修复

• 修复 openCamera 检查设备权限时，导致 iOS Safari 上主叫推送的视频流没有码率的问题。
• 修复 INVITED 未抛出 userData 问题。

[1.4.2] (2023-05-12)

新增

• 新增 call、groupCall 支持自定义数字房间号，数字房间号范围：[1, 2147483647]。
• 新增 call、groupCall 允许用户自定义 userData 数据。

优化

• 优化信令处理逻辑，仅处理 call 的信令。

修复

• 修复 iOS Safari 上主叫推送的视频流没有码率的问题，以避免被叫方看到黑屏。

[1.4.1] (2023-04-27)

优化

• 优化底层依赖版本不一致的问题。

[1.4.0] (2023-04-23)

修复

• 修复视频通话中未设置播放模式会出现无声音问题。
• 修复语音通话时抛出 USER_VIDEO_AVAILABLE 事件问题。
• 修复主叫在视频通话中关闭摄像头后，被叫接通后听不到主叫声音的问题。
• 修复主叫在视频通话中关闭摄像头，被叫接通后主叫打开摄像头，但被叫无法收到 USER_VIDEO_AVAILABLE 事件的问题。

[1.3.9] (2023-04-14)

新增

• 常见问题里，新增 创建 userID 文档。
• 常见问题里，新增 获取 userSig 文档。
• API 文档 中的代码块支持 copy 功能。

优化

• 优化 API 文档 导航栏。

修复

• 修复被叫点击接通的同时主叫挂断，被叫偶现状态错误的问题。
• 修复实例销毁后重新创建的情况下，被呼叫时会收到两次邀请以及 30s 后通话异常结束的问题。

[1.3.7] (2023-03-31)

新增

• 新增对浏览器通话环境的检测，HTTP 协议下，域名非 localhost 和 127.0.0.1 时将会抛错。

优化

• 优化页面不具备 TRTC 能力时的报错信息。
• 优化开通体验套餐的指引信息。

修复

• 修复和 App 语音通话时，App 关闭音频，TUICallEngine 没有抛出 USER_AUDIO_AVAILABLE 事件问题 。

[1.3.6] (2023-03-17)

新增

• 新增 setVideoRendorParams 接口，支持渲染模式设置。

优化

• 优化 setVideoQuality 接口，支持动态设置。
• 优化常见的错误提示, 方便客户快速定位问题原因。

修复

• 修复传入的 tim 已登录状态下，tuiCallEngine.login() 异步未正常结束的问题。
• 修复 tuiCallEngine.destroyInstance() 出现的报错问题。

[1.3.5] (2023-03-02)

新增

• 支持设置企业内网代理。通过 tuiCallEngine.getTrtcClient() 获取 TRTC 的 client 对象，然后设置代理。具体详见 企业内网代理方案。

优化

• 优化 SDK 代码，删除不必要的外部依赖项。
• 优化 API 文档，增加 双人通话教程。

修复

• 修复解散房间、被踢时，logout() 报错问题。
• 修复解散房间、被踢时，SDK 状态未被正确清理的问题。
• 修复主叫、被叫同时挂断时，SDK 的事件抛出和状态清理问题。

[1.3.4] (2023-02-10)

优化

• 优化 SDK 质量上报的性能和可靠性。
• 优化 USER_VIDEO_AVAILABLE 事件的准确度。

修复

• 修复主叫结束通话时未释放麦克风设备导致的问题。
• 修复主叫没有摄像头权限时无法正常进入通话问题。

[1.3.3] (2023-01-13)

优化

• 兼容 TUICallKit 使用 openCamera 方式，建议 TUICallKit 及时更新到最新版本。

修复

• 修复无设备权限下，获取设备列表抛出的 ERROR 事件。

[1.3.2] (2023-01-05)

Breaking Change

• 修改 openCamera 接口，使用时需要传入 videoViewDomID（本地视频将渲染到该 dom id 节点里），升级时需注意。

优化

• 优化主叫呼叫被叫后，在被叫接通前，主叫不上行音视频流。减少被叫接通前，主叫上行音视频流产生的云端录制费用。
• 优化调用 closeCamera 后会释放摄像头设备。startLocalView、stopLocalView 后续逐步废弃，可用 openCamera、closeCamera 实现相同的功能。

[1.3.1] (2022-12-16)

修复

• 修复忙线拒绝和多端登录的一个问题。具体场景：A 呼叫 B/C，D 呼叫 C/E，C 为多端登录。C 抛出 CALLING_CANCEL 事件问题修复。
• 修复多人通话时，未接通者无法收到已接通者挂断的 USER_LEAVE 事件的问题。

[1.3.0] (2022-12-13)

注意

• 建议使用 tsignaling v1.0.3 或更高版本。

新增

• 支持中途加人功能，可以直接加入已存在的群组通话房间。更多细节请参考：中途加人。
• 支持邀请他人功能，可以在群组通话中，直接邀请其他人参与通话。更多细节请参考：邀请他人。

修复

• 兼容 iOS v1.1.0.103 中视频切换为语音时，信令数据结构差异导致的问题。
• 修复通话只剩两个人，其中一个人关闭页面，导致另一个人依然处于通话中的问题。

[1.2.1] (2022-11-23)

新增

• 增加 AI 降噪功能。

修复

• 摄像头损坏时，导致无法正常呼叫问题摄像头损坏时，导致无法正常呼叫问题。
• 主叫和被叫，在音视频切换时，没有抛出 CALL_TYPE_CHANGED 事件问题。
• roomID 超过一定范围导致进房失败问题。

[1.1.3] (2022-11-17)

修复

• 引入新版 tim-js-sdk 存在问题。

[1.1.2] (2022-11-16)

修复

• 解决多端登录时，接通、拒绝处理问题（例如：A 呼叫 B1/B2，B1 接通）。
• 修复特殊 case 下，挂断处理问题（例如：A 呼叫 B(未接通), C 呼叫 A/B/D(D 接通), C 挂断）。
• 修复特殊 case 下，拒绝处理问题（例如：A 呼叫 B，A 切音频，B 拒绝）。
• 修复第二次获取摄像头列表 getDeviceList 返回 undefined。
• 修复处于待接听状态下的被叫，收到音视频切换信令不处理的问题。

优化

• 优化 call/groupCall/accept/hangup/reject 接口，防止重复调用出现异常。

[1.1.1] (2022-11-02)

修复

• 超时问题处理。
• 忙线而拒绝问题的 bugfix。

[1.1.0] (2022-10-28)

优化

• 内部信令，抛出事件优化。
• 抛出事件的数据结构调整, 具体详见。
• 增加 API 异常捕获处理。

修复

• call、groupCall 检查麦克风权限问题修复。

[1.0.4] (2022-10-14)

优化

• 优化依赖项导致包过大, 优化后包大小: 131kb。

[1.0.3] (2022-09-01)

修复

• 修复 CALLING_TIMEOUT 无法被监听的问题。
• 修复 file 协议下无法通讯的问题。

优化

• 优化了报错信息。

[1.0.2] (2022-08-19)

新增

• 新增初始化 init。
• 新增获取登录前 30s 内的通话邀请 (需 Tsignaling 版本 >= v1.0.0)。

优化

• 优化了 logout 处理逻辑。
• 优化了 onInvitationCancelled 处理逻辑。
• 优化了 onInvitationTimeout 处理逻辑。

[1.0.1] (2022-08-09)

新增

• 新增 CALL_TYPE_CHANGED 事件，通话模式发生变化时回调，如：视频切换语音通话时。
• 新增 DEVICED_UPDATED 事件，设备列表发生变化时回调。

优化

• 优化了 H5 上多次授权的问题。

修复

• ios 插拔耳机导致无声的问题。