Docs Overview/
Web(Vue)/

Web(Vue)

说明：
TUICallKit Vue3 Github 版本地址：Github TUICallKit Web。

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

新增

新增群通话支持前后置摄像头切换。

优化

优化 TUICallKit SDK Readme。

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 时才获取。

修复

修复 @tencentcloud/call-uikit-vue2、@tencentcloud/call-uikit-vue2.6 组件没有声明文件问题。

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

新增

新增 @tencentcloud/call-uikit-vue2.6 适配 Vue2.6 版本。

优化

优化组件默认语言，调整为系统默认的语言。
优化打印的日志信息。
优化 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 创建。

新增

新增自定义铃声功能 setCallingBell。

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

新增

@tencentcloud/call-uikit-vue2 新增 Vue 版本的检测及提示。

修复

修复来电页面重复点击“接听”按钮导致接听失败。

Version 2.2.0 @2023.6.30

新增

call、groupCall 支持自定义数字房间号 roomID 参数。
call、groupCall 支持自定义扩展字段 userData 参数（用于在邀请信令中增加扩展信息）。
新增 setSelfInfo 接口，支持用户设置昵称和头像。

Version 2.1.0 @2023.4.14

新增

在 H5 模式语音通话下，呼叫时支持显示对方昵称。
发起通话失败时，会在呼叫页面显示“发起通话失败”。
接听通话失败时，会在来电页面显示“接听失败”。
支持监听当前用户是否被踢出（如被挤出登录）。
支持监听 TUICallKit 通话状态。
支持业务侧代码控制通话的接听、取消和挂断。
Vue2 版本新增 TypeScript 类型声明文件，在 TypeScript 项目中可以正常编译类型。

修复

修复在初始化组件时，控制台出现的更新个人资料接口的警告。
修复在 H5 模式下，被叫接听按钮出现背景图片错位的问题。

接口变更

TUICallKitServer.destroy() 增加调用限制，仅支持在未通话状态时调用。

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

注意：
本版本依赖 SDK tuicall-engine-webrtc@1.2.1 版本，请及时更新。

新增

优化样式细节。
支持未接听对方通话时，监听对方修改通话类型。
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 输入框应为数字的问题。

Version 1.0.0 @2022.09.23

TUICallKit demo 快速跑通
TUICallKit 快速接入
TUICallKit API
TUICallKit 界面定制指引
TUICallKit (Web) 常见问题