ErrorCode

ErrorCode

错误代码。

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

枚举值

ERR_OK

0：没有错误。

ERR_FAILED

1：一般性的错误（没有明确归类的错误原因）。请重新调用方法。

ERR_INVALID_ARGUMENT

2：方法中设置了无效的参数。例如指定的频道名中含有非法字符。请重新设置参数。

ERR_NOT_READY

3：SDK 尚未准备好。可能的原因有：

• RtcEngine 初始化失败。请重新初始化 RtcEngine。
• 调用方法时用户尚未加入频道。请检查方法的调用逻辑。
• 音频模块未开启。
• 程序集不完整。

ERR_NOT_SUPPORTED

4：RtcEngine 当前状态不支持该操作。可能的原因有：

• 使用内置加密时，设置的加密模式不正确，或加载外部加密库失败。请检查加密的枚举值是否正确，或重新加载外部加密库。

ERR_REFUSED

5：方法调用被拒绝。可能的原因有：

• RtcEngine 初始化失败。请重新初始化 RtcEngine。
• 在加入频道时，将频道名设为空字符 ""。请重新设置频道名。
• 多频道场景下，在调用 joinChannelEx 方法加入频道时，设置的频道名已存在。请重新设置频道名。

ERR_BUFFER_TOO_SMALL

6：缓冲区大小不足以存放返回的数据。

ERR_NOT_INITIALIZED

7：RtcEngine 尚未初始化就调用方法。请确认在调用该方法前已创建 RtcEngine 对象并完成初始化。

ERR_NO_PERMISSION

9：没有操作权限。请检查用户是否授予了 App 音视频设备的使用权限。

ERR_TIMEDOUT

10： 方法调用超时。有些方法调用需要 SDK 返回结果，如果 SDK 处理事件过长，超过 10 秒没有返回，会出现此错误。

ERR_JOIN_CHANNEL_REJECTED

17：加入频道被拒绝。可能的原因有：

• 用户已经在频道中。建议通过 onConnectionStateChanged 回调判断用户是否在频道中。除收到 DISCONNECTED(1) 状态外，不要再次调用该方法加入频道。

ERR_LEAVE_CHANNEL_REJECTED

18：离开频道失败。可能的原因有：

• 调用 leaveChannel 前，用户已离开频道。停止调用该方法即可。
• 用户尚未加入频道，就调用 leaveChannel 退出频道。这种情况下无需额外操作。

ERR_ALREADY_IN_USE

19：资源已被占用，不能重复使用。

ERR_ABORTED

20：SDK 放弃请求，可能由于请求的次数太多。

ERR_INIT_NET_ENGINE

21：Windows 下特定的防火墙设置导致 RtcEngine 初始化失败然后崩溃。

ERR_RESOURCE_LIMITED

22：SDK 分配资源失败，可能由于 App 占用资源过多或系统资源耗尽。

ERR_INVALID_APP_ID

101：不是有效的 App ID。请更换有效的 App ID 重新加入频道。

ERR_INVALID_CHANNEL_NAME

102：不是有效的频道名。可能的原因是设置的参数数据类型不正确。请更换有效的频道名重新加入频道。

ERR_TOKEN_EXPIRED

109：当前使用的 Token 过期，不再有效。请在服务端申请生成新的 Token，并调用 renewToken 更新 Token。

废弃

该枚举已废弃。请改用 onConnectionStateChanged 回调中的 TOKEN_EXPIRED(9)。