Agora Web SDK 在调用 API 或运行时,可能会返回错误或警告代码:

  • 错误码 意味着 SDK 遭遇不可恢复的错误,需要应用程序干预,例如打开摄像头失败会返回错误,应用程序需要提示用户不能使用摄像头。

  • 警告码 意味着 SDK 遇到问题,但有可能恢复,警告代码仅起告知作用,一般情况下应用程序可以忽略警告代码。

错误码

错误码 描述
STREAM_ALREADY_PUBLISHED / 重复 Publish
INVALID_LOCAL_STREAM / Stream 不合法
INVALID_OPERATION / 未加入频道,或重复加入频道
PUBLISH_STREAM_FAILED / Publish 失败
PEERCONNECTION_FAILED / P2P 连接断开
STREAM_NOT_YET_PUBLISHED / 尚未 Publish
UNPUBLISH_STREAM_FAILED / Unpublish 失败
INVALID_REMOTE_STREAM / 远端 Stream 不合法
SUBSCRIBE_STREAM_FAILED / Subscribe 失败
NO_SUCH_REMOTE_STREAM / 频道里没有这个 Remote 流
UNSUBSCRIBE_STREAM_FAILED / Unsubscribe 失败
INVALID_PARAMETER / 参数类型不正确
JOIN_TOO_FREQUENT / 加入频道过于频繁
IOS_NOT_SUPPORT / iOS Safari 不支持小流
STILL_ON_PUBLISHING / 无法在发流的过程中,打开或者关闭小流
ENABLE_DUALSTREAM_FAILED / 打开小流失败
SHARING_SCREEN_NOT_SUPPORT / 屏幕共享不支持小流
LOW_STREAM_ALREADY_PUBLISHED / 小流已经 Publish
HIGH_STREAM_NOT_VIDEO_TRACE / 无法获取大流的轨道
NOT_FIND_DEVICE_BY_LABEL / 无法找到大流的设备
DISABLE_DUALSTREAM_FAILED / 关闭小流失败
LOW_STREAM_NOT_YET_PUBLISHED / 小流没有 Publish
ERR_JOIN_CHANNEL_TIMEOUT 2002 加入频道超时
ERR_FAILED 1 一般性的错误 (没有明确归类的错误原因)
ERR_INVALID_VENDOR_KEY 101 App ID 无效
ERR_INVALID_CHANNEL_NAME 102 指定的频道名无效
ERR_DYNAMIC_KEY_TIMEOUT 109 Channel Key 或者 Token 失效。生成密钥后需要在一天内使用,超过一天后使用会出现该错误。
ERR_NO_AUTHORIZED 110 Channel Key 或者 Token 未经授权
ERR_NO_ACTIVE_STATUS 116 厂商注册的 App ID 未激活
ERR_INVALID_UID 117 非法的 UID
ERR_DYNAMIC_KEY_EXPIRED 118 Channel Key 或者 Token 服务过期
ERR_STATIC_USE_DYNAMIC_KEY 119 静态厂商使用了动态 Key
ERR_DYNAMIC_USE_STATIC_KEY 120 动态厂商使用了静态 Key
K_TIMESTAMP_EXPIRED 2 Channel Key 或者 Token 服务过期
K_CHANNEL_PERMISSION_INVALID 3 无权利加入频道,具体解决办法请咨询频道管理员
K_CERTIFICATE_INVALID 4 App 证书无效
K_CHANNEL_NAME_EMPTY 5 频道名为空
K_CHANNEL_NOT_FOUND 6 未找到指定的频道
K_TICKET_INVALID 7 凭证无效
K_CHANNEL_CONFLICTED 8 频道有冲突
K_SERVICE_NOT_READY 9 无法提供服务
K_SERVICE_TOO_HEAVY 10 服务负载过大
K_UID_BANNED 14 UID 被禁用
K_IP_BANNED 15 IP 被禁用
K_CHANNEL_BANNED 16 频道被禁用

警告码

警告码 描述
WARN_NO_AVAILABLE_CHANNEL 103 没有可用的频道资源。可能是因为服务端没法分配频道资源
WARN_LOOKUP_CHANNEL_TIMEOUT 104 查找频道超时。在加入频道时 SDK 先要查找指定的频道,出现该警告一般是因为网络太差,连接不到服务器
WARN_LOOKUP_CHANNEL_REJECTED 105 查找频道请求被服务器拒绝。服务器可能没有办法处理这个请求或请求是非法的
WARN_OPEN_CHANNEL_TIMEOUT 106 打开频道超时。查找到指定频道后,SDK 接着打开该频道,超时一般是因为网络太差,连接不到服务器
WARN_OPEN_CHANNEL_REJECTED 107 打开频道请求被服务器拒绝。服务器可能没有办法处理该请求或该请求是非法的
WARN_REQUEST_DEFERRED 108 用户申请延迟