新增功能

2026-03-04 15:32:30 +08:00
parent a07e844c47
commit ab77f5488d
2266 changed files with 177942 additions and 3444 deletions
@@ -0,0 +1,147 @@
+# TUICallKit 升级修复完成
+
+## ✅ 问题已解决
+
+升级到 `@trtc/calls-uikit-vue` 4.2.2 时遇到的编译错误已全部修复。
+
+## 🔧 修复内容
+
+### 1. API 名称变更
+- `TUICallKitServer` → `TUICallKitAPI`
+
+### 2. 发起通话方法变更
+- 方法名：`call()` → `calls()`
+- 参数：`{ userID: string }` → `{ userIDList: string[] }`
+
+### 3. 已修复的文件
+- ✅ `admin/src/components/video-call/index.vue`
+- ✅ `admin/src/views/test/patient-call.vue`
+- ✅ `UIKIT_UPGRADE_COMPLETE.md`
+- ✅ `admin/API_NAME_CHANGE_FIX.md`（新增）
+
+## 📋 下一步操作
+
+### 步骤 1：重新安装依赖
+
+```bash
+cd admin
+
+# 删除旧依赖
+rm -rf node_modules package-lock.json
+
+# 安装新依赖
+npm install
+```
+
+### 步骤 2：启动开发服务器
+
+```bash
+npm run dev
+```
+
+### 步骤 3：测试功能
+
+1. 登录医生账号
+2. 发起视频通话
+3. 小程序端接听
+4. 验证通话正常
+
+## 🎯 预期结果
+
+- ✅ 编译成功，没有错误
+- ✅ 可以正常登录
+- ✅ 可以发起通话
+- ✅ 小程序端可以接收来电
+- ✅ 通话可以正常接通
+- ✅ 视频和音频正常
+
+## 📝 API 变更对比
+
+### 发起通话
+
+**旧版本 (4.0.12):**
+```typescript
+import { TUICallKitServer } from '@tencentcloud/call-uikit-vue'
+
+// 一对一通话
+await TUICallKitServer.call({
+    userID: 'patient_2',
+    type: TUICallType.VIDEO_CALL
+})
+```
+
+**新版本 (4.2.2):**
+```typescript
+import { TUICallKitAPI } from '@trtc/calls-uikit-vue'
+
+// 一对一通话
+await TUICallKitAPI.calls({
+    userIDList: ['patient_2'],  // 改为数组
+    type: TUICallType.VIDEO_CALL
+})
+
+// 多人通话
+await TUICallKitAPI.calls({
+    userIDList: ['patient_2', 'doctor_3', 'assistant_4'],
+    type: TUICallType.VIDEO_CALL
+})
+```
+
+### 其他 API（保持不变）
+
+```typescript
+// 初始化
+await TUICallKitAPI.init({
+    userID: 'doctor_1',
+    userSig: 'xxx',
+    SDKAppID: 123456
+})
+
+// 挂断
+await TUICallKitAPI.hangup()
+
+// 接听
+await TUICallKitAPI.accept()
+
+// 拒绝
+await TUICallKitAPI.reject()
+
+// 设置回调
+TUICallKitAPI.setCallback({
+    statusChanged: handleStatusChange,
+    afterCalling: handleAfterCalling
+})
+
+// 浮窗设置
+TUICallKitAPI.enableFloatWindow(false)
+```
+
+## ⚠️ 重要提示
+
+1. **必须删除旧依赖**：`rm -rf node_modules package-lock.json`
+2. **必须重新安装**：`npm install`
+3. **userId 格式**：确保 Web 端和小程序端使用相同格式（如 `doctor_1`, `patient_2`）
+4. **HTTPS 要求**：Web 端必须使用 HTTPS（或 localhost）
+
+## 📚 相关文档
+
+- `admin/API_NAME_CHANGE_FIX.md` - API 变更详细说明
+- `UIKIT_UPGRADE_COMPLETE.md` - 完整升级文档
+- `admin/QUICK_TEST_AFTER_UPGRADE.md` - 快速测试指南
+
+## 🎉 总结
+
+所有代码已修复完成，现在可以：
+
+1. 删除旧依赖
+2. 重新安装依赖
+3. 启动开发服务器
+4. 开始测试
+
+如果遇到问题，请查看相关文档或提供错误日志。
+
+---
+
+**修复日期：** 2024-03-04
+**修复版本：** 4.0.12 → 4.2.2
+**状态：** ✅ 完成