86 lines
1.9 KiB
Markdown
86 lines
1.9 KiB
Markdown
# 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 |