Tutorial: 错误码说明及处理建议

错误码说明及处理建议

本文主要介绍在音视频通话过程常见的错误码以及处理方式。

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 publish超时 请尝试刷新重连,再次操作publish()
join room timeout 进房超时 建议刷新页面重进
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 由于某些设备/系统未知原因导致设备无法被使用 建议通话前先进行设备检测
NotReadableError 找不由于操作系统上某个硬件、浏览器或者网页层面发生的错误导致设备无法被访问 根据浏览器的报错信息处理,提示用户确保当前没有其他应用请求访问摄像头/麦克风,并重试
NotFoundError 找不到满足请求参数的媒体类型,如音频、视频、屏幕分享 建议通话前先进行设备检测
NotAllowedError 用户拒绝了当前的浏览器实例的访问音频、视频、屏幕分享请求 用户需授权摄像头/麦克风访问,才能进行音视频通话
SignalChannel reconnect failed websocket断开 请尝试刷新重连
duplicate publishing, please unpublish and then re-publish 重复publish 请先操作unpublish(),再操作publish()
OverconstrainedError 浏览器获取不到cameraId/microphoneId 请确保cameraId/microphoneId的值是有效的非空字符串
RtcError: no valid ice candidate found TRTC Web SDK在STUN打洞失败 请检查下防火墙配置
10006 error 账号服务状态问题 请登录 实时音视频控制台,单击您创建的应用,单击【帐号信息】,在帐号信息面板即可确认服务状态
-100018 get tinyid error userSig问题 建议检查userSig填写是否有误