新增功能

2026-03-04 15:32:30 +08:00
parent a07e844c47
commit ab77f5488d
2266 changed files with 177942 additions and 3444 deletions
@@ -0,0 +1,334 @@
+# TUICallKit 升级完成
+
+## ✅ 已完成的更新
+
+### 1. Web 端（admin）
+
+#### 更新的文件
+1. **admin/package.json**
+   - ✅ 更新包名：`@trtc/calls-uikit-vue": "^4.2.2`
+
+2. **admin/src/components/video-call/index.vue**
+   - ✅ 更新导入语句：`TUICallKitServer` → `TUICallKitAPI`
+   - ✅ 更新所有API调用
+
+3. **admin/src/views/test/patient-call.vue**
+   - ✅ 更新导入语句：`TUICallKitServer` → `TUICallKitAPI`
+   - ✅ 更新所有API调用
+
+#### 重要变更
+- **包名变更**：`@tencentcloud/call-uikit-vue` → `@trtc/calls-uikit-vue`
+- **API名称变更**：`TUICallKitServer` → `TUICallKitAPI`
+- **发起通话方法变更**：`call()` → `calls()`，参数从 `userID` 改为 `userIDList`（数组）
+- **版本升级**：4.0.12 → 4.2.2
+
+### 2. 小程序端（wx）
+
+#### 当前状态
+- ✅ 使用本地 TUICallKit 源码
+- ✅ 版本：4.2.7
+- ✅ 无需更新
+
+## 📦 包版本对比
+
+### Web 端
+| 项目 | 旧版本 | 新版本 |
+|------|--------|--------|
+| 包名 | @tencentcloud/call-uikit-vue | @trtc/calls-uikit-vue |
+| 版本 | 4.0.12 | 4.2.2 |
+
+### 小程序端
+| 项目 | 版本 |
+|------|------|
+| 本地源码 | 4.2.7 |
+
+## 🔄 API 兼容性
+
+### API 变更说明
+
+#### 1. API 名称变更
+- `TUICallKitServer` → `TUICallKitAPI`
+
+#### 2. 发起通话方法变更
+- 方法名：`call()` → `calls()`
+- 参数变化：
+  ```typescript
+  // 旧版本
+  TUICallKitServer.call({
+    userID: 'user123',
+    type: TUICallType.VIDEO_CALL
+  })
+  
+  // 新版本
+  TUICallKitAPI.calls({
+    userIDList: ['user123'],  // 改为数组
+    type: TUICallType.VIDEO_CALL
+  })
+  ```
+
+### 完全兼容的 API
+```typescript
+// 初始化
+TUICallKitAPI.init({
+  userID: string,
+  userSig: string,
+  SDKAppID: number
+})
+
+// 发起通话（注意：方法名和参数都有变化）
+TUICallKitAPI.calls({
+  userIDList: string[],  // 改为数组
+  type: TUICallType.VIDEO_CALL | TUICallType.AUDIO_CALL
+})
+
+// 挂断
+TUICallKitAPI.hangup()
+
+// 设置回调
+TUICallKitAPI.setCallback({
+  statusChanged: (params) => void,
+  afterCalling: () => void
+})
+
+// 浮窗设置
+TUICallKitAPI.enableFloatWindow(boolean)
+```
+
+### 状态常量
+```typescript
+STATUS.IDLE                    // 空闲
+STATUS.DIALING_C2C            // 一对一呼叫中
+STATUS.DIALING_GROUP          // 群组呼叫中
+STATUS.CALLING_C2C_VIDEO      // 一对一视频通话中
+STATUS.CALLING_C2C_AUDIO      // 一对一音频通话中
+STATUS.CALLING_GROUP_VIDEO    // 群组视频通话中
+STATUS.CALLING_GROUP_AUDIO    // 群组音频通话中
+```
+
+## 🧪 测试计划
+
+### Web 端测试
+
+#### 测试 1：基本功能
+- [ ] 安装依赖成功
+- [ ] 编译成功
+- [ ] 启动成功
+- [ ] 登录成功
+
+#### 测试 2：通话功能
+- [ ] 可以发起通话
+- [ ] 可以接听通话
+- [ ] 可以挂断通话
+- [ ] 视频显示正常
+- [ ] 音频传输正常
+
+#### 测试 3：状态管理
+- [ ] 状态回调正常
+- [ ] 界面状态同步
+- [ ] 错误处理正常
+
+#### 测试 4：跨平台互通
+- [ ] Web → 小程序通话正常
+- [ ] 小程序 → Web 通话正常
+- [ ] userId 格式匹配
+- [ ] 双向通话稳定
+
+### 小程序端测试
+
+#### 测试 1：基本功能
+- [ ] 编译成功
+- [ ] 登录成功
+- [ ] 状态监听正常
+
+#### 测试 2：通话功能
+- [ ] 可以接收来电
+- [ ] 可以发起通话
+- [ ] 可以挂断通话
+- [ ] 视频显示正常
+- [ ] 音频传输正常
+
+## 📋 部署步骤
+
+### Web 端部署
+
+```bash
+# 1. 进入 admin 目录
+cd admin
+
+# 2. 清除旧依赖
+rm -rf node_modules package-lock.json
+
+# 3. 安装新依赖
+npm install
+
+# 4. 构建生产版本
+npm run build
+
+# 5. 部署到服务器
+# 将 dist 目录上传到服务器
+```
+
+### 小程序端部署
+
+```bash
+# 1. 进入小程序目录
+cd wx/TUICallKit
+
+# 2. 清除缓存
+# 微信开发者工具 → 工具 → 清除缓存
+
+# 3. 重新编译
+# 点击"编译"按钮
+
+# 4. 上传代码
+# 微信开发者工具 → 上传
+```
+
+## ⚠️ 注意事项
+
+### 1. 依赖安装
+- 必须删除 `node_modules` 和 `package-lock.json`
+- 重新运行 `npm install`
+- 确保安装的是新版本
+
+### 2. 缓存清理
+- 清除浏览器缓存
+- 清除 Vite 缓存（`node_modules/.vite`）
+- 清除微信开发者工具缓存
+
+### 3. userId 格式
+- 确保 Web 端和小程序端使用相同的 userId 格式
+- 格式：`prefix_number`（如：`doctor_1`, `patient_2`）
+- 类型：必须是字符串
+
+### 4. HTTPS 要求
+- Web 端必须使用 HTTPS（或 localhost）
+- 小程序端自动使用 HTTPS
+
+### 5. 权限设置
+- 浏览器：允许摄像头和麦克风
+- 小程序：允许摄像头和麦克风
+
+## 🔧 故障排除
+
+### 问题 1：安装失败
+
+**症状：**
+```
+npm ERR! code ERESOLVE
+```
+
+**解决：**
+```bash
+npm install --legacy-peer-deps
+```
+
+### 问题 2：编译错误
+
+**症状：**
+```
+Cannot find module '@trtc/calls-uikit-vue'
+```
+
+**解决：**
+```bash
+# 1. 删除依赖
+rm -rf node_modules package-lock.json
+
+# 2. 清除缓存
+npm cache clean --force
+
+# 3. 重新安装
+npm install
+```
+
+### 问题 3：运行时错误
+
+**症状：**
+```
+TUICallKitAPI is undefined
+```
+
+**解决：**
+1. 检查导入语句是否正确
+2. 检查包是否正确安装
+3. 重启开发服务器
+
+### 问题 4：通话失败
+
+**症状：**
+```
+Error code: 60011 (对方不在线)
+```
+
+**解决：**
+1. 检查 userId 格式是否一致
+2. 检查 SDKAppID 是否一致
+3. 检查对方是否已登录
+
+## 📊 版本兼容性
+
+### 浏览器兼容性
+- ✅ Chrome 56+
+- ✅ Edge 79+
+- ✅ Safari 11+
+- ✅ Firefox 52+
+
+### 小程序兼容性
+- ✅ 微信小程序基础库 2.10.0+
+- ✅ uni-app Vue 2
+- ✅ uni-app Vue 3
+
+### 互通兼容性
+- ✅ Web 4.2.x ↔ 小程序 4.2.x
+- ✅ Web 4.2.x ↔ Web 4.2.x
+- ✅ 小程序 4.2.x ↔ 小程序 4.2.x
+
+## 📞 技术支持
+
+### 官方文档
+- Web 端：https://cloud.tencent.com/document/product/647/78742
+- 小程序端：https://cloud.tencent.com/document/product/647/78731
+
+### 常见问题
+- FAQ：https://cloud.tencent.com/document/product/647/78769
+- API 文档：https://web.sdk.qcloud.com/component/trtccalling/doc/web/zh-cn/
+
+### 联系方式
+- 腾讯云工单系统
+- 技术支持论坛
+
+## ✅ 验收标准
+
+### Web 端
+- [ ] 编译无错误
+- [ ] 启动无错误
+- [ ] 可以正常登录
+- [ ] 可以发起通话
+- [ ] 可以接听通话
+- [ ] 视频音频正常
+- [ ] 状态管理正常
+
+### 小程序端
+- [ ] 编译无错误
+- [ ] 可以正常登录
+- [ ] 可以接收来电
+- [ ] 可以发起通话
+- [ ] 视频音频正常
+- [ ] 状态监听正常
+
+### 互通测试
+- [ ] Web → 小程序正常
+- [ ] 小程序 → Web 正常
+- [ ] 双向通话稳定
+- [ ] 无掉线问题
+
+## 🎉 升级完成
+
+所有代码已更新完成，可以开始测试了！
+
+---
+
+**升级日期：** 2024-03-04
+**升级版本：** 4.0.12 → 4.2.2
+**状态：** ✅ 完成