8.6 KiB
8.6 KiB
视频通话功能测试指南
测试前准备
1. 环境要求
- Web 端使用 HTTPS 或 localhost
- 小程序已获得摄像头和麦克风权限
- 网络连接正常
- 微信开发者工具或真机
2. 清除缓存
微信开发者工具：
1. 点击顶部菜单"工具"
2. 选择"清除缓存"
3. 勾选"全部清除"
4. 点击"确定"
真机测试：
1. 长按小程序
2. 选择"删除"
3. 重新扫码打开
测试场景 1：Web 端呼叫小程序端
步骤 1：小程序端登录
- 打开小程序
- 输入患者ID：
2 - 点击"登录"按钮
预期结果：
- ✅ 显示"登录成功"提示
- ✅ 界面显示"当前登录: patient_2"
- ✅ 输入框提示变为"输入医生ID或完整userId"
控制台日志：
获取签名成功: { userId: "patient_2", sdkAppId: "1400xxxxxx", ... }
=== 小程序端登录信息 ===
sdkAppId: 1400xxxxxx
userId: patient_2
userSig 长度: xxx
TUICallKit 初始化成功, userId: patient_2
=== 事件监听已设置 ===
如果失败：
- ❌ 提示"登录失败" → 检查后端接口是否正常
- ❌ 没有"事件监听已设置"日志 → 初始化失败，检查 SDKAppID
步骤 2：Web 端发起呼叫
- 打开浏览器，登录医生账号
- 进入患者管理页面
- 找到患者ID为 2 的患者
- 点击"视频通话"按钮
预期结果：
- ✅ Web 端弹出通话窗口
- ✅ 显示"等待对方接听..."
- ✅ 浏览器控制台显示"通话已发起"
浏览器控制台日志：
WebRTC 环境检测: { isHttps: true, ... }
签名获取成功: { doctorUserId: "doctor_1", patientUserId: "patient_2", ... }
TUICallKit init 方法调用完成
=== 发起一对一通话 ===
后端返回的 patientUserId: patient_2
最终使用的 targetUserId: patient_2
通话已发起，目标用户: patient_2
>>> 正在呼叫
如果失败：
- ❌ 提示"获取签名失败" → 检查后端接口
- ❌ 提示"初始化失败" → 检查 WebRTC 环境
- ❌ 提示"对方不在线" → userId 格式不匹配
步骤 3：小程序端接听
预期结果：
- ✅ 小程序自动弹出通话界面
- ✅ 显示来电提示音
- ✅ 显示"接听"和"拒绝"按钮
- ✅ 显示来电者信息（医生名称）
小程序控制台日志：
=== 收到来电 ===
{
inviter: "doctor_1",
inviteeList: ["patient_2"],
callType: 2,
...
}
如果失败：
- ❌ 小程序没有任何反应 → 检查事件监听是否设置
- ❌ 没有"收到来电"日志 → 检查 userId 格式
- ❌ 小程序闪退 → 检查权限是否授予
步骤 4：接听通话
- 小程序端点击"接听"按钮
预期结果：
- ✅ 双方都能看到对方的视频画面
- ✅ 双方都能听到对方的声音
- ✅ 控制按钮正常工作（静音、关闭摄像头等）
控制台日志：
Web 端：
>>> 通话已接通
小程序端：
=== 通话已接通 ===
如果失败：
- ❌ 只有声音没有画面 → 检查摄像头权限
- ❌ 只有画面没有声音 → 检查麦克风权限
- ❌ 黑屏 → 检查网络连接
步骤 5：挂断通话
- 任意一方点击"挂断"按钮
预期结果：
- ✅ 通话立即结束
- ✅ 双方都返回正常界面
- ✅ 显示"通话已结束"提示
测试场景 2：小程序端呼叫 Web 端
步骤 1：Web 端保持登录
- 浏览器打开系统
- 医生账号登录
- 保持页面打开
预期结果：
- ✅ 医生已登录
- ✅ 页面正常显示
步骤 2：小程序端发起呼叫
- 小程序端已登录为
patient_2 - 在输入框输入：
1或doctor_1 - 点击"呼叫"按钮
预期结果：
- ✅ 显示"正在呼叫..."
- ✅ 小程序显示呼叫界面
小程序控制台日志：
准备呼叫用户: doctor_1
发起通话成功, 目标用户: doctor_1
如果失败：
- ❌ 提示"发起通话失败" → 检查 userId 格式
- ❌ 提示"对方不在线" → Web 端未登录或 userId 不匹配
步骤 3：Web 端接听
预期结果：
- ✅ Web 端自动弹出通话窗口
- ✅ 显示来电提示
- ✅ 显示"接听"和"拒绝"按钮
浏览器控制台日志：
>>> 收到来电
inviter: patient_2
如果失败：
- ❌ Web 端没有反应 → 检查是否已登录
- ❌ 提示"初始化失败" → 刷新页面重新登录
步骤 4：接听并测试
同场景 1 的步骤 4 和步骤 5
测试场景 3：拒绝通话
测试拒绝功能
- 按照场景 1 或场景 2 发起通话
- 接收方点击"拒绝"按钮
预期结果：
- ✅ 通话立即结束
- ✅ 发起方显示"对方已拒绝通话"
- ✅ 双方返回正常界面
测试场景 4：超时未接听
测试超时机制
- 按照场景 1 或场景 2 发起通话
- 接收方不做任何操作，等待 30 秒
预期结果：
- ✅ 30 秒后自动挂断
- ✅ 发起方显示"对方未接听"
- ✅ 双方返回正常界面
测试场景 5：网络中断
测试网络恢复
- 正常接通通话
- 关闭一方的网络连接
- 等待 5-10 秒
- 恢复网络连接
预期结果：
- ✅ 网络中断时显示"网络连接中断"
- ✅ 网络恢复后自动重连
- ✅ 如果无法重连，自动挂断
常见问题排查
问题 1：小程序端无法接听
症状： Web 端发起呼叫后，小程序端没有任何反应
排查步骤：
-
检查小程序端是否已登录
界面应显示："当前登录: patient_2" -
检查控制台是否有"事件监听已设置"日志
如果没有，说明初始化失败 -
检查 userId 格式是否一致
Web 端：targetUserId: patient_2 小程序端：userId: patient_2 必须完全一致！ -
检查 SDKAppID 是否一致
Web 端和小程序端必须使用同一个 SDKAppID -
检查小程序是否在前台
如果切换到后台，可能无法接收来电
解决方案：
- 重新登录小程序
- 确保 userId 格式一致
- 确保小程序在前台运行
问题 2：提示"对方不在线"
症状： 发起呼叫时提示"对方不在线"（错误代码 60011）
排查步骤：
- 确认对方已登录
- 检查 userId 格式是否匹配
- 检查 SDKAppID 是否一致
- 查看后端日志确认账号已导入
解决方案：
- 对方重新登录
- 统一 userId 格式
- 检查后端配置
问题 3：无法访问摄像头/麦克风
症状： 黑屏或无声音
排查步骤：
- 检查浏览器权限设置
- 检查小程序权限设置
- 检查设备是否被其他应用占用
解决方案：
- 浏览器：地址栏 → 权限 → 允许摄像头和麦克风
- 小程序：设置 → 权限管理 → 允许摄像头和麦克风
- 关闭其他占用设备的应用
问题 4：通话中断或卡顿
症状： 通话过程中画面卡顿或中断
排查步骤：
- 检查网络连接速度
- 检查 CPU 使用率
- 检查是否有其他大流量应用
解决方案：
- 切换到更稳定的网络
- 关闭其他占用资源的应用
- 降低视频质量设置
测试检查清单
功能测试
- Web 端可以呼叫小程序端
- 小程序端可以呼叫 Web 端
- 可以正常接听通话
- 可以拒绝通话
- 可以挂断通话
- 视频画面正常显示
- 音频正常传输
- 静音功能正常
- 关闭摄像头功能正常
- 切换摄像头功能正常（移动端）
异常测试
- 网络中断后能正常恢复
- 超时未接听能正常处理
- 对方拒绝能正常提示
- 对方不在线能正常提示
- 权限未授予能正常提示
性能测试
- 通话延迟小于 300ms
- 画面流畅不卡顿
- 音频清晰无杂音
- CPU 使用率正常
- 内存使用正常
测试报告模板
测试日期：____年____月____日
测试人员：__________
测试环境：
- Web 端浏览器：__________
- 小程序版本：__________
- 网络环境：__________
测试结果：
场景 1（Web → 小程序）：□ 通过 □ 失败
场景 2（小程序 → Web）：□ 通过 □ 失败
场景 3（拒绝通话）： □ 通过 □ 失败
场景 4（超时未接听）： □ 通过 □ 失败
场景 5（网络中断）： □ 通过 □ 失败
问题记录：
1. __________
2. __________
3. __________
备注：
__________
成功标准
所有测试场景都应该：
- ✅ 能够正常发起通话
- ✅ 能够正常接听通话
- ✅ 视频和音频都正常
- ✅ 控制按钮都能正常工作
- ✅ 异常情况能正常处理
- ✅ 用户体验流畅
最后更新： 2024-03-04 版本： 1.0