本文主要介绍在音视频通话过程常见的错误码以及处理方式。
ErrorCode
| 错误码 | Key | 描述 |
|---|---|---|
| 0x1000 | INVALID_PARAMETER | 无效参数 |
| 0x1001 | INVALID_OPERATION | 非法操作，如信令通道尚未准备好就尝试进房、重复调用进房接口 |
| 0x4001 | SIGNAL_CAHNNEL_SETUP_FAILED | 信令通道建立失败 |
| 0x4002 | SIGNAL_CHANNEL_ERROR | 信令通道错误 |
| 0x4003 | ICE_TRANSPORT_ERROR | ICE Transport 连接错误，即音视频数据传输通道错误 |
| 0x4004 | JOIN_ROOM_FAILED | 进房失败，如进房超时、后台告知进房失败 |
| 0x4005 | CREATE_OFFER_FAILED | 创建 sdp offer 失败 |
| 0x4040 | CLIENT_BANNED | 用户被踢出房间 |
| 0x4041 | SERVER_TIMEOUT | 媒体传输服务超时 |
| 0x4042 | SUBSCRIPTION_TIMEOUT | 远端流订阅超时 |
| 0xFFFF | UNKOWN | 未知错误，如 SDK 未定义的错误、浏览器抛出的错误 |
常见报错及处理方式
该类型报错，需要应用程序提供干预，例如获取摄像头权限被拒绝，应用程序需要提示用户授权摄像头才能进行音视频通话。
| 错误信息 | 错误原因 | 解决方案 |
|---|---|---|
| publish timeout / failed to publish because of timeout | publish超时 | 请尝试刷新重连，再次操作publish() |
| join room timeout / join room timeout observed | 进房超时 | 建议刷新页面重进 |
| DTLS Transport connection timeout (10s) | DTLS Transport连接超时 | 请尝试刷新重连 |
| failed to connect to remote server via websocket | websocket连接失败 | 请尝试刷新重连 |
| ICE/DTLS Transport connection failed | 建立媒体传输通道时失败 | 请检查下防火墙配置 |
| previous publishing is ongoing, please avoid re-publishing | 已经在publishing状态中 | publish后请避免再次publish() |
| AbortError | 由于某些设备/系统未知原因导致设备无法被使用 | 建议通话前先进行设备检测 |
| getUserMedia error observed NotReadableError | 找不由于操作系统上某个硬件、浏览器或者网页层面发生的错误导致设备无法被访问 | 根据浏览器的报错信息处理，提示用户确保当前没有其他应用请求访问摄像头/麦克风，并重试 |
| getUserMedia error observed NotFoundError | 找不到满足请求参数的媒体类型，如音频、视频、屏幕分享 | 建议通话前先进行设备检测 |
| getUserMedia error observed NotAllowedError | 用户拒绝了当前的浏览器实例的访问音频、视频、屏幕分享请求 | 用户需授权摄像头/麦克风访问，才能进行音视频通话 |
| getUserMedia error observed OverconstrainedError | 浏览器获取不到cameraId/microphoneId | 请确保cameraId/microphoneId的值是有效的非空字符串 |
| SignalChannel setup failed | WebSocket 信令通道错误 | 请尝试刷新重连 |
| SignalChannel reconnect failed | websocket断开 | 请尝试刷新重连 |
| duplicate publishing, please unpublish and then re-publish | 重复publish | 请先操作unpublish()，再操作publish() |
| RtcError: no valid ice candidate found | TRTC Web SDK在STUN打洞失败 | 请检查下防火墙配置 |
| 10006 error | 账号服务状态问题 | 请登录 实时音视频控制台，单击您创建的应用，单击【帐号信息】，在帐号信息面板即可确认服务状态 |
| -100018 get tinyid error | userSig问题 | 建议检查userSig填写是否有误 |