# TUICallKit 升级指南

## 版本升级

从 `2.5.2` 升级到 `4.0.12`

## 升级步骤

### 1. 删除旧的依赖
```bash
cd admin
rm -rf node_modules
rm package-lock.json
```

### 2. 安装新版本
```bash
npm install
```

或者直接更新单个包：
```bash
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. 导入方式
```typescript
// 旧版本 (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 官方文档](https://www.tencentcloud.com/document/product/647/50993)
- [TUICallKit GitHub](https://github.com/tencentyun/TUICallKit)
- [TUICallKit NPM](https://www.npmjs.com/package/@tencentcloud/call-uikit-vue)

## 回滚方案

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

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

## 注意事项

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