常见问题

产品 / 插件
平台 / 框架

如何处理常见的 Web 浏览器控制台报错?

产品 / 插件:实时音视频 / 实时语音 / 低延迟直播

平台 / 框架:Web

更新时间:2023-03-07 11:48


将 Zego Express Web SDK 集成到你的 Web 应用后,遇到问题时可以通过浏览器控制台打印的日志进行调试,本文列出控制台日志中常见的错误和原因。

错误提示 可能原因 处理建议
WebSocket is closed before the connection is established
Web 应用与 ZEGO 服务器的连接还未连接成功就被关闭。
  • 检查网络连接。
  • 检查 DNS 是否存在异常。
input parm error.roomID must be string
参数错误,登录房间传入的 “roomID” 格式错误。
请检查参数内容,确保 “roomID” 为字符串格式。
Failed to load resource
用户本地的 DNS 解析错误。
建议用户根据所在区域修改 DNS 后重新登录房间。

  • 中国大陆用户:将 DNS 服务器设为 114.114.114.114。
  • 中国大陆之外的用户:将 DNS 服务器设为 8.8.8.8。
publisher already exist
重复推了相同流名的流。
检查业务逻辑中是否存在重复推流的情况,重新推流需先调用 stopPublishingStream 接口停止推流。
cmd=login, err_code=1011, err_message=token format error
登录房间时传入的 “token” 参数格式错误。
“token” 为字符串类型,需要将 json 格式经过 base64 加密后再传入 loginRoom 接口中。
  • cmd=login, err_code=1000000101, err_message=login liveroom request fail"
  • "content":"server error=1000000101"
AppID 过期或 Server 地址错误。
请到 ZEGO 控制台 确认地址是否正确或联系 ZEGO 技术支持。
devices detect error: NotReadableError Could not start video source
浏览器没有获取媒体设备的权限或媒体设备被占用。
检查是否允许该页面获取媒体设备信息,是否有其他程序正在使用摄像头设备。
https or localhost required
基于浏览器安全策略对隐私性的要求,Web 平台调用摄像头强制要求 “https”,此安全策略是浏览器的要求。
ZEGO SDK 依赖于浏览器提供的 webRTC API,所以只支持 SSL 的 Web 服务器(https)、localhost、127.0.0.1(等同于 https)。
可以使用 “localhost” 先集成测试,后续上线仍然需要 “https” 环境。
Player already exist
SDK 不支持重复拉取同一条流。
检查业务代码逻辑,避免重复拉流。
本篇目录
下载 PDF