264 lines
4.7 KiB
Markdown
264 lines
4.7 KiB
Markdown
# 升级后快速测试指南
|
|
|
|
## 🚀 快速开始
|
|
|
|
### 步骤 1：重新安装依赖
|
|
|
|
```bash
|
|
cd admin
|
|
|
|
# 删除旧依赖
|
|
rm -rf node_modules package-lock.json
|
|
|
|
# 安装新依赖
|
|
npm install
|
|
```
|
|
|
|
**预期结果：**
|
|
```
|
|
✅ 安装成功
|
|
✅ 没有错误
|
|
✅ package-lock.json 已生成
|
|
```
|
|
|
|
### 步骤 2：启动开发服务器
|
|
|
|
```bash
|
|
npm run dev
|
|
```
|
|
|
|
**预期结果：**
|
|
```
|
|
✅ 编译成功
|
|
✅ 没有错误
|
|
✅ 服务器启动在 http://localhost:xxxx
|
|
```
|
|
|
|
### 步骤 3：登录系统
|
|
|
|
1. 打开浏览器
|
|
2. 访问 `http://localhost:xxxx`
|
|
3. 登录医生账号
|
|
|
|
**预期结果：**
|
|
```
|
|
✅ 登录成功
|
|
✅ 进入系统首页
|
|
✅ 没有控制台错误
|
|
```
|
|
|
|
### 步骤 4：测试视频通话
|
|
|
|
1. 进入患者管理页面
|
|
2. 找到一个患者
|
|
3. 点击"视频通话"按钮
|
|
|
|
**预期结果：**
|
|
```
|
|
✅ 弹出通话窗口
|
|
✅ 显示"准备通话..."
|
|
✅ 点击"开始通话"后初始化成功
|
|
✅ 显示"等待对方接听..."
|
|
```
|
|
|
|
### 步骤 5：小程序端接听
|
|
|
|
1. 小程序端登录对应的患者
|
|
2. 等待来电
|
|
3. 点击"接听"
|
|
|
|
**预期结果：**
|
|
```
|
|
✅ 小程序收到来电
|
|
✅ 显示来电界面
|
|
✅ 点击接听后通话接通
|
|
✅ 双方视频和音频正常
|
|
```
|
|
|
|
## 📋 检查清单
|
|
|
|
### 编译检查
|
|
- [ ] `npm install` 成功
|
|
- [ ] `npm run dev` 成功
|
|
- [ ] 没有编译错误
|
|
- [ ] 没有类型错误
|
|
|
|
### 功能检查
|
|
- [ ] 登录成功
|
|
- [ ] 视频通话窗口正常打开
|
|
- [ ] 初始化成功
|
|
- [ ] 可以发起通话
|
|
- [ ] 小程序端可以接收来电
|
|
- [ ] 通话可以接通
|
|
- [ ] 视频显示正常
|
|
- [ ] 音频传输正常
|
|
- [ ] 可以正常挂断
|
|
|
|
### 控制台检查
|
|
- [ ] 没有红色错误
|
|
- [ ] 没有导入错误
|
|
- [ ] 状态回调正常
|
|
- [ ] userId 格式正确
|
|
|
|
## ⚠️ 常见问题
|
|
|
|
### 问题 1：安装失败
|
|
|
|
**症状：**
|
|
```
|
|
npm ERR! code ERESOLVE
|
|
npm ERR! ERESOLVE unable to resolve dependency tree
|
|
```
|
|
|
|
**解决：**
|
|
```bash
|
|
npm install --legacy-peer-deps
|
|
```
|
|
|
|
### 问题 2：编译错误
|
|
|
|
**症状：**
|
|
```
|
|
Cannot find module '@trtc/calls-uikit-vue'
|
|
```
|
|
|
|
**解决：**
|
|
```bash
|
|
# 1. 确认 package.json 中的包名正确
|
|
"@trtc/calls-uikit-vue": "^4.2.2"
|
|
|
|
# 2. 删除依赖重新安装
|
|
rm -rf node_modules package-lock.json
|
|
npm install
|
|
```
|
|
|
|
### 问题 3：运行时错误
|
|
|
|
**症状：**
|
|
```
|
|
TUICallKitServer is undefined
|
|
```
|
|
|
|
**解决：**
|
|
1. 检查导入语句：
|
|
```typescript
|
|
import { TUICallKitServer } from '@trtc/calls-uikit-vue'
|
|
```
|
|
2. 重启开发服务器
|
|
3. 清除浏览器缓存
|
|
|
|
### 问题 4：通话失败
|
|
|
|
**症状：**
|
|
```
|
|
Error: 对方不在线 (60011)
|
|
```
|
|
|
|
**解决：**
|
|
1. 检查小程序端是否已登录
|
|
2. 检查 userId 格式是否一致
|
|
3. 查看详细日志
|
|
|
|
## 🔍 详细日志检查
|
|
|
|
### Web 端日志
|
|
|
|
**登录后：**
|
|
```javascript
|
|
WebRTC 环境检测: { isHttps: true, ... }
|
|
签名获取成功: { doctorUserId: "doctor_1", patientUserId: "patient_2", ... }
|
|
TUICallKit init 方法调用完成
|
|
初始化完成，显示通话界面
|
|
```
|
|
|
|
**发起通话后：**
|
|
```javascript
|
|
=== 发起一对一通话 ===
|
|
后端返回的 patientUserId: patient_2
|
|
最终使用的 targetUserId: patient_2
|
|
通话已发起，目标用户: patient_2
|
|
>>> 正在呼叫
|
|
```
|
|
|
|
**接通后：**
|
|
```javascript
|
|
>>> 通话已接通
|
|
```
|
|
|
|
### 小程序端日志
|
|
|
|
**登录后：**
|
|
```javascript
|
|
=== 页面已挂载 ===
|
|
=== 已设置详细日志级别 ===
|
|
获取签名成功: { userId: "patient_2", ... }
|
|
TUICallKit 初始化成功, userId: patient_2
|
|
=== TUICallKit 初始化完成，等待来电 ===
|
|
```
|
|
|
|
**收到来电后：**
|
|
```javascript
|
|
[tuikit engine wasm] onNewMessageReceived
|
|
=== 通话状态变化 === calling
|
|
=== 通话角色 === callee
|
|
=== 通话类型 === 2
|
|
```
|
|
|
|
## 🎯 成功标准
|
|
|
|
当你看到以下情况时，说明升级成功：
|
|
|
|
### Web 端
|
|
- ✅ 编译成功，没有错误
|
|
- ✅ 可以正常登录
|
|
- ✅ 可以打开通话窗口
|
|
- ✅ 可以初始化 TUICallKit
|
|
- ✅ 可以发起通话
|
|
- ✅ 状态回调正常
|
|
|
|
### 小程序端
|
|
- ✅ 可以正常登录
|
|
- ✅ 可以接收来电
|
|
- ✅ 状态监听正常
|
|
- ✅ 可以正常接听
|
|
|
|
### 互通测试
|
|
- ✅ Web → 小程序通话正常
|
|
- ✅ 小程序 → Web 通话正常
|
|
- ✅ 视频和音频都正常
|
|
- ✅ 通话稳定，不掉线
|
|
|
|
## 📞 需要帮助？
|
|
|
|
如果测试失败，请提供：
|
|
|
|
1. **安装日志**
|
|
```bash
|
|
npm install > install.log 2>&1
|
|
```
|
|
|
|
2. **编译日志**
|
|
- 完整的编译错误信息
|
|
- 截图
|
|
|
|
3. **运行时日志**
|
|
- 浏览器控制台日志
|
|
- 小程序控制台日志
|
|
|
|
4. **错误信息**
|
|
- 错误代码
|
|
- 错误提示
|
|
- 完整的错误堆栈
|
|
|
|
## 📚 相关文档
|
|
|
|
- **UIKIT_UPGRADE_COMPLETE.md** - 完整升级说明
|
|
- **WEB_UIKIT_UPGRADE_GUIDE.md** - Web 端升级指南
|
|
- **USERID_FORMAT_CHECK.md** - userId 格式检查
|
|
- **FINAL_TEST_CHECKLIST.md** - 完整测试清单
|
|
|
|
---
|
|
|
|
**最后更新：** 2024-03-04
|
|
**版本：** 1.0
|