AgoraErrorCode
AgoraErrorCode
错误代码。
错误代码意味着 SDK 遇到不可恢复的错误，需要应用程序干预。例如：打开摄像头失败时会返回错误，App 需要提示用户不能使用摄像头。
枚举值
- AgoraErrorCodeNoError
- 0：没有错误。
- AgoraErrorCodeFailed
- 1：一般性的错误（没有明确归类的错误原因）。请重新调用方法。
- AgoraErrorCodeInvalidArgument
- 2：方法中设置了无效的参数。例如指定的频道名中含有非法字符。请重新设置参数。
- AgoraErrorCodeNotReady
- 3：SDK 尚未准备好。可能的原因有：
- AgoraRtcEngineKit 初始化失败。请重新初始化 AgoraRtcEngineKit。
- 调用方法时用户尚未加入频道。请检查方法的调用逻辑。
- 调用 rate:rating:description: 或 complain:description: 方法时用户尚未离开频道。请检查方法的调用逻辑。
- 音频模块未开启。
- 程序集不完整。
- AgoraErrorCodeNotSupported
- 4：AgoraRtcEngineKit 当前状态不支持该操作。可能的原因有：
- 使用内置加密时，设置的加密模式不正确，或加载外部加密库失败。请检查加密的枚举值是否正确，或重新加载外部加密库。
- AgoraErrorCodeRefused
- 5：方法调用被拒绝。可能的原因有：
- AgoraRtcEngineKit 初始化失败。请重新初始化 AgoraRtcEngineKit。
- 在加入频道时，将频道名设为空字符
""。请重新设置频道名。 - 多频道场景下，在调用 joinChannelExByToken:connection:delegate:mediaOptions:joinSuccess: 方法加入频道时，设置的频道名已存在。请重新设置频道名。
- AgoraErrorCodeBufferTooSmall
- 6：缓冲区大小不足以存放返回的数据。
- AgoraErrorCodeNotInitialized
- 7：AgoraRtcEngineKit 尚未初始化就调用方法。请确认在调用该方法前已创建 AgoraRtcEngineKit 对象并完成初始化。
- AgoraErrorCodeNoPermission
- 9：没有操作权限。请检查用户是否授予了 App 音视频设备的使用权限。
- AgoraErrorCodeTimedOut
- 10： 方法调用超时。有些方法调用需要 SDK 返回结果，如果 SDK 处理事件过长，超过 10 秒没有返回，会出现此错误。
- AgoraErrorCodeJoinChannelRejected
- 17：加入频道被拒绝。可能的原因有：
- 用户已经在频道中。建议通过 rtcEngine:connectionStateChanged:reason: 回调判断用户是否在频道中。除收到 AgoraConnectionStateDisconnected(1) 状态外，不要再次调用该方法加入频道。
- 用户在调用 startEchoTestWithConfig: 进行通话测试后，未调用 stopEchoTest 结束当前测试就尝试加入频道。开始通话测试后，需要先调用 stopEchoTest 结束当前测试，再加入频道。
- AgoraErrorCodeLeaveChannelRejected
- 18：离开频道失败。可能的原因有：
- 调用 leaveChannel:leaveChannelBlock: 前，用户已离开频道。停止调用该方法即可。
- 用户尚未加入频道，就调用 leaveChannel:leaveChannelBlock: 退出频道。这种情况下无需额外操作。
- AgoraErrorCodeAlreadyInUse
- 19：资源已被占用，不能重复使用。
- AgoraErrorCodeAbort
- 20：SDK 放弃请求，可能由于请求的次数太多。
- AgoraErrorCodeInitNetEngine
- 21：Windows 下特定的防火墙设置导致 AgoraRtcEngineKit 初始化失败然后崩溃。
- AgoraErrorCodeResourceLimited
- 22：SDK 分配资源失败，可能由于 App 占用资源过多或系统资源耗尽。
- AgoraErrorCodeInvalidAppId
- 101：不是有效的 App ID。请更换有效的 App ID 重新加入频道。
- AgoraErrorCodeInvalidChannelId
- 102：不是有效的频道名。可能的原因是设置的参数数据类型不正确。请更换有效的频道名重新加入频道。
- AgoraErrorCodeTokenExpired
- 109：当前使用的 Token 过期，不再有效。请在服务端申请生成新的 Token，并调用 renewToken: 更新 Token。废弃
- 该枚举已废弃。请改用 rtcEngine:connectionStateChanged:reason: 回调中的 AgoraConnectionChangedReasonTokenExpired(9)。
- AgoraErrorCodeInvalidToken
- 110：Token 无效。一般有以下原因：
- 在控制台中启用了 App 证书，但未使用 App ID + Token 鉴权。当项目启用了 App 证书，就必须使用 Token 鉴权。
- 生成 Token 时填入的
uid字段，和用户加入频道时填入的 uid 不匹配。
废弃- 该枚举已废弃。请改用 rtcEngine:connectionStateChanged:reason: 回调中的 AgoraConnectionChangedReasonInvalidToken(8)。
- AgoraErrorCodeConnectionInterrupted
- 111：网络连接中断。SDK 在和服务器建立连接后，失去网络连接超过 4 秒。
- AgoraErrorCodeConnectionLost
- 112：网络连接丢失。网络连接中断，且 SDK 无法在 10 秒内连接服务器。
- AgoraErrorCodeNotInChannel
- 113：调用 sendStreamMessage:data: 方法时用户不在频道内。
- AgoraErrorCodeSizeTooLarge
- 114：在调用 sendStreamMessage:data: 时，发送的数据长度大于 1 KB。
- AgoraErrorCodeBitrateLimit
- 115：在调用 sendStreamMessage:data: 时，发送数据的频率超过限制（6 KB/s）。
- AgoraErrorCodeTooManyDataStreams
- 116：在调用 createDataStream:config: 时，创建的数据流超过限制（5 个）。
- AgoraErrorCodeDecryptionFailed
- 120：媒体流解密失败。可能是用户加入频道时使用了错误的密钥。请检查用户加入频道时填入的密钥，或引导用户尝试重新加入频道。
- AgoraErrorCodeDatastreamDecryptionFailed
- 122：数据流解密失败。可能是用户加入频道时使用了错误的密钥。请检查用户加入频道时填入的密钥，或引导用户尝试重新加入频道。
- AgoraErrorCodeEncryptedStreamNotAllowedPublish
- 130：SDK 不支持将加密过的流推到 CDN 上。
- AgoraErrorCodeInvalidUserAccount
- 134：无效的 user account，可能是因为设置了无效的参数。
- AgoraErrorCodeLoadMediaEngine
- 1001：加载媒体引擎失败。
- AgoraErrorCodeAdmGeneralError
- 1005：音频设备出现错误（未指明何种错误）。请检查音频设备是否被其他应用占用，或者尝试重新进入频道。
- AgoraErrorCodeAdmInitPlayout
- 1008：初始化播放设备出错。请检查播放设备是否被其他应用占用，或者尝试重新进入频道。
- AgoraErrorCodeAdmStartPlayout
- 1009：启动播放设备出错。请检查播放设备是否正常。
- AgoraErrorCodeAdmStopPlayout
- 1010：停止播放设备出错。
- AgoraErrorCodeAdmInitRecording
- 1011：初始化录音设备出错。请检查录音设备是否正常，或者尝试重新进入频道。
- AgoraErrorCodeAdmStartRecording
- 1012：启动录音设备出错。请检查录音设备是否正常。
- AgoraErrorCodeAdmStopRecording
- 1013：停止录音设备出错。
- AgoraErrorCodeVdmCameraNotAuthorized
- 1501：没有摄像头使用权限。请检查是否已经打开摄像头权限。