zyt/admin/CALL_UIKIT_UPGRADE_GUIDE.md

TUICallKit 升级指南

版本升级

从 2.5.2 升级到 4.0.12

升级步骤

1. 删除旧的依赖

cd admin
rm -rf node_modules
rm package-lock.json

2. 安装新版本

npm install

或者直接更新单个包：

npm install @tencentcloud/call-uikit-vue@4.0.12

可能的破坏性变更

从 2.x 升级到 4.x 可能存在 API 变更，需要检查以下文件：

需要检查的文件

1. admin/src/components/video-call/index.vue - 视频通话组件
2. admin/src/main.ts - TUICallKit 初始化代码

常见变更点

1. 导入方式

// 旧版本 (2.x)
import { TUICallKit } from '@tencentcloud/call-uikit-vue'

// 新版本 (4.x) - 可能保持不变或有调整
import { TUICallKit } from '@tencentcloud/call-uikit-vue'

2. 初始化方法

检查 TUICallKit.init() 的参数是否有变化

3. 组件属性

检查组件的 props 是否有变更

4. 事件监听

检查事件名称和回调参数是否有变化

升级后测试清单

• 视频通话功能正常启动
• 音频通话功能正常
• 视频通话功能正常
• 通话邀请功能正常
• 通话接听功能正常
• 通话挂断功能正常
• 摄像头切换功能正常
• 麦克风切换功能正常
• 扬声器切换功能正常

参考文档

• TUICallKit 官方文档
• TUICallKit GitHub
• TUICallKit NPM

回滚方案

如果升级后出现问题，可以回滚到旧版本：

npm install @tencentcloud/call-uikit-vue@2.5.2

注意事项

1. 升级前建议备份当前代码
2. 在开发环境充分测试后再部署到生产环境
3. 查看官方 CHANGELOG 了解详细变更
4. 如遇到问题，查看官方文档或 GitHub Issues np