提交工单
 咨询集成、功能及报价等问题
本文针对初始化 SDK、登录房间、推拉流、混流部分列出常见错误码。
调用初始化 SDK 接口后,如果初始化回调(iOS:ZegoInitSDKCompletionBlock,Android:onInitSDK,Windows:OnInitSDK)返回的错误码非0,请查看以下错误码并进行相应处理。
| 错误码枚举 | 枚举值 | 说明 | 
|---|---|---|
| kConfigServerCouldntConnectError | 21200007 | 无法连接配置服务器 请检查网络是否正常  | 
| kConfigServerTimeoutError | 21200028 | 连接配置服务器超时 请检查网络是否正常  | 
| kConfigDecryptError | 20000001 | 配置文件解密失败 请检查 AppID 和 AppSign 是否正确 无法解决请联系 ZEGO 技术支持解决  | 
调用登录房间接口后,登录回调(iOS:ZegoLoginCompletionBlock,Android:onLoginCompletion,Windows:OnLoginRoom)返回的错误码如果非0,请先查看以下错误码并进行相应的处理。
当登录回调的错误码非0时,若是网络问题,可按以下方法处理:
- 可以提示用户稍后再试。
 - 可以考虑重试,比如失败了,隔3秒之后重新登录,重试5--10次后如果还是失败了,可以 UI 展示用户稍后再试。 注意:避免陷入无限登录的死循环中,消耗手机内存。
 
| 错误码枚举 | 枚举值 | 说明 | 
|---|---|---|
| kConfigServerCouldntConnectError | 21200007 | 无法连接配置服务器 请检查网络是否正常  | 
| kConfigServerTimeoutError | 21200028 | 连接配置服务器超时 请检查网络是否正常  | 
| kLiveRoomCouldntConnectError | 51200007 | 无法连接房间服务器 请检查网络是否正常  | 
| kLiveRoomTimeoutError | 51200028 | 连接房间服务器超时 请检查网络是否正常  | 
| kLiveRoomAddUserError | 52001002 | 房间服务器报错,添加用户失败 请联系 ZEGO 技术支持解决  | 
| kRoomDecodeSignError | 62001001 | 房间服务器报错 请联系 ZEGO 技术支持解决  | 
| kRoomConnectError | 60001001 | 无法连接房间服务器 请检查网络是否正常  | 
| kRoomDoLoginReqError | 60001003 | 发送 login 到房间服务器失败 请检查网络是否正常  | 
| kRoomTimeoutError | 60001004 | 登录房间服务器超时 请检查网络是否正常  | 
| kRoomHbTimeoutError | 60001005 | 房间服务器心跳超时 请检查网络是否正常  | 
| kRoomStartConnectError | 60001006 | 与房间服务器连接失败 请联系 ZEGO 技术支持解决  | 
| kRoomStatusRspError | 62010006 | 房间服务器报错 请联系 ZEGO 技术支持解决  | 
| kRoomUserLoginedOther | 62050013 | SDK 重连时,当前用户已在别处登录 请勿重复登录  | 
| kRoomTokenAuthError | 62050119 | 鉴权失败 请联系 ZEGO 技术支持解决  | 
| kRoomTokenFormatError | 62050120 | Token 格式错误 请确认 Token 格式是否正确  | 
| kRoomTokenAppidError | 62050121 | AppID 错误 请使用生成 Token 时的 AppID  | 
| kRoomTokenUserIDError | 62050122 | userID 错误 请使用生成 Token 时的 userID  | 
| kRoomTokenExpire | 62050123 | Token 已过期 请重新生成 Token  | 
| kRoomTokenVersionError | 62050124 | Token Version 错误 请重新生成正确版本的 Token  | 
| kRoomTokenNonceTypeError | 62050125 | Token 的 Nonce 类型错误 请检查参数的数据类型  | 
| kRoomTokenAppidTypeError | 62050126 | Token 的 AppID 类型错误 请检查参数的数据类型  | 
| kRoomTokenExpireTypeError | 62050127 | Token 的 Expire 类型错误 请检查参数的数据类型  | 
| kRoomTokenUserIDTypeError | 62050128 | Token 的 userID 类型错误 请检查参数的数据类型  | 
调用推流接口后,推流回调(iOS、Android:onPublishStateUpdate,Windows:OnPublishStateUpdate)的错误码如果非0,请查看以下错误码进行相应的处理。
处理推流回调错误码非0的情况,一般有以下两种方式:
- 可以提示主播推流失败,重新推流。
 - 加上重推机制,比如错误码不等于0后,每隔3秒重新调用 startPublishing 推流,重试5--10次左右如果还是不成功,说明当时连接不成功,可以 UI 展示用户推流失败,让主播检查网络等,稍后重新推流。 注意:避免陷入推流的死循环中,消耗手机内存。
 
| 错误码枚举 | 枚举值 | 说明 | 
|---|---|---|
| kNotLoginError | 10000105 | 未登录房间 请检查是否已成功登录房间  | 
| kPublishBadNameError | 10000106 | 重复的推流流名 | 
| kFormatUrlError | 10001102 | 请联系 ZEGO 技术支持解决 | 
| kNetworkDnsResolveError | 11000404 | DNS 解析失败 请确认startPublishing 的 flag 是否为0/2,正确的情况下再检查网络是否正常  | 
| kDeniedDisableSwitchLineError | 12101005 | 禁止切换线路重推 请调用推流接口重新推流  | 
| kEngineNoPublishDataError | 12102002 | 推流无法推出数据 请检查网络是否正常  | 
| kEngineConnectServerError | 12200001 | 连接 RTMP 服务器失败 请检查网络是否正常  | 
| kEngineServerDisconnectError | 12200006 | RTMP 服务器断开连接 请检查网络是否正常  | 
| kEngineRtpConnectServerError | 12200100 | 连接 RTP 服务器失败 请检查网络是否正常  | 
| kEngineRtpHelloTimeoutError | 12200101 | 连接 RTP 服务器超时 请检查网络是否正常  | 
| kEngineRtpCreateSessionTimeoutError | 12200102 | 与 RTP 服务器创建 session 超时 请检查网络是否正常  | 
| kEngineRtpTimeoutError | 12200106 | RTP 超时 请检查网络是否正常  | 
| kMediaServerForbidError | 12301011 | ZEGO 后台禁止推流 请联系 ZEGO 技术支持解决  | 
| kMediaServerPublishBadNameError | 12301012 | 推流使用重复的流名 | 
| kConfigMediaNetworkNoUrlError | 20000005 | 请联系 ZEGO 技术支持解决 | 
| kConfigServerCouldntConnectError | 21200007 | 无法连接配置服务器 请检查网络是否正常  | 
| kConfigServerTimeoutError | 21200028 | 连接配置服务器超时 请检查网络是否正常  | 
| kDispatchServerCouldntConnectError | 31200007 | 无法连接调度服务器 请检查网络是否正常  | 
| kDispatchServerTimeoutError | 31200028 | 连接调度服务器超时 请检查网络是否正常  | 
| kLiveRoomRequestParamError | 50001001 | 房间参数错误 请联系 ZEGO 技术支持解决  | 
| kLiveRoomHBTimeoutError | 50001002 | 房间心跳超时 请检查网络是否正常  | 
| kLiveRoomNoPushServerAddrError | 50001003 | 请联系 ZEGO 技术支持解决 | 
| kLiveRoomCouldntConnectError | 51200007 | 无法连接房间服务器 请检查网络是否正常  | 
| kLiveRoomTimeoutError | 51200028 | 连接房间服务器超时 请检查网络是否正常  | 
| kLiveRoomRoomAuthError | 52000101 | 房间服务器报错,鉴权失败 请联系 ZEGO 技术支持解决  | 
| kLiveRoomNotLoginError | 52000105 | 房间服务器报错,未登录房间 请检查是否已成功登录房间  | 
| kLiveRoomAddUserError | 52001002 | 房间服务器报错,添加用户失败 请联系 ZEGO 技术支持解决  | 
| kLiveRoomNetBrokenTimeoutError | 52002003 | 房间服务器报错 请联系 ZEGO 技术支持解决  | 
| kLiveRoomPublishBadNameError | 52001012 | 房间服务器报错,重复的推流流名 | 
| kRoomConnectError | 60001001 | 无法连接房间服务器 请检查网络是否正常  | 
| kRoomTimeoutError | 60001004 | 登录房间服务器超时 请检查网络是否正常  | 
| kRoomHbTimeoutError | 60001005 | 房间服务器心跳超时 请检查网络是否正常  | 
| kRoomDecodeSignError | 62001001 | 房间服务器报错 请联系 ZEGO 技术支持解决  | 
| kRoomLoginCreateUserError | 62010001 | 房间服务器报错 请联系 ZEGO 技术支持解决  | 
| kRoomStatusRspError | 62010006 | 房间服务器报错 请联系 ZEGO 技术支持解决  | 
| kRoomMultipleLoginKickoutError | 63000001 | 重复登录房间被踢 请检查是否已登录房间  | 
调用拉流接口后,拉流回调(iOS、Android:onPlayStateUpdate,Windows:OnPlayStateUpdate)的错误码如果非0,请查看以下错误码进行相应的处理。
处理拉流回调错误码非0的情况,一般有以下两种方式:
- 可以提示拉流失败,重新拉流。
 - 加上重拉机制,比如错误码不等于0后,每隔3秒重新调用 startPlayingStream 拉流,重试5--10次左右如果还是不成功,说明当时连接不成功,可以 UI 展示用户拉流失败,让主播/观众检查网络等,稍后重新拉流。 注意:避免陷入拉流的死循环中,消耗手机内存。
 
| 错误码枚举 | 枚举值 | 说明 | 
|---|---|---|
| kNetworkDnsResolveError | 11000404 | DNS 解析失败 请检查网络是否正常  | 
| kEngineNoPlayDataError | 12102001 | 拉流无法拉到数据 请检查拉的流是否存在或者网络是否正常  | 
| kEngineConnectServerError | 12200001 | 连接 RTMP 服务器失败 请检查网络是否正常  | 
| kEngineRtmpHandshakeError | 12200002 | 请联系 ZEGO 技术支持解决 | 
| kEngineRtmpAppConnectError | 12200003 | 请联系 ZEGO 技术支持解决 | 
| kEngineServerDisconnectError | 12200006 | RTMP 服务器断开连接 请检查网络是否正常  | 
| kEngineRtpConnectServerError | 12200100 | 连接 RTP 服务器失败 请检查网络是否正常  | 
| kEngineRtpHelloTimeoutError | 12200101 | 连接 RTP 服务器超时 请检查网络是否正常  | 
| kEngineRtpCreateSessionTimeoutError | 12200102 | 与 RTP 服务器创建 session 超时 请检查网络是否正常  | 
| kEngineRtpTimeoutError | 12200106 | RTP 超时 请检查网络是否正常  | 
| kEngineHttpFlvServerDisconnectError | 12200203 | http flv 服务器断开连接 请检查网络是否正常  | 
| kPlayStreamNotExistError | 12301004 | 拉的流不存在 请检查拉取的流是否已推流成功  | 
| kMediaServerForbidError | 12301011 | ZEGO 后台禁止推流 请联系 ZEGO 技术支持解决  | 
| kConfigServerCouldntConnectError | 21200007 | 无法连接配置服务器 请检查网络是否正常  | 
| kConfigServerTimeoutError | 21200028 | 连接配置服务器超时 请检查网络是否正常  | 
| kDispatchStreamNotExistError | 32001004 | 调度服务器报错,流不存在 请检查拉取的流是否已推流成功  | 
| kLiveRoomHBTimeoutError | 50001002 | 房间心跳超时 请检查网络是否正常  | 
| kLiveRoomCouldntConnectError | 51200007 | 无法连接房间服务器 请检查网络是否正常  | 
| kLiveRoomTimeoutError | 51200028 | 连接房间服务器超时 请检查网络是否正常  | 
| kLiveRoomNotLoginError | 52000105 | 房间服务器报错,未登录房间 请检查是否已成功登录房间  | 
| kLiveRoomSessionError | 52000141 | 房间服务器报错 请联系 ZEGO 技术支持解决  | 
| kLiveRoomAddUserError | 52001002 | 房间服务器报错,添加用户失败 请联系 ZEGO 技术支持解决  | 
| kRoomConnectError | 60001001 | 无法连接房间服务器 请检查网络是否正常  | 
| kRoomTimeoutError | 60001004 | 登录房间服务器超时 请检查网络是否正常  | 
| kRoomHbTimeoutError | 60001005 | 房间服务器心跳超时 请检查网络是否正常  | 
| kRoomDecodeSignError | 62001001 | 房间服务器报错 请联系 ZEGO 技术支持解决  | 
| kRoomMultipleLoginKickoutError | 63000001 | 重复登录房间被踢 请检查是否已登录房间  | 
| 错误码枚举 | 枚举值 | 说明 | 
|---|---|---|
| kMixStreamNoneMixConfigError | 80000001 | 没有混流配置信息 | 
| kMixStreamCouldntConnectError | 81200007 | 无法连接混流服务器 请检查网络是否正常  | 
| kMixStreamTimeoutError | 81200028 | 连接混流服务器超时 请检查网络是否正常  | 
| kMixStreamSslCaCertError | 81200060 | 混流服务器 SSL 证书问题 请检查网络是否正常  | 
| kMixStreamFailError | 82000001 | 混流服务器报错,混流失败 请联系 ZEGO 技术支持解决  | 
| kMixStreamInputParamsError | 82000002 | 混流服务器报错,混流请求包解析错误 请联系 ZEGO 技术支持解决  | 
| kMixStreamAuthError | 82000003 | 混流服务器报错,混流鉴权失败 请联系 ZEGO 技术支持解决  | 
| kMixStreamNotExistError | 82000150 | 混流服务器报错,混流的输入流不存在 请检查混流的 inputStreamList 里面的流是否正在推流  | 
| kMixStreamStartMixError | 82000151 | 混流服务器报错,启动混流失败 请联系 ZEGO 技术支持解决  | 
| kMixStreamStopMixError | 82000152 | 混流服务器报错,停止混流失败 请联系 ZEGO 技术支持解决  | 
| kMixStreamInputFormatError | 82000155 | 混流服务器报错,输入分辨率格式错误 请检查输入分辨率大小是否已经大于设置的分辨率大小  | 
| kMixStreamOutputFormatError | 82000156 | 混流服务器报错,输出分辨率格式错误 请检查输出的分辨率不为空  | 
| kMixStreamNotOpenError | 82000157 | 混流服务器报错,未开启混流模式 请联系 ZEGO 技术支持解决开启混流模式  | 
| kMixStreamInputExceedError | 82000158 | 混流服务器报错,混流输入流数超出上限(默认9路) 请联系 ZEGO 技术支持解决  | 
| kMixStreamDispatchError | 82000159 | 混流服务器报错,混流调度失败 请联系 ZEGO 技术支持解决  | 
| kMixStreamStopMixOwnerError | 82000160 | 混流服务器报错,非创建者停止混流错误 请联系 ZEGO 技术支持解决  | 
| kMixStreamWaterMarkParamError | 82000170 | 混流服务器报错,混流水印参数错误 请联系 ZEGO 技术支持解决  | 
| kMixStreamWaterMarkImageError | 82000171 | 混流服务器报错,混流水印 image 错误  请联系 ZEGO 技术支持解决  | 
| kMixStreamQpsOverloadError | 82000190 | 混流服务器报错,混流请求 QPS 超限 请至少延时3秒之后再重试  | 

联系我们
文档反馈