实时音视频
  • iOS
  • Android
  • macOS
  • Windows
  • HarmonyOS
  • Linux
  • Web : JavaScript
  • 小程序
  • Flutter
  • Electron
  • Unity3D
  • uni-app
  • React Native
  • Cocos Creator
  • 产品简介
  • 下载
  • 体验 App
  • 快速开始
    • 跑通示例源码
    • 集成 SDK
    • 实现视频通话
    • 场景化音视频配置
  • 基础功能
  • 进阶功能
  • 最佳实践
  • 常见错误码
  • 服务端 API
  • 客户端 API
  • 常见问题

常见错误码

更新时间:2022-12-22 16:58

简介

当 SDK 运行出现网络、媒体相关等错误时,SDK 无法自动恢复,需要 App 干预或进行用户提示。调用接口后返回结果存在错误信息、事件回调中有错误信息或 console 日志中出现错误日志,则表示该接口调用异常。

  • 调用接口后返回错误信息示例代码:
const { errorCode, extendedData } = await zg.setCaptureVolume(stream, result);
// errorCode 为错误码,extendedData 为错误描述信息
console.log(errorCode, extendedData); 
  • 调用接口后抛出错误信息示例代码:
try {
    await zg.setCaptureVolume(stream, result);
} catch (error) {
    // errorCode 为错误码,extendedData 为错误描述信息
    const { errorCode, extendedData } = error;
    console.log(errorCode, extendedData); 
}
  • 事件回调中错误信息示例代码:
zg.on('roomStateChanged', (roomID, reason, errorCode, extendedData) => {
    if (errorCode !== 0) {
      // errorCode 为错误码,extendedData 为错误描述信息
      console.log(errorCode, extendedData); 
    }
})

1000xxx/1100xxx 通用错误码

通用类错误码为接口通用错误的错误码,通常在调用 startPublishingStreamstartPlayingStream 接口会出现,请根据以下错误码并进行相应处理。

错误码 描述
0 执行成功。
1000002 描述:未登录房间。
可能原因:没有登录房间或者房间异常断开。
处理建议:在调用推流或拉流前,请先调用 loginRoom 登录房间。
1000014 描述:输入 StreamID 超长。
可能原因:在调用 startPublishingStreamstartPlayingStream 时传入的 StreamID 参数长度超过限制。
处理建议:StreamID 最大支持输入 256 个字符,检查调用函数时传入的 StreamID 参数是否过长。
1000015 描述:输入流 ID 为空。
可能原因:在调用 startPublishingStreamstartPlayingStream 时传入的 StreamID 参数为 undefined、null 或空字符串。
处理建议:检查调用函数时传入的 streamID 参数是否正常。
1000016 描述:输入流 ID 包含非法字符。
可能原因:在调用 startPublishingStreamstartPlayingStream 时传入的 StreamID 包含非法字符。
处理建议:检查调用函数时传入的 StreamID 参数是否正常,仅支持数字、英文字符和 "-"、"_"。
1000017 描述:网络断开。
可能原因:网络异常或推拉流与媒体协商失败。
处理建议:检查网络是否正常。
1000018 描述:本地流错误。
可能原因:Web 端错误码,传入流对象错误或者流对象并不是 SDK 创建。
处理建议:Web 端:检查打印流对象是否正常 并确认是否是 createStream 接口生成;一般发生在 destroyStreamsetVideoConfiguseVideoDeviceuseAudioDevice 接口。
1000019 描述:获取音浪失败。
可能原因:获取音浪失败。
处理建议:一般是浏览器器兼容性问题,请尝试切换浏览器验证。
1100001 描述:参数错误。
可能原因:传参错误。
处理建议:检查打印传参,在 extendedData 中查看具体错误字段。
1100002 描述:请求响应超时。
可能原因:SDK请求服务端超时,可能是由于网络原因导致。
处理建议:请尝试切换网络解决。
1100003 描述:socket 关闭。
可能原因:可能是由于网络原因导致 SDK 与服务器建立的 socket连接被关闭。
处理建议:请尝试切换网络解决。
1100999 描述:服务端未知错误。
可能原因:一般是服务端错误。
处理建议:请联系 ZEGO 技术支持。

1101xxx 调试阶段错误码

调试阶段错误码指的是开发者在开发应用期间容易出现的错误,一般表现为接口参数出错等。

错误码 描述
1001004 描述:认证失败。
可能原因:AppID 不正确。
处理建议:检查传入的 AppID 是否与 ZEGO 控制台中的 AppID 一致。
1101000 描述:SDK 初始化失败。
可能原因:AppID 不正确导致。
处理建议:请检查 AppID 是否正确
1101001 描述:微信小程序 getSetting 方法调用失败,无法检测摄像头和麦克风功能是否正常。
可能原因:小程序初始化失败、微信版本过低或者未获取推拉流组件权限。
处理建议:请尝试升级微信版本并检查是否有组件权限。
1101002 描述:获取流媒体服务配置失败。
可能原因:获取流媒体服务配置失败。
处理建议:请联系 ZEGO 技术支持。

1002xxx/1102xxx 房间相关错误码

调用 loginRoom 接口时出错,通常为登录房间参数错误,以及 SDK 与 ZEGO 房间服务端通讯出现的异常。

错误码 描述
1002001 描述:登录房间数量超过上限。
可能原因:当前仅支持同时登录 1 个主房间和 1 个多房间。
处理建议:请检查当前用户是否登入了过多房间
1002005 描述:输入用户 ID 为空。
可能原因:输入的用户 ID 为空字符串或没有输入用户 ID。
处理建议:检查用户 ID 是否为空。
1002006 描述:输入用户 ID 包含非法字符。
可能原因:输入用户 ID 包含非法字符。
处理建议:请检查用户ID是否正确。用户 ID 最大为64 字节的字符串,仅支持数字,英文字符 和 '~', '!', '@', '#', '$', '', '^', '&', '*', '(', ')', '_', '+', '=', '-', ';', '’', ',', '.' 。
1002007 描述:输入用户 ID 超长。
可能原因:输入用户 ID 超长。
处理建议:请检查用户ID是否过长,最大长度应小于 64 字节。
1002008 描述:输入用户名为空。
可能原因:输入用户名为空。
处理建议:请检查用户名是否为空。
1002010 描述:输入用户名超长。
可能原因:输入用户名超长。
处理建议:请检查输入的用户名是否超长,最大长度应小于 256 字节。
1002011 描述:输入房间 ID 为空。
可能原因:输入房间 ID 为空。
处理建议:请检查房间ID是否为空。
1002012 描述:输入房间 ID 包含非法字符。
可能原因:输入房间 ID 包含非法字符。
处理建议:仅支持数字,英文字符 和 '~', '!', '@', '#', '$', '', '^', '&', '*', '(', ')', '_', '+', '=', '-', ', ';', '’', ',', '.', '<', '>', '/' 。
1002013 描述:输入房间 ID 超长。
可能原因:输入房间 ID 超长。
处理建议:请检查输入房间 ID 是否超长,最大长度应小于 128 字节。
1002014 描述:房间未登录或房间已断开。
可能原因:当前房间不存在。
处理建议:请联系 ZEGO 技术支持。
1002031 描述:登录房间超时。
可能原因:可能是由于网络原因导致。
处理建议:请尝试切换网络重试。
1002034 描述:登录房间的用户超过最大数量。
可能原因:登录房间的用户数超过该房间配置的最大用户数量限制(测试环境下默认房间最大用户数为 50,正式环境无限制)。
处理建议:请联系 ZEGO 技术支持,检查房间人数是否超过限制。
1002036 描述:登录失败,多房间功能没有开通。
可能原因:多房间功能未开通。
处理建议:请联系 ZEGO 技术支持。
1002050 描述:用户被踢出房间。
可能原因:可能是相同用户 ID 在其他设备登录。
处理建议:请联系 ZEGO 技术支持。
1002053 描述:重试登录房间超过最大的重试时间。
可能原因:可能是由于网络原因导致。
处理建议:请尝试切换网络重试。
1002055 描述:业务后台发出了踢出房间信令。
可能原因:客户调用服务端踢人接口,触发服务端下发 kickout 信令。
处理建议:请查看被踢原因,联系 ZEGO 技术支持。
1002056 描述:用户重复进行登录。
可能原因:未登出主房间再次调起登录主房间。
处理建议:请排查登录逻辑,建议在登录与登出逻辑处断点或者打印进行调试。
1002099 描述:系统内部异常导致房间登录失败。
可能原因:服务端返回未约定错误码,错误信息在 extendedData。
处理建议:请联系 ZEGO 技术支持。
1102001 描述:心跳超时。
可能原因:可能是由于网络原因导致,默认 90 秒内未收到房间心跳回包会触发心跳超时。
处理建议:请尝试切换网络重试。
1102011 描述:数据格式错误。
可能原因:数据格式错误。
处理建议:请联系 ZEGO 技术支持。
1102012 描述:正在执行登录流程。
可能原因:房间正在登录进行中。
处理建议:联系 ZEGO 技术支持。
1102013 描述:房间信令请求错误。
可能原因: 可能是由于网络原因导致。
处理建议:尝试切换网络重试或者联系 ZEGO 技术支持。
1102014 描述:ZPush 失败。
可能原因:ZPush 失败。
处理建议:请联系 ZEGO 技术支持。
1102015 描述:用户登录状态错误。
可能原因:登录状态错误。
处理建议:请联系 ZEGO 技术支持。
1102016 描述:登录 token 格式有误
可能原因:登录 token 格式有误。
处理建议:token 获取方式:Web 端请参考 用户权限控制,小程序端请参考 用户权限控制
1102017 描述:调度失败。
可能原因:媒体节点调度失败。
处理建议:请拿着推拉流状态回调吐出的错误码,联系 ZEGO 技术支持。
1102018 描述:登录 token 过期。
可能原因:登录 token 过期,推拉流过程也可能出现该错误。
处理建议:及时调用 renewToken 接口来更新 token。
1102019 描述:subcmd 错误。
可能原因:subcmd 错误。
处理建议:请联系 ZEGO 技术支持。
1102020 描述:登录鉴权失败。
可能原因:登录鉴权失败。
处理建议:请联系 ZEGO 技术支持。
1102021 描述:biz_channel 错误。
可能原因:biz_channel 错误。
处理建议:请联系 ZEGO 技术支持。
1102022 描述:调用请求超时。
可能原因:可能是由于网络原因导致。
处理建议:请尝试切换网络后重试。
1102023 描述:连接媒体服务器失败。
可能原因:可能是由于网络原因导致。
处理建议:请尝试切换网络后重试。

1003xxx/1103xxx 推流相关的错误码

调用推流接口后,或者在推流过程中出现异常,开发者可从 publisherStateUpdate 回调获取相关错误码,请根据以下错误码进行相应处理。

处理推流回调错误码非 0 的情况:

  1. 当 “state” 为 “NO_PUBLISH” 时,且 “errorCode” 非 0,表示推流失败,同时不会再进行重试推流了,此时可在界面作出推流失败提示。
  2. 当 “state” 为 “PUBLISH_REQUESTING” 时,且 “errorCode” 非 0,表示在重试推流,此时如果超出重试时间未成功推流会抛出推流失败通知。
错误码 描述
1003025 描述:ZEGO 后台禁止推流。
可能原因:开启了推流鉴权,流被媒体服务器禁止。
处理建议:若不是开发者调接口禁止的,请联系 ZEGO 技术支持解决。
1003050 描述:流附加信息为 null。
可能原因:流附加信息为 null。
处理建议:请检查流附加信息是否为正常。
1003051 描述:流附加信息超长。
可能原因:流附加信息超长。
处理建议:请检查对应的流附加信息是否太长 ,最大是 128 字节。
1103001 描述:推流参数错误。
可能原因:推流参数错误。
处理建议:在传参错误的 extendedData 中查看具体错误字段。
1103002 描述:浏览器不支持。
可能原因:
  1. 没有通过 https 或 locahost 的方式访问。
  2. 不支持你的浏览器版本。

处理建议:
  1. 请将项目部署在 https 服务器下,或者使用 localHost 访问。
  2. 如果上述问题还不能解决,请更换或者升级浏览器。
1103003 描述:媒体连接失败。
可能原因:可能由于网络原因导致。
处理建议:请尝试切换网络后重试。
1103010 描述:屏幕共享失败。
可能原因:推屏幕流失败,参数设备不支持,使用插件推但并没装插件 extendedData 查看具体错误信息。
处理建议:请联系 ZEGO 技术支持。
1103011 描述:设备信息枚举失败。
可能原因:获取设备列表枚举设备失败。
处理建议:拿到 console 里面具体错误信息,联系 ZEGO 技术支持。
1103020 描述:获取媒体服务地址失败。
可能原因:获取媒体服务地址失败。
处理建议:拿到 console 里面具体错误信息,联系 ZEGO 技术支持。
1103021 描述:媒体服务连接失败。
可能原因:推拉流与媒体创建会话失败。
处理建议:拿到 console 里面具体错误信息,联系 ZEGO 技术支持。
1103022 描述:offer 创建失败。
可能原因:浏览器不兼容。
处理建议:切换浏览器或者拿到 console 里面获取具体错误信息,联系 ZEGO 技术支持。
1103023 描述:设置本地 SDP 失败。
可能原因:浏览器不兼容。
处理建议:切换浏览器或者拿到 console 里面获取具体错误信息,联系 ZEGO 技术支持。
1103024 描述:SDP 发送失败。
可能原因:与网关交互的 mediaDesc 失败。
处理建议:请联系 ZEGO 技术支持。
1103025 描述:远端 SDP 错误。
可能原因:浏览器不兼容。
处理建议:切换浏览器或者拿到 console 里面获取具体错误信息,联系 ZEGO 技术支持。
1103026 描述:webrtc 连接使用的 candidate 信息错误。
可能原因:与网关交互 candidate 失败。
处理建议:请联系 ZEGO 技术支持。
1103027 描述:媒体连接关闭。
可能原因:SDK 与网关断开。
处理建议:请联系 ZEGO 技术支持。
1103028 描述:ice 连接失败。
可能原因:UDP 断开,可能是因为网络原因,也可能由于网关主动断开。
处理建议:尝试切换网络重试,或者请联系 ZEGO 技术支持。
1103029 描述:推流参数设置错误。
可能原因:1.参数有问题 2.设置的参数设备不支持。
处理建议:拿到 console 里面获取具体错误信息,联系 ZEGO 技术支持。
1103030 描述:推流失败重试超时。
可能原因:可能是由于网络原因导致协商超时或是未知问题阻塞流程。
处理建议:请尝试切换网络重试,或者联系 ZEGO 技术支持。
1103040 描述:未推流时修改参数。
可能原因:改变推流参数时推流未找到,可能是调用时没有在推流导致。
处理建议:请检查在调用时是否有在推流。
1103041 描述:设备插拔或松动。
可能原因:设备插拔或松动。
处理建议:检查设备是否有插稳或是有接触不良的情况。
1103042 描述:用户主动取消了屏幕共享。
可能原因:屏幕共享时在弹框选取时主动点击取消。
处理建议:请检查是否符合当前业务逻辑,若符合则无需解决。
1103043 描述:当前浏览器不支持屏幕共享。
可能原因:当前浏览器不支持创建屏幕流。
处理建议:更新或者切换浏览器。
1103044 描述:不是通过 createStream 创建的流。
可能原因:Web 端报错,流不是通过 createStream 接口生成。
处理建议:Web 端:
1. 明确流的来源,确保流是由 createStream 接口生成。
2. createStream 是异步操作返回的是 promise,需要保证在 then 之后或者 await 之后,再去推流。
1103045 描述:媒体流不含视频。
可能原因:切换设备时流并未包含视轨,一般发生在调用 switchDevice 接口,创建流的时候使用参数 video:false。
处理建议:请检查流是否包含了视轨。
1103046 描述:媒体流不含音频。
可能原因:切换设备时流并未包含音轨,一般发生在调用 switchDevice 接口,创建流的时候使用参数 audio:false。
处理建议:请检查流是否包含了音轨。
1103047 描述:找不到 MediaStreamTrack 对象。
可能原因:可能在修改参数时,流并未包含对应类型轨,Web 端一般发生在调用 replaceTrack 接口时。
处理建议:请检查流是否包含了对应的类型轨,或者联系 ZEGO 技术支持。
1103048 描述:找不到设备。
可能原因:切换设备时,设备 ID 不存在,可能发生在调用 switchDevice 接口,创建流的时候传参有误。
处理建议:请检查设备 ID 是否存在,或者联系 ZEGO 技术支持。
1103049 描述:重复拉取同一条流。
可能原因:可能是重复拉流或者之前拉流并未停止拉流。
处理建议:请检查拉流的逻辑是否正确,确认是否有重复拉流的情况。
1103050 描述:websocket 断开连接。
可能原因:可能是网络问题导致的媒体节点 socket 断开。
处理建议:请尝试切换网络后重试。
1103051 描述:推流重试超时。
可能原因:一般是网络原因。
处理建议:请尝试切换网络后重试。如果大量出现,请联系 ZEGO 技术支持。
1103052 描述:CDN 推流错误。
可能原因:可能上转推cdn类型参数错误,cdnPublishConfig.type=["addpush" | "delpush" | "clearpush"]。
处理建议:请检查参数是否正确。
1103053 描述:必须使用 HTTPS 协议。
可能原因:webrtc 官方只允许 HTTPS 请求设备。
处理建议:请求使用 HTTPS。
1103054 描述:没有预览。
可能原因:修改推流参数和状态时,推流不存在。
处理建议:排查推流逻辑保证在推流成功再去调用;检查传参是否正确。
1103055 描述:找不到推流。
可能原因:推流没有被找到、设置流额外信息和转推 CDN(动态转推)的时候会报错。
处理建议:排查推流逻辑保证在推流成功再去调用;检查传参是否有问题。
1103056 描述:正在推流中。
可能原因:重复推流或者之前推流并未停止推流。
处理建议:请检查推流逻辑是否正确。
1103057 描述:本地混音音效资源解码失败。
可能原因:音频资源格式不正确,或浏览器不兼容导致。
处理建议:尝试切换浏览器或者联系 ZEGO 技术支持。
1103058 描述:客户端 IP 发生变化。
可能原因:客户端 IP 发生变化。
处理建议:检查客户端 IP 是否有发生变动。
1103059 描述:推流网络节点过期。
可能原因:推流网络节点过期。
处理建议:联系 ZEGO 技术支持。
1103060 描述:session 请求超时。
可能原因:session 请求超时。
处理建议:尝试切换网络后重试或者联系 ZEGO 技术支持。
1103061 描述:获取媒体失败。
可能原因:
1、在 iphone12.1 版本,创建流时,如果参数不在设备参数内有可能会报错,例如,手机只有 720p,接口 createStream 参数传入 1080p 的分辨率。
2、创建流时报错:NotReadableError,could not start audio source
处理建议:1、检查创建流的参数;2、拿到 console 中的错误信息,联系 ZEGO 技术支持。
1103064 描述:媒体流没有设备权限。
可能原因:媒体流没有设备权限,一般是 Web 端接口 createStream 报错。
处理建议:检查是否有给设备权限。
1103065 描述:设备不可用于采集媒体流。
可能原因:可能是您当前的摄像头或麦克风被其他应用占用 。
处理建议:检查摄像头或麦克风是否正在被占用。
1103066 描述:创建流的设备参数错误。
可能原因:创建流的设备参数错误或者设备无法满足。
处理建议:尝试检查或更换参数后重试。
1103072 描述:不支持开启美颜功能。
可能原因:您当前使用的浏览器不支持美颜功能。
处理建议:请参考 基础美颜 中的浏览器兼容性说明,使用对应版本的浏览器开启美颜功能。
1103073 描述:美颜功能正在启动中。
可能原因:由于设置美颜接口是异步执行的,媒体流的美颜功能开启还没完成的时候调用 startPublishingStream 接口推流,推流画面无法预期是否为美颜画面。
处理建议:如果需要在推流前开启美颜,需要先等待美颜异步启动完成后再调用推流接口进行推流。可参考 基础美颜 中的示例代码。
1103074 描述:当前视轨不支持开启美颜。
可能原因:当前视轨不支持开启美颜,在启动时报错,SDK 会关闭美颜。
处理建议:尝试更换设备或视轨后重试或者联系 ZEGO 技术支持。
1103075 描述:美颜性能过载。
可能原因:美颜性能过载。
处理建议:美颜性能过载时画面会卡顿,SDK 不会关闭美颜,开发者可自行判断是否关闭美颜能力。
1103080 描述:AI 降噪运行时错误。
可能原因:AI 降噪运行时报错。
处理建议:请联系 ZEGO 技术支持。
1103081 描述:不支持 AI 降噪。
可能原因:可能因为当前浏览器其不支持一些 API,导致的 AI 降噪初始化操作失败
处理建议:使用最新版的 Google Chrome 浏览器和 Edge 浏览器。
1103082 描述:AI 降噪性能过载。
可能原因:AI 降噪过载。
处理建议:AI 降噪过载时会出现音频卡顿或音画不同步的现象,SDK 不会关闭 AI 降噪,开发者可自行判断是否关闭 AI 降噪能力。

1104xxx 拉流相关错误码

调用拉流接口后,或者在拉流中途出现异常,开发者可从 playerStateUpdate 拉流状态回调获取相关错误码,请根据以下错误码进行相应的处理。

错误码 描述
1104001 描述:拉流参数错误。
可能原因:拉流参数错误。
处理建议:请尝试检查 console 中打印的传参是否正确,extendedData 中可以查看的具体错误字段。
1104020 描述:获取媒体服务地址失败。
可能原因:调度媒体节点失败,有可能是网络问题导致的。
处理建议:可以尝试切换网络后重试,如果无法解决请联系 ZEGO 技术支持。
1104021 描述:媒体服务连接失败。
可能原因:推拉流与媒体创建会话失败。
处理建议:联系 ZEGO 技术支持。
1104022 描述:offer 创建失败。
可能原因:可能是浏览器不兼容导致的。
处理建议:请尝试切换或者升级浏览器后重试。
1104023 描述:设置本地 SDP 失败。
可能原因:可能是浏览器不兼容导致的。
处理建议:请尝试切换或者升级浏览器后重试。
1104024 描述:SDP 发送失败。
可能原因:与网关交互的 mediaDesc 失败导致。
处理建议:请联系 ZEGO 技术支持。
1104025 描述:远端 SDP 错误。
可能原因:可能是浏览器不兼容导致的。
处理建议:请尝试切换或者升级浏览器后重试。
1104026 描述:candidate 错误。
可能原因:与网关交互 candidate 失败导致。
处理建议:请联系 ZEGO 技术支持。
1104027 描述:媒体连接关闭。
可能原因:SDK 与网关断开。
处理建议:请联系 ZEGO 技术支持。
1104028 描述:ice 连接失败。
可能原因:一般是1.网络原因 2.网关主动断开。
处理建议:请尝试切换网络重试或者联系 ZEGO 技术支持。
1104029 描述:与媒体服务断开连接。
可能原因:一般是网络原因导致。
处理建议:请尝试切换网络后重试。
1104030 描述:服务端协商超时。
可能原因:可能是网络原因导致也可能由未知问题阻塞了流程。
处理建议:请尝试切换网络重试或者联系 ZEGO 技术支持。
1104031 描述:拉流失败重试超时。
可能原因:媒体节点连接不成功导致,一般是网络原因。
处理建议:请尝试切换网络重试或者联系 ZEGO 技术支持。
1104032 描述:已经在拉流中。
可能原因:重复拉流或者之前拉流并未停止拉流。
处理建议:请尝试排查拉流逻辑是否正确。
1104033 描述:客户端 IP 发生变化。
可能原因:客户端 IP 发生变化。
处理建议:请检查客户端 IP 是否有变动。
1104034 描述:拉流网络节点过期。
可能原因:拉流网络节点过期。
处理建议:请联系 ZEGO 技术支持。
1104035 描述:重置 session 推送。
可能原因:重置 session 推送。
处理建议:请联系 ZEGO 技术支持。
1104036 描述:请求 session 超时。
可能原因:一般是网络原因导致。
处理建议:请尝试切换网络重试。
1104037 描述:质量探测超时。
可能原因:可能是网络原因导致。
处理建议:请尝试切换网络重试。
1104038 描述:当前 AppID 不支持 L3(Low-Latency Live Streaming,低延迟直播) 模式拉流。
可能原因:不支持的资源模式,标识当前 AppID 不支持 L3(Low-Latency Live Streaming,低延迟直播) 模式拉流。
处理建议:如有需要请联系 ZEGO 技术支持开启。
1104039 描述:拉流不存在,小程序中该错误码表示拉流失败。
可能原因:可能是重复拉流或者是房间不存在导致。
处理建议:请检查是否存在重复拉流或房间不存在。

1005xxx 混流相关错误码

调用开始混流 startMixerTask 和停止混流 stopMixerTask 接口返回结果可能出现的错误。

错误码 描述
1005000 描述:无混流服务。
可能原因:当前 AppID 无混流服务。
处理建议:如有需要请联系 ZEGO 技术支持开启。
1005001 描述:混流任务 ID 为空。
可能原因:混流任务 ID 为空。
处理建议:请检查是否有在混流或者联系 ZEGO 技术支持开启。
1005002 描述:混流任务 ID 超长。
可能原因:混流任务 ID 超长,最大为 256 个字符。
处理建议:请检查混流任务 ID 是否过长。
1005003 描述:混流任务 ID 中含有非法字符。
可能原因:混流任务 ID 中含有非法字符。
处理建议:请检查混流任务 ID 是否有含有非法字符,仅支持数字,英文字符 和 '~', '!', '@', '#', '$', '', '^', '&', '*', '(', ')', '_', '+', '=', '-', ';', '’', ',' 。
1005005 描述:混流任务配置未指定输出。
可能原因:可能是 outputConfig 配置不正确。
处理建议:请检查 outputConfig 是否正确配置。
1005006 描述:混流输出目标有误。
可能原因:有可能在 “target” 为 “streamID” 时,传入了非法字符。
处理建议:请检查混流输出目标的 target 是否为 streamID 类型,如果是,请检查是否传入了非法字符,仅支持数字、英文字符和 "-"、"_"。
1005010 描述:启动混流任务请求失败。
可能原因:可能是网络问题导致的。
处理建议:请尝试切换网络后重试。
1005011 描述:停止混流任务请求失败。
可能原因:可能是由于网络原因导致。
处理建议:请尝试切换网络后重试。
1005012 描述:该混流任务必须由该任务的启动用户执行停止操作。
可能原因:可能是多个用户执行了混流和停止混流操作。
处理建议:请检查混流和停止混流逻辑,确保是同一个 UserID 操作。
1005020 描述:混流任务输入流列表为空。
可能原因:可能是混流任务输入流列表的数据类型不符合格式导致。
处理建议:请检查混流任务输入流列表 inputList 是否符合官网格式。
1005021 描述:混流任务输出列表为空。
可能原因:可能是混流任务输出流列表的数据类型不符合格式导致。
处理建议:请检查混流任务输出流列表 outputList 是否符合官网格式。
1005023 描述:混流任务视频配置无效。
可能原因:可能是混流任务视频编码格式错误导致。
处理建议:检查混流的视频编码格式是否是"h264"或"VP8"。
1005025 描述:超过最大的输入流数量。
可能原因:输入流数量超过限制导致。
处理建议:请检查输入流数量,最大支持 9 个输入流。
1005026 描述:输入流不存在。
可能原因:混流任务输入的流不存在。
处理建议:请检查混流任务输入流列表 inputList 里的流是否存在。
1005027 描述:混流输入参数错误。
可能原因:可能是输入流的布局超过画布范围。
处理建议:请检查输入流的布局是否正常。
1005030 描述:超过最大的输出流数量。
可能原因:输出流数量超过限制导致。
处理建议:请检查输出流数量,最大支持 3 个输出流。
1005050 描述:混流认证失败。
可能原因:可能是混流配置不正确。
处理建议:检查混流的配置或者联系 ZEGO 技术支持。
1005067 描述:输入背景图 URL 非法。
可能原因:输入背景图 URL 非法导致。
处理建议:请检查背景图 URL 是否合法,必须以 “preset-id://” 开头且需要是 .jpg 或 .png 结尾。
1005070 描述:未找到自动混流服务器。
可能原因:可能是自动混流服务器没有配置导致。
处理建议:请联系 ZEGO 技术支持配置。
1005099 描述:混流内部错误。
可能原因:有可能能是混流输入重复导致。
处理建议:请检查混流任务输入流列表 inputList 是否正确或者联系 ZEGO 技术支持。

1006xxx 设备错误

推流、拉流过程可能会造成使用的音视频设备出错,当开发者收到 deviceError 设备异常回调参数的 “errorCode” 不为 0 时,请根据以下错误码进行相应的处理。

错误码 描述
1006006 描述:设备被拔出。
可能原因:设备被拔出。
处理建议:请检查设备是否接触良好。

1009xxx/1109xxx IM 错误

发送 IM 消息过程中出现的错误。

错误码 描述
1009001 描述:消息内容为空。
可能原因:消息内容不能为空。
处理建议:请检查消息内容是否为空。
1009002 描述:消息内容超长。
可能原因:消息内容超长。
处理建议:请检查发送的消息内容是否太长。
1009010 描述:发送消息失败。
可能原因:发送消息失败。
处理建议:请联系 ZEGO 技术支持。
1109001 描述:消息频率受限。
可能原因:消息发送过于频繁。
处理建议:请检查消息发送逻辑是否正确,降低消息发送的频次。

其他错误码

错误码 描述
1 描述:转换 JSON 出错。
可能原因:转换 JSON 出错。
处理建议:请联系 ZEGO 技术支持。
1008 描述:token 错误。
可能原因:token 不正确。
处理建议:请检查传入的 token 是否正确,或者检查 token 生成是否正常。
1009 描述:调度出错。
可能原因:调度出错。
处理建议:请联系 ZEGO 技术支持。
10010 描述:token 过期。
可能原因:可能是长时间未刷新 token 导致 token 过期。
处理建议:检查应用逻辑,在 token 即将过期时及时刷新。
10011 描述:token 格式错误。
可能原因:token 格式不正确。
处理建议:请检查 token 传参是否正常,检查 token 生成的格式是否符合官网要求。