实时语音
  • iOS : Objective-C
  • Android
  • Windows
  • 概述
  • 限制说明
  • SDK 下载
  • 快速开始
  • 进阶功能
  • API 文档
  • 常见错误码
  • 语音通话
  • 语音直播
  • 游戏语音
  • 文档中心
  • 实时语音
  • 常见错误码

常见错误码

更新时间:2023-11-29 21:53

本文针对初始化 SDK、登录房间、推拉流、混流部分列出常见错误码。

  1. 若在常见错误码中找不到相应错误,请在 完整错误码 中查找,完整错误码表中也查不到时请联系 ZEGO 技术支持。
  2. 2019-06-10(g77803827) 之前的 LiveRoom SDK 版本的错误码请查看 旧版错误码

1 初始化 SDK

调用初始化 SDK 接口后,如果初始化回调(iOS:ZegoInitSDKCompletionBlock,Android:onInitSDK,Windows:OnInitSDK)返回的错误码非0,请查看以下错误码并进行相应处理。

错误码枚举 枚举值 说明
kConfigServerCouldntConnectError 21200007 无法连接配置服务器
请检查网络是否正常
kConfigServerTimeoutError 21200028 连接配置服务器超时
请检查网络是否正常
kConfigDecryptError 20000001 配置文件解密失败
请检查 AppID 和 AppSign 是否正确
无法解决请联系 ZEGO 技术支持解决

2 登录房间

调用登录房间接口后,登录回调(iOS:ZegoLoginCompletionBlock,Android:onLoginCompletion,Windows:OnLoginRoom)返回的错误码如果非0,请先查看以下错误码并进行相应的处理。

当登录回调的错误码非0时,若是网络问题,可按以下方法处理:

  1. 可以提示用户稍后再试。
  2. 可以考虑重试,比如失败了,隔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 类型错误
请检查参数的数据类型

3 推流

调用推流接口后,推流回调(iOS、Android:onPublishStateUpdate,Windows:OnPublishStateUpdate)的错误码如果非0,请查看以下错误码进行相应的处理。

处理推流回调错误码非0的情况,一般有以下两种方式:

  1. 可以提示主播推流失败,重新推流。
  2. 加上重推机制,比如错误码不等于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 重复登录房间被踢
请检查是否已登录房间

4 拉流

调用拉流接口后,拉流回调(iOS、Android:onPlayStateUpdate,Windows:OnPlayStateUpdate)的错误码如果非0,请查看以下错误码进行相应的处理。

处理拉流回调错误码非0的情况,一般有以下两种方式:

  1. 可以提示拉流失败,重新拉流。
  2. 加上重拉机制,比如错误码不等于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 重复登录房间被踢
请检查是否已登录房间

5 混流

错误码枚举 枚举值 说明
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秒之后再重试
本篇目录