203 lines
4.7 KiB
Markdown
203 lines
4.7 KiB
Markdown
# 快速修复：Web 端呼叫小程序端无法接听
|
||
|
||
## 核心问题
|
||
|
||
**userId 格式不匹配**是最常见的原因。
|
||
|
||
## 立即检查
|
||
|
||
### 1. 打开浏览器控制台（Web 端）
|
||
|
||
在发起通话前，查看日志：
|
||
```
|
||
=== 发起一对一通话 ===
|
||
后端返回的 patientUserId: patient_2
|
||
最终使用的 targetUserId: patient_2
|
||
```
|
||
|
||
### 2. 打开微信开发者工具控制台（小程序端）
|
||
|
||
在登录后，查看日志：
|
||
```
|
||
=== 小程序端登录信息 ===
|
||
userId: patient_2
|
||
```
|
||
|
||
### 3. 对比两个 userId
|
||
|
||
**必须完全一致！**
|
||
|
||
- ✅ 正确：Web 呼叫 `patient_2`，小程序登录为 `patient_2`
|
||
- ❌ 错误：Web 呼叫 `patient_2`，小程序登录为 `2`
|
||
- ❌ 错误：Web 呼叫 `2`，小程序登录为 `patient_2`
|
||
|
||
## 快速修复步骤
|
||
|
||
### 修复 1：确保后端返回正确格式
|
||
|
||
检查后端接口 `/api/tcm/getCallSignature` 和 `/api/tcm/getPatientSignature`：
|
||
|
||
```php
|
||
// 医生端（Web）
|
||
return [
|
||
'userId' => 'doctor_' . $doctorId, // 医生自己的ID
|
||
'patientUserId' => 'patient_' . $patientId, // 要呼叫的患者ID
|
||
'sdkAppId' => $sdkAppId,
|
||
'userSig' => $userSig
|
||
];
|
||
|
||
// 患者端（小程序）
|
||
return [
|
||
'userId' => 'patient_' . $patientId, // 患者自己的ID
|
||
'sdkAppId' => $sdkAppId,
|
||
'userSig' => $userSig
|
||
];
|
||
```
|
||
|
||
### 修复 2：小程序端已更新
|
||
|
||
小程序端代码已更新，支持自动转换：
|
||
- 输入纯数字 `1` → 自动转换为 `doctor_1`
|
||
- 输入完整格式 `doctor_1` → 直接使用
|
||
|
||
### 修复 3：测试流程
|
||
|
||
**场景 1：Web 端（医生）呼叫小程序端（患者）**
|
||
|
||
1. 小程序端操作：
|
||
- 输入患者ID：`2`
|
||
- 点击"登录"
|
||
- 看到"当前登录: patient_2"
|
||
|
||
2. Web 端操作：
|
||
- 打开患者详情页
|
||
- 点击"视频通话"按钮
|
||
- 系统自动使用 `patient_2` 发起呼叫
|
||
|
||
3. 小程序端应该：
|
||
- 自动弹出来电界面
|
||
- 显示来电提示
|
||
- 可以接听或拒绝
|
||
|
||
**场景 2：小程序端（患者）呼叫 Web 端（医生）**
|
||
|
||
1. Web 端操作：
|
||
- 医生登录系统（自动登录为 `doctor_1`）
|
||
- 保持页面打开
|
||
|
||
2. 小程序端操作：
|
||
- 已登录为 `patient_2`
|
||
- 输入医生ID：`1` 或 `doctor_1`
|
||
- 点击"呼叫"
|
||
|
||
3. Web 端应该：
|
||
- 自动弹出来电界面
|
||
- 显示来电提示
|
||
- 可以接听或拒绝
|
||
|
||
## 常见错误及解决
|
||
|
||
### 错误 1：对方不在线（60011）
|
||
|
||
**原因：**
|
||
- 对方未登录
|
||
- userId 格式不匹配
|
||
- 对方已退出登录
|
||
|
||
**解决：**
|
||
1. 确认对方已登录
|
||
2. 检查 userId 格式是否一致
|
||
3. 让对方重新登录
|
||
|
||
### 错误 2：初始化失败
|
||
|
||
**原因：**
|
||
- SDKAppID 不一致
|
||
- userSig 过期或无效
|
||
- 网络连接问题
|
||
|
||
**解决：**
|
||
1. 检查双方 SDKAppID 是否相同
|
||
2. 重新获取 userSig
|
||
3. 检查网络连接
|
||
|
||
### 错误 3：无法访问摄像头/麦克风
|
||
|
||
**原因：**
|
||
- 小程序权限未授予
|
||
- 浏览器权限未授予
|
||
- 设备被其他应用占用
|
||
|
||
**解决：**
|
||
1. 小程序：在设置中允许摄像头和麦克风权限
|
||
2. 浏览器：点击地址栏的摄像头图标，允许权限
|
||
3. 关闭其他占用设备的应用
|
||
|
||
## 验证清单
|
||
|
||
在发起通话前，确认：
|
||
|
||
- [ ] 小程序端显示"当前登录: patient_X"
|
||
- [ ] Web 端控制台显示"最终使用的 targetUserId: patient_X"
|
||
- [ ] 两个 userId 完全一致
|
||
- [ ] 小程序在前台运行（未切换到后台）
|
||
- [ ] 双方网络连接正常
|
||
- [ ] 双方已授予摄像头和麦克风权限
|
||
|
||
## 测试命令
|
||
|
||
### 在小程序端控制台测试
|
||
|
||
```javascript
|
||
// 1. 检查登录状态
|
||
console.log('当前登录:', currentUserId.value)
|
||
|
||
// 2. 手动发起呼叫测试
|
||
TUICallKitAPI.calls({
|
||
userIDList: ['doctor_1'], // 替换为实际的医生ID
|
||
type: 2
|
||
}).then(() => {
|
||
console.log('呼叫成功')
|
||
}).catch(err => {
|
||
console.error('呼叫失败:', err)
|
||
})
|
||
```
|
||
|
||
### 在 Web 端控制台测试
|
||
|
||
```javascript
|
||
// 1. 检查登录状态
|
||
console.log('医生登录信息:', {
|
||
userId: '从后端获取',
|
||
patientUserId: '要呼叫的患者ID'
|
||
})
|
||
|
||
// 2. 手动发起呼叫测试
|
||
TUICallKitServer.call({
|
||
userID: 'patient_2', // 替换为实际的患者ID
|
||
type: TUICallType.VIDEO_CALL
|
||
}).then(() => {
|
||
console.log('呼叫成功')
|
||
}).catch(err => {
|
||
console.error('呼叫失败:', err)
|
||
})
|
||
```
|
||
|
||
## 仍然无法解决？
|
||
|
||
如果按照以上步骤仍然无法解决，请检查：
|
||
|
||
1. **后端日志**：查看签名生成是否正确
|
||
2. **网络抓包**：查看信令是否正常发送
|
||
3. **腾讯云控制台**：查看实时通话监控
|
||
4. **版本兼容性**：确保 Web 端和小程序端使用兼容的 SDK 版本
|
||
|
||
## 联系方式
|
||
|
||
提供以下信息以便快速定位问题：
|
||
|
||
1. Web 端完整控制台日志（截图）
|
||
2. 小程序端完整控制台日志（截图）
|
||
3. 后端返回的签名数据（隐藏敏感信息）
|
||
4. 具体错误代码和提示信息
|