说明：
1. 新版本（≥ 4.1.0）涉及包名调整接口废弃，同时不再支持 call、groupCall 接口，仅支持 calls 接口。包名调整如下：
说明 | 新包名 | 旧包名 |
Web Vue3 TUICallKit 组件 | @trtc/calls-uikit-vue | @tencentcloud/call-uikit-vue |
Web Vue2.7 TUICallKit 组件 | @trtc/calls-uikit-vue2 | @tencentcloud/call-uikit-vue2 |
Web Vue2.6 TUICallKit 组件 | @trtc/calls-uikit-vue2.6 | @tencentcloud/call-uikit-vue2.6 |
Web React TUICallKit 组件 | @trtc/calls-uikit-react | @tencentcloud/call-uikit-react |
对于需要升级到 calls 接口的用户，请您注意版本灰度，使用 calls 接口呼叫，如果对方的版本未升级，会导致通话失败。
2. TUICallKit Vue3 GitHub 版本地址：Github TUICallKit Web。
@tencentcloud/call-uikit-react 发布日志从 Version 3.3.0 开始查看。
Version 4.2.2 @2025.10.10
优化
和 Chat 融合时，去掉使用旧接口 call、groupCall 的逻辑。
Version 4.2.1 @2025.09.29
优化
依赖的 tui-core 升级到 tui-core-lite。
Version 4.1.0 @2025.09.19
Breaking Change
CallKit 包名由 @tencentcloud/call-uikit-vue 调整为 @trtc/calls-uikit-vue。
依赖由 @tencentcloud/chat 升级为 @tencentcloud/lite-chat。
不再支持原来的 call/groupCall 接口。
Version 4.0.9 @2025.09.01
修复
修复设置昵称或头像接口导致 IM 用户自定义信息被修改的异常问题。
修复被叫端点击接听的同时主叫端挂断，存在的 UI 异常问题。
Version 4.0.8 @2025.07.14
修复
修复 IM 重新连接（OnConnectSuccess），未收到有效的通话邀请问题。
修复调用 CallEngine 的 destroyInstance，执行异常问题。
处理多次调用登录，会导致被叫端调用 Reject 拒绝通话问题。
Version 4.0.7 @2025.06.06
新增
支持 REST API 结束通话。
邀请他人时，将通话中的用户通过 inviteeList 通知给被叫。
增加对通过 REST API 销毁房间的处理。
增加 calls 网络中断恢复后的兼容性处理。
优化
优化和 chat tuikit 融合时的中途加入 join 功能。
优化端上长时间连续心跳失败（断网/超时）结束通话逻辑。
优化异常中断（关闭浏览器/刷新浏览器/小程序左滑/右上角退出）等操作，立刻结束通话。
优化被叫 reject 接口逻辑，移除退房操作。
优化排障日志，增加在线日志。
优化 callkit 事件监听，将监听 USER_ACCEPT 调整为 ON_CALL_BEGIN。
中途加入，默认关闭摄像头。
多人通话下，主叫默认大屏。
修复
修复中途加入未更新 groupId 问题。
修复通话记录上报 groupId 缺失问题。
修复记录在中途加入和邀请他人场景下，参与通话成员不准确问题。
修复主动加入通话时，异常回调 onUserLeave 问题。
Version 4.0.4 @2025.03.31
新增
新增 onCallNotConnected 事件。
新增 onUserInviting 事件。
新增 chatGroupID 字段在 ON_CALL_RECEIVED、CALLING_END、ON_CALL_BEGIN 事件。
增加在线排障日志。
优化
优化多端登录问题。
优化通过 trtc REST API 解散房间的逻辑。
优化本地日志打印。
修复
修复日志上报问题（字段缺失导致 Kibana 没有记录）。
修复 setSelfInfo 接口无效问题。
修复 calls 能力位校验码异常问题。
修复被叫都忙线时，主叫呼叫被叫未抛出 onCallCanceled 事件问题。
移除 trtc 退房抛出的 userLeave 事件。
Version 4.0.3 @2025.03.13
修复
当所有的被叫都忙线时，engine 没有抛出 cancel 事件时，callkit 根据远端用户列表结束通话。
Version 4.0.2 @2025.02.18
新增
新增 calls 接口，支持发起单人通话或多人通话，更加灵活的通话成员管理，支持更强大的 REST API，欢迎使用。
新增 join 接口，配合 calls 接口、支持加入已有通话。
Version 3.3.9 @2024.10.21
优化
切换语言后能够动态改变组件文案。
修复
修复关闭摄像头重置前后置摄像头问题。
修复中途邀请他人 inviteUser 报错时，通话界面消失问题。
Version 3.3.8 @2024.09.27
新增
React 新增主题切换功能。
优化
React 优化设备列表挂载的父元素。
Version 3.3.7 @2024.09.13
修复
修复首次通话中关闭扬声器，下次通话扬声器仍处于关闭状态的问题。
Version 3.3.6 @2024.09.13
新增
React 增加 CallMessage 组件，用于和 chat 融合上屏消息展示。
优化
优化上屏消息展示逻辑，对齐微信消息上屏。
Version 3.3.4 @2024.09.10
新增
React 新增 onMinimized 回调事件。
优化
React 支持悬浮窗拖动。
优化移动端点击扬声器按钮交互，调整为开启/关闭扬声器。
优化 React 设备列表层级。
Version 3.3.3 @2024.08.06
新增
新增开启/关闭扬声器功能。
优化
React：优化按钮 loading 效果。
优化铃声实例的创建、销毁时机。
优化关闭摄像头后，翻转摄像头和虚拟背景按钮的交互。
优化用户未 init 时，直接调用 call/groupCall API 时的报错内容。
优化用户未 init 时，在页面引入 TUICallKit 组件，控制台的 setVideoResolution 警告现象。
修复
React：修复开虚拟背景按钮间距。
React：修复昵称没有截断问题。
Version 3.3.2 @2024.07.12
新增
新增支持邀请他人按钮显示和隐藏。
网络状态较差时的提示。
修复
设备选择后重新拨打，设备选择列表选中设备与当前设备不符。
设备列表为空时，不显示设备选择列表。
修复中途加入的已知问题。
Version 3.3.1 @2024.06.25
修复
修复中途加入功能的一些问题。
删除 debug 文件的注释。
Version 3.3.0 @2024.06.14
新增
新增支持自定义大小窗显示和设置摄像头初始状态功能。
Vue&React：新增支持传入自定义字符串房间号。
React：新增 React TUICallKit 虚拟背景功能。
优化
扩展 offlinePushInfo 参数，支持离线推送声音设置等功能。
修复
修复被叫接通后，立刻自己超时后通话异常问题。
修复群通话被叫等待接听页面远端用户昵称显示问题。
优化
UI 定制化接口增加日志上报。
Version 3.2.9 @2024.05.29
优化
UI 定制化接口增加日志上报。
Version 3.2.8 @2024.05.27
修复
修复 SDK 引入 ref 路径错误问题。
Version 3.2.7 @2024.05.17
新增
新增中途加入 UI 组件。
新增自定义 UI 接口，支持设置通话背景和按钮隐藏。
调整发起通话时的参数校验，支持字符串房间号。
Version 3.2.4 @2024.05.06
新增
视频通话支持背景虚化。
修复
修复 uni-app 打包 web 项目，image 加载 icon 失败问题。
修复群通话切换摄像头按钮问题。
优化按钮点击后，应用卡住，再次点击按钮引起的异常问题。
Version 3.2.3 @2024.04.19
新增
新增群通话支持前后置摄像头切换。
优化
Version 3.2.2 @2024.03.25
新增
新增全新的 UI 视效，功能更清晰，体验更好。
优化
优化使用 TUICallKit 的数据上报。
新增
language 日志上报。
Version 3.2.1 @2024.03.08
新增
language 日志上报。
Version 3.2.0 @2024.02.23
新增
增加默认的离线推送参数。
修复
修复群组通话没有昵称问题。
Version 3.1.9 @2024.01.30
修复
修复群组通话没有展示用户信息问题。
修复选人组件在没有可选成员时，“确认”按钮仍然可点击的问题。
修复通话中关闭麦克风，再次通话不上行音频流问题（升级 trtc-cloud-js-sdk 到 v2.2.7+）。
Version 3.1.8 @2024.01.19
修复
修复选人组件样式对页面的影响。
Version 3.1.7 @2024.01.12
修复
增加接口的重试机制，修复播放时因找不到 dom 节点导致播放失败问题。
修复 PC 上设备列表选择样式问题。
Version 3.1.6 @2023.12.29
优化
优化群组通话下的提示信息。
优化昵称过长时的显示问题。
修复
修复语音通话请求摄像头权限问题。
修复 destroyed 存在的问题。
修复不同呼叫场景下悬浮窗里的挂断问题。
修复主叫呼叫状态下显示远端问题。
修复 PC 上填充不全的样式问题。
Version 3.1.5 @2023.12.15
新增
优化获取设备权限的时机，初始化时不再获取设备权限，使用 call 时才获取。
修复
Version 3.1.4 @2023.12.01
新增
融合到 Chat 中增加 isFromChat 上报。
修复
修复按钮 loading 下可点击的问题。
Version 3.1.3 @2023.11.17
新增
接口增加参数校验。
Version 3.1.2 @2023.11.03
新增
新增邀请他人 inviteUser 功能。
新增中途加人 joinInGroupCall 功能。
新增被叫来电铃声静音接口 enableMuteMode功能。
修复
修复远端流麦克风状态展示不对问题。
Version 3.1.0 @2023.10.20
新增
增加悬浮窗功能。
增加 enableFloatWindow 接口，用于开启/关闭悬浮窗功能。
桌面端支持摄像头、麦克风切换设备。
增加呼叫黑名单用户失败提示信息。
增加对日语的支持。
优化
视频通话下，大屏默认显示远端用户。
Version 3.0.8 @2023.10.10
新增
增加版本号、框架等信息上报。
Version 3.0.7 @2023.10.08
新增
增加桌面端视频通话下，通话时长展示。
优化
优化桌面端上视频流预览圆角黑边问题。
优化远端流用户信息显示优先级：备注 > 昵称 > userId。
优化 TUICallKit 组件包体积（删除无用图片及代码）。
Version 3.0.6 @2023.09.19
修复
修复融合到 TUIKit 中的消息上屏问题。
Version 3.0.5 @2023.09.15
优化
优化 TUICallKit 之间的相互引用，避免在 uniapp 打包小程序出现的栈溢出问题。
新增
新增桌面端设备无权限时的提示，引导客户如何对设备进行授权。
修复
修复 setCallingBell 被叫铃声被主叫铃声覆盖，导致铃声重复问题。
修复移动端上的样式问题。
Version 3.0.4 @2023.09.01
修复
修复 setCallingBell 作用对象为来电铃声（被叫铃声）。
修复 destroyed 报错问题。
修复错误弹框提示没有中英文。
修复 1v1 通话关闭摄像头后, 无法切换大小屏。
Version 3.0.3 @2023.8.25
新增
优化
优化组件默认语言，调整为系统默认的语言。
优化打印的日志信息。
优化 tuicall-engine-webrtc 抛出错误的信息提示。
优化组件销毁后，对所用资源的清理。
修复
修复 videoDisplayMode、videoResolution 挂断后再次呼叫时，未生效问题。
修复通话中，statusChanged 未抛出问题。
修复 init 多次调用问题。
修复通话中，关闭摄像头无法切换大小屏问题。
Version 3.0.2 @2023.8.14
修复
修复 H5 端被叫组件的样式问题。
修复切换小窗后，再次通话出现的样式问题。
Version 3.0.1 @2023.8.8
修复
修复群通话主叫方本地预览失败的问题，修改组件层对数据层默认读取方式。
Version 3.0.0 @2023.8.4
Breaking Change
升级底层依赖 tuicall-engine-webrtc 至 ^2.0.0，不再支持 tim-js-sdk 创建 tim 实例，如需创建 tim 实例，请使用 @tencentcloud/chat 创建。
新增
Version 2.4.2 @2023.11.03
新增
新增邀请他人 inviteUser 功能。
新增中途加人 joinInGroupCall 功能。
新增被叫来电铃声静音接口 enableMuteMode功能。
修复
修复远端流麦克风状态展示不对问题。
Version 2.4.0 @2023.10.20
新增
增加悬浮窗功能。
增加 enableFloatWindow 接口，用于开启/关闭悬浮窗功能。
桌面端支持摄像头、麦克风切换设备。
增加呼叫黑名单用户失败提示信息。
增加对日语的支持。
优化
视频通话下，大屏默认显示远端用户。
Version 2.3.9 @2023.10.10
新增
增加版本号、框架等信息上报。
Version 2.3.8 @2023.10.08
新增
增加桌面端视频通话下，通话时长展示。
优化
优化桌面端上视频流预览圆角黑边问题。
优化远端流用户信息显示优先级：备注 > 昵称 > userId。
优化 TUICallKit 组件包体积（删除无用图片及代码）。
Version 2.3.6 @2023.09.15
优化
优化 TUICallKit 之间的相互引用，避免在 uniapp 打包小程序出现的栈溢出问题。
新增
新增桌面端设备无权限时的提示，引导客户如何对设备进行授权。
修复
修复 setCallingBell 被叫铃声被主叫铃声覆盖，导致铃声重复问题。
修复移动端上的样式问题。
Version 2.3.5 @2023.9.5
修复
修复进房前摄像头、麦克风按钮默认打开的问题。
Version 2.3.4 @2023.9.1
新增
新增视频通话接听前可以关闭或者开启摄像头功能。
修复
修复 1v1 通话关闭摄像头后, 无法切换大小屏问题。
修复从视频通话切换到语音通话 statusChanged 未抛出问题。
Version 2.3.3 @2023.8.22
修复
修复 videoDisplayMode、videoResolution 挂断后再次呼叫时，未生效问题。
修复通话中，statusChanged 未抛出问题。
Version 2.3.2 @2023.7.26
Breaking Change
移除悬浮窗 TUICallKitMini 组件，合并到 TUICallKit 组件中。
抛出的 @kicked-out 事件调整为绑定回调
:kickedOut 的方式。抛出的 @status-changed 事件调整为绑定回调
:statusChanged 的方式。新增
新增通话页面出现时的动画效果。
新增 H5 上群组通话布局。
优化
优化通话中的问题提示信息、提示方式。
优化在 H5 页面的支持、交互。
优化通话界面唤起的时间。
优化 @tencentcloud/call-uikit-vue 包目录结构。
修复
修复接通后立刻挂断等边界操作下的通话问题。
修复 H5 在部分机型、浏览器上的样式问题。
修复重复点击引起的通话异常问题。
Version 2.2.1 @2023.7.7
新增
修复
修复来电页面重复点击“接听”按钮导致接听失败。
Version 2.2.0 @2023.6.30
新增
call、groupCall 支持自定义数字房间号 roomID 参数。
call、groupCall 支持自定义扩展字段 userData 参数（用于在邀请信令中增加扩展信息）。
新增 setSelfInfo 接口，支持用户设置昵称和头像。
Version 2.1.0 @2023.4.14
新增
在 H5 模式语音通话下，呼叫时支持显示对方昵称。
发起通话失败时，会在呼叫页面显示“发起通话失败”。
接听通话失败时，会在来电页面显示“接听失败”。
支持监听当前用户是否被踢出（如被挤出登录），详见 TUICallKit 方法 - @kicked-out。
支持监听 TUICallKit 通话状态，详见 TUICallKit 方法 - @status-changed。
支持业务侧代码控制通话的接听、取消和挂断，详见 更多特性 - 通过接口设置自动接听。
Vue2 版本新增 TypeScript 类型声明文件，在 TypeScript 项目中可以正常编译类型。
修复
修复在初始化组件时，控制台出现的更新个人资料接口的警告。
修复在 H5 模式下，被叫接听按钮出现背景图片错位的问题。
接口变更
Version 2.0.1 @2023.03.31
新增
优化 1v1 通话与多人通话视频的渲染逻辑，提升性能与稳定性。
优化 UI 展示，支持在
TUICallKitServer.call() 执行过程中显示对应 UI，即可以实现点击通话按钮立刻展示 <TUICallKit/> UI 组件。修复
修复多人通话中昵称显示错误的问题。
修复 CSS 未限制生效范围导致污染全局样式的问题。
Version 2.0.0 @2023.03.21
新增
支持从 npm 引入已打包的 CallKit 文件。
支持 JavaScript 版本的 Vue 项目。
支持 Vue2 所有版本的 Vue 项目，适用于 Vue2 的 npm 包：call-uikit-vue2。
修复
修复无摄像头设备或权限导致通话发起异常的问题。
Version 1.4.2 @2023.03.03
新增
支持设置通话分辨率，详见 API 文档。
支持修改画面显示模式，详见 API 文档。
优化了接入步骤。
优化了错误抛出。
Version 1.4.1 @2023.02.13
新增
优化了本地摄像头的预览逻辑。
优化了远端视频流的渲染逻辑。
Version 1.4.0 @2023.01.06
新增
支持 Vue2.7+ 项目引入。
通话界面默认显示昵称，设置昵称请参考 TIM#updateMyProfile。
Version 1.3.3 @2022.12.27
新增
在 Basic Demo 中拨打电话时，新增了通话列表的空值检测。
在拨打电话时，Basic demo 中增加了 loading 图标。
优化了 Basic Demo 中设备检测的逻辑，手动跳过后不再主动弹出。
优化了组件图标的引用方式。
修改了默认的包管理工具为 npm。
优化了视频的渲染方式，减少了重复渲染的次数。
修复
修复了由于 vue-CLI 过时依赖导致的 Basic Demo 报错。
Version 1.3.2 @2022.12.07
新增
支持语言切换，接口详情可见 setLanguage。
优化 Basic Demo 设备检测逻辑，手动跳过后不会再主动弹出。
修复
修复引入
defineProps 导致的警告。Version 1.3.1 @2022.11.29
注意：
新增
优化样式细节。
支持未接听对方通话时，监听对方修改通话类型。
Basic Demo 增加设备检测功能。
修复
修复在挂断电话时内部逻辑导致的报错。
Version 1.3.0 @2022.11.14
新增
支持手机 H5 使用时，自动切换为竖屏样式。
支持在拨打电话时预览本地摄像头。
Basic Demo 增加拨打电话前的设备检测。
修复
修复调用 TUICallKitServer.destroyed() 之后 tim 实例未完全退出的问题。
修复对方忙线时显示无应答的问题。
修复 vite 环境下 TypeScript 类型未成功打包的问题。
接口变更
主动调用 TUICallKitServer.call() 或 TUICallKitServer.groupCall() 时，如果遇到报错，不会再调用 beforeCalling 回调。请直接使用 try catch 捕获错误。
Version 1.2.0 @2022.11.03
新增
适配新版本 TUICallEngine SDK。
Version 1.1.0 @2022.10.21
新增
通话过程中，通话页面可以全屏。
通话过程中，可以使用
<TUICallKitMini/> 进行最小化。修复
修复已知问题，提升稳定性。
Version 1.0.3 @2022.10.14
新增
Basic Demo 增加快捷复制 UserID、一键打开新窗口。
Version 1.0.2 @2022.09.30
新增
优化接入文档，增加演示图片和详细指引。
修复
修复首次进入房间时，设备状态位失效的问题。
修复在 webpack 工具打包时，图标偶现加载失败的问题。
修复已知样式问题。
Version 1.0.1 @2022.09.26
新增
在拨打电话时，隐藏对方麦克风图标。
修复
修复 Basic Demo SDKAppID 输入框应为数字的问题。
