新增功能

2026-03-04 15:32:30 +08:00
parent a07e844c47
commit ab77f5488d
2266 changed files with 177942 additions and 3444 deletions
@@ -0,0 +1,242 @@
+# Web端呼叫小程序调试指南
+
+## 当前状态
+- ✅ 小程序呼叫Web端：正常
+- ❌ Web端呼叫小程序：不通
+
+## 调试步骤
+
+### 步骤1: 检查后端返回的数据
+
+打开浏览器控制台，查看发起通话时的日志：
+
+```
+=== 发起一对一通话 ===
+后端返回的 patientUserId: patient_1
+前端传入的 userId: patient_1
+最终使用的 targetUserId: patient_1
+完整的 res 对象: { sdkAppId: 1400xxx, userId: 'doctor_1', userSig: 'xxx', patientUserId: 'patient_1' }
+```
+
+**检查点：**
+1. `res.patientUserId` 是否存在？
+2. `res.patientUserId` 的格式是否为 `patient_{id}`？
+3. 是否与小程序端登录时使用的 userId 一致？
+
+### 步骤2: 检查小程序端的 userId
+
+在小程序端，查看登录时使用的 userId：
+
+```javascript
+// 小程序端代码
+console.log('小程序登录的 userId:', userId)
+// 应该输出: patient_1
+```
+
+**检查点：**
+1. 小程序端的 userId 格式是否为 `patient_{id}`？
+2. 是否与Web端发起通话时使用的 userId 完全一致？
+
+### 步骤3: 检查小程序端是否在线
+
+**方法1: 查看小程序端日志**
+```javascript
+// 小程序端应该有类似的日志
+console.log('IM登录成功')
+console.log('TUICallKit初始化成功')
+```
+
+**方法2: 查看Web端错误码**
+- 如果返回 `60011` 错误：说明小程序端不在线
+- 如果返回 `60010` 错误：说明小程序端忙线中
+- 如果返回 `60008` 错误：说明小程序端拒绝了通话
+
+### 步骤4: 检查后端代码
+
+确认后端是否正确返回 `patientUserId`：
+
+```php
+// server/app/adminapi/logic/tcm/DiagnosisLogic.php
+// getCallSignature 方法应该返回：
+
+return [
+    'sdkAppId' => (int)$config['sdkAppId'],
+    'userId' => $doctorUserId,  // 医生的userId
+    'userSig' => $userSig,
+    'patientUserId' => $patientUserId,  // 患者的userId ← 必须有这个
+    'expireTime' => 86400
+];
+```
+
+### 步骤5: 测试后端API
+
+使用Postman或浏览器直接测试后端API：
+
+```bash
+POST /adminapi/tcm.diagnosis/getCallSignature
+Content-Type: application/json
+
+{
+  "diagnosis_id": 1,
+  "patient_id": 1
+}
+```
+
+**预期响应：**
+```json
+{
+  "code": 1,
+  "msg": "success",
+  "data": {
+    "sdkAppId": 1400xxx,
+    "userId": "doctor_1",
+    "userSig": "xxx",
+    "patientUserId": "patient_1",  ← 必须有这个字段
+    "expireTime": 86400
+  }
+}
+```
+
+### 步骤6: 检查小程序端初始化代码
+
+小程序端必须正确初始化：
+
+```javascript
+// 小程序端 app.js 或页面代码
+import { TUICallKit } from '@tencentcloud/call-uikit-wechat'
+
+// 1. 获取签名
+const res = await wx.request({
+  url: 'https://your-api.com/getPatientSignature',
+  data: { patient_id: 1 }
+})
+
+// 2. 初始化
+await TUICallKit.init({
+  SDKAppID: res.data.sdkAppId,
+  userID: res.data.userId,  // 必须是 patient_1 格式
+  userSig: res.data.userSig
+})
+
+// 3. 监听来电
+TUICallKit.on('onCallReceived', (event) => {
+  console.log('收到来电', event)
+  // 显示来电界面
+})
+```
+
+## 常见问题
+
+### 问题1: 后端没有返回 patientUserId
+
+**症状：**
+```
+后端返回的 patientUserId: undefined
+前端传入的 userId: patient_1
+最终使用的 targetUserId: patient_1
+```
+
+**解决方案：**
+1. 检查后端代码是否已更新
+2. 清除后端缓存：`php think clear`
+3. 重启后端服务
+
+### 问题2: userId 格式不一致
+
+**症状：**
+- Web端使用: `patient_1`
+- 小程序端使用: `1` 或 `user_1`
+
+**解决方案：**
+统一使用 `patient_{id}` 格式
+
+### 问题3: 小程序端未登录IM
+
+**症状：**
+- Web端发起通话后，返回 60011 错误（用户不在线）
+- 小程序端没有收到任何通知
+
+**解决方案：**
+1. 确保小程序端在启动时调用了 `TUICallKit.init()`
+2. 确保小程序端保持在前台运行
+3. 检查小程序端的网络连接
+
+### 问题4: SDKAppID 不一致
+
+**症状：**
+- Web端和小程序端使用了不同的 SDKAppID
+
+**解决方案：**
+确保Web端和小程序端使用相同的 SDKAppID
+
+## 完整的调试日志示例
+
+### 正常情况（应该看到的日志）
+
+**Web端：**
+```
+签名获取成功: { doctorUserId: 'doctor_1', patientUserId: 'patient_1', sdkAppId: 1400xxx }
+TUICallKit init 方法调用完成
+初始化完成，显示通话界面
+=== 发起一对一通话 ===
+后端返回的 patientUserId: patient_1
+前端传入的 userId: patient_1
+最终使用的 targetUserId: patient_1
+通话已发起，目标用户: patient_1
+```
+
+**小程序端：**
+```
+IM登录成功
+TUICallKit初始化成功
+收到来电: { inviter: 'doctor_1', inviteeList: ['patient_1'], callType: 1 }
+```
+
+### 异常情况（问题日志）
+
+**情况1: 后端未返回 patientUserId**
+```
+后端返回的 patientUserId: undefined
+前端传入的 userId: patient_1
+最终使用的 targetUserId: patient_1
+完整的 res 对象: { sdkAppId: 1400xxx, userId: 'doctor_1', userSig: 'xxx' }
+                                                                    ↑ 缺少 patientUserId
+```
+
+**情况2: 小程序端不在线**
+```
+发起通话失败: Error: 对方不在线，无法发起通话
+错误码: 60011
+```
+
+**情况3: userId 格式不匹配**
+```
+最终使用的 targetUserId: patient_1
+小程序端登录的 userId: 1  ← 格式不一致
+```
+
+## 解决方案总结
+
+1. **确保后端返回 patientUserId**
+   - 修改 `getCallSignature` 方法
+   - 返回 `patientUserId` 字段
+
+2. **统一 userId 格式**
+   - Web端：`patient_{id}`
+   - 小程序端：`patient_{id}`
+
+3. **确保小程序端在线**
+   - 小程序启动时初始化 TUICallKit
+   - 保持小程序在前台运行
+
+4. **添加详细日志**
+   - Web端：查看控制台日志
+   - 小程序端：查看微信开发者工具控制台
+
+## 下一步
+
+1. 打开浏览器控制台
+2. 发起一次通话
+3. 查看日志输出
+4. 根据日志判断问题所在
+5. 按照上述解决方案修复