常见问题

Q: 连接失败怎么办？

A: 检查以下几点：

1. 设备 IP 地址是否正确
2. 端口配置是否正确（video 和 touch 端口）
3. 网络是否连通（可以 ping 设备 IP）
4. 设备端服务是否正常运行
5. 防火墙是否阻止了连接

Q: 画面不显示怎么办？

A: 检查以下几点：

1. 视频端口是否正确
2. 浏览器控制台是否有错误信息
3. 检查 ERROR 事件中的错误信息
4. 确认浏览器支持 WebGL（大多数现代浏览器都支持）

Q: 触控不响应怎么办？

A: 检查以下几点：

1. 触控端口是否正确
2. 是否已成功连接（监听 STARTED 事件）
3. 检查 ERROR 事件中是否有触控通道相关错误

Q: 在 Vue/React 中使用时出现错误？

A: 确保使用了 shallowRef/useRef 和 markRaw，避免 Vue/React 的响应式系统代理 SDK 实例。

Q: 如何实现群控？

A:

1. 创建主设备客户端时设置 isGroupControl: true
2. 调用 setGroupControlMode(true) 开启群控模式
3. 调用 joinGroupControl() 添加从设备
4. 监听 GROUP_CONTROL_JOINED 事件确认设备加入成功

Q: 在 HTTPS 环境下 WebSocket 连接失败怎么办？

A: 在 HTTPS 环境下，浏览器要求使用 WSS（WebSocket Secure）协议，而不是 WS 协议。

解决方案：

1. SDK 自动处理：SDK 会根据当前页面的协议（HTTP/HTTPS）自动选择对应的 WebSocket 协议：

   • HTTPS 页面 → 自动使用 WSS
   • HTTP/localhost/file:// 页面 → 自动使用 WS

2. 设备端配置：确保设备端的 WebSocket 服务同时支持 WS 和 WSS 协议，或根据部署环境配置：

   • 如果前端部署在 HTTPS，设备端需要配置 SSL/TLS 证书以支持 WSS
   • 如果前端部署在 HTTP/localhost，设备端使用普通 WS 即可

3. 常见问题排查：

   • 检查设备端是否配置了 SSL/TLS 证书（HTTPS 环境必需）
   • 检查防火墙是否允许 WSS 端口（通常与 WS 端口相同）
   • 检查浏览器控制台的错误信息，确认是否为协议不匹配问题
   • 确认设备端 WebSocket 服务支持协议升级（从 WS 到 WSS）

注意：SDK 会自动处理协议选择，您无需在代码中手动指定 ws:// 或 wss://，只需提供 IP 和端口即可。