常见错误码


1 loginRoom的错误码说明

错误码 说明
stateCode = 0 登录成功
stateCode = -1 没有配置为测试环境,请调用 [setUseTestEnv:YES]
stateCode = -2 调用次数太频繁,超出后台限制。请调整调用次数,每分钟最多 30 次
stateCode = 102 域名解析超时,请更换网络验证是否正常
stateCode = 256 初始化SDK不成功,请检查:1)setUseTestEnv是否设置为TRUE 和 setBusinessType是否设置了0,确保这两个接口设置正确
stateCode = 1042 网络连不上,请检查当前网络是否正常
stateCode = 4102 无法解析,请检查当前的网络是否正常
stateCode = 4103 登录超时,请检查当前的网络是否正常
stateCode = 4124 登录超时,请检查当前的网络是否正常
stateCode = 4131 网络连接失败,一般由于网络波动或其他异常导致,请检查当前网络是否正常
stateCode = 1048677 环境不存在。请检查:1)appid和appsign是否填写正确
stateCode = 1048680 房间不存在,请检查房间是否存在
stateCode = 1049578 观众不允许创建房间。 LoginRoom的时候,role设置了audience,然后又调用了setRoomConfig 接口将audienceCreateRoom的参数设置为FALSE了,导致观众无法创建房间。解决方案:将audienceCreateRoom的参数设置为TRUE就可以了
stateCode = 1050578 third token auth error(第三方token认证错误)。

1.1 LoginRoom失败如何处理

当onLoginCompletion回调stateCode不等于0,此时引起的原因比较多,除了配置问题,一般是网络问题引起,若是网络问题引起:

1、可以提示用户稍后再试

2、也可以考虑重试,比如失败了,隔3秒之后重新登录,重试5--10次后如果还是失败了,可以UI展示用户稍后再试。

注:避免陷入无限登录的死循环中,消耗手机内存。

2 onPublishStateUpdate的错误码说明

错误码 Msg 说明
stateCode = 0 Success 直播成功
stateCode = 3 FatalError 直播遇到严重错误。stateCode = 1/2/3 基本不会出现
stateCode = 4 CreateStreamError 创建直播流失败。请确认 1)userId,userName 是否为空,2)流名是否被重复利用了。建议每次推流的流名都保持唯一。
stateCode = 7 MediaServerNetWorkError 媒体服务器连接失败。请检查:1)推流端是否正常推流。2)正式环境和测试环境是否设置都是同一个。
3).网络是否正常
stateCode = 8 DNSResolveError DNS 解析失败。原因: 推流节点为空,请确认startPublishing的flag是否为0/2.
stateCode = 9 NotLoginError 未 loginRoom 就直接startpublishing。请确认推流前已 loginRoom
stateCode = 10 LogicServerNetWrokError 逻辑服务器网络错误(网络断开约 3 分钟时会返回该错误)。请检查网络是否正常
stateCode = 105 PublishBadNameError 推流BadName
stateCode = 66547 PublishForbidError 禁止推流, 请检查:是否已调用后台禁止推流接口禁止此streamid推流。
stateCode = 131073 PublishDeniedError 推流被拒绝
stateCode = 16777217 AddStreamError 添加流信息失败, 同一房间的两个用户推了同一条流名,导致第二个推流的用户推流被拒绝了

2.1 推流onPublishStateUpdate stateCode不等于0的处理策略

两个方式:

  1. 可以提示主播推流失败,重新推流

  2. 加上重推机制,比如stateCode不等于0后,每隔3秒重新调用startPublishing推流,重试5--10次左右如果还是不成功,说明当时连接不成功,可以UI展示用户推流失败,让主播检查网络等,稍后重新推流。

注:避免陷入推流的死循环中,消耗手机内存。

3 onPlayStateUpdate的错误码说明

错误码 Msg 说明
stateCode = 0 Success 播放成功
stateCode = 3 FatalError 直播遇到严重错误。stateCode = 1/2/3 基本不会出现
stateCode = 6 NoStreamError 流不存在。请检查:1)AppID 是否相同,要保证一致。2)是否同时开启测试环境或同时在正式环境下
stateCode = 7 MediaServerNetWorkError 媒体服务器连接失败。请检查:1)推流端是否正常推流。2)正式环境和测试环境是否设置都是同一个。
3).网络是否正常
stateCode = 9 NotLoginError 未 loginRoom 就直接 startPlayingStream。请确认拉流前已 loginRoom
stateCode = 197612 PlayStreamNotExistError 拉的流不存在, 请检查:拉流的streamid是否已推流成功。
stateCode = 197619 PlayForbidError 禁止拉流, 请检查:是否已调用后台禁止推流接口禁止此streamid拉流。
stateCode = 262145 PlayDeniedError 拉流被拒绝
stateCode = 16777219 ParameterError 拉流参数错误,请确认loginroom是否已经成功调用

3.1 拉流onPlayStateUpdate stateCode不等于0的处理策略

两个方式:

  1. 可以提示拉流失败,重新拉流

  2. 加上重拉机制,比如stateCode不等于0后,每隔3秒重新调用startPlayingStream拉流,重试5--10次左右如果还是不成功,说明当时连接不成功,可以UI展示用户拉流失败,让主播检查网络等,稍后重新拉流。

注:避免陷入拉流的死循环中,消耗手机内存。

4 onDisconnect的错误码说明

错误码 说明
ErrorCode = 16777219 网络断开。 断网90秒仍没有恢复后会回调这个错误,onDisconnect后会停止推流和拉流

4.1 房间连接90秒断开onDisconnect的处理策略

原因:

1、 断网90秒仍没有恢复。

处理策略:此时推流和拉流都会断开,若要重新恢复推流和拉流,此时需要重新loginRoom,startPublishing和startPlayingStream才能恢复推流和拉流

2、相同的userID在不同的设备上登录了不同的roomID,前面的用户收到onDisconnect的回调。

处理策略:业务侧要保证userID唯一。

5 OnKickOut的错误码说明

错误码 说明
ErrorCode = 16777219 被踢出房间。 有另外的设备用同样的userID登录了同样的房间,造成前面登录的用户被踢出房间
ErrorCode = 16777220 被踢出房间。 后台调用踢人接口将这个用户踢出房间

5.1 OnKickOut的处理策略

业务侧确保分配的userID保持唯一,不然会造成互相抢占。

6 onDeviceError错误码说明

错误码 说明
ErrorCode = -1 设备占用,device里面会提示是麦克风还是摄像头被占用

6.1 onDeviceError的处理策略

保证没有其他的App或者同一个App内的其他模块释放了麦克风和摄像头后,再重新初始化SDK启动摄像头和麦克风。

7 混流失败的错误码说明

错误码 说明
errorCode = 0 混流成功
errorCode =1 混流失败
errorCode =2 混流输入参数错误
errorCode =3 混流鉴权失败
errorCode =4 ~ 17 混流失败,联系ZEGO技术支持解决
errorCode = 150 混流的输入流不存在。请检查混流的inputStreamList里面的流是否正在推流
errorCode = 151 混流失败。请联系ZEGO技术支持解决
errorCode = 152 停止混流失败。请联系ZEGO技术支持解决
errorCode = 153 输入参数错误,请检查1) inputStreamList里面每个layer的输入参数是否正确,比如输出的码率、帧率都不能为空; 2) 混流mixoutput的输出分辨率小于混流mixinput参数的输入分辨率
errorCode = 154 输出参数错误,请检查output的输出参数是否正确,比如输出的码率、帧率都不能为空
errorCode = 155 输入分辨率格式错误,请检查输入分辨率大小是否已经大于设置的分辨率大小
errorCode = 156 输出分辨率格式错误,请检查输出的分辨率不为空
errorCode = 157 混流没开,请联系ZEGO技术支持开启混流模式
errorCode = 158 混流超过路数限制, 默认9路
errorCode = 159 调度失败,请联系ZEGO技术支持解决
errorCode = 160 主播停止混流失败
errorCode = 170 混流水印参数错误
errorCode = 171 混流水印图片为空

8 onInitSDK的错误码说明

错误码 说明
ErrorCode = -1001 配置文件错误,联系即构技术支持
ErrorCode = -1003 AppID、AppSign 填写错误或者获取的配置文件错误,联系即构技术支持
ErrorCode > 0 配置文件获取失败,检查网络状况