# AgoraErrorCode (/zh-CN/api-reference/rtc/ios/enum-errorcodetype)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

<a id="enum_errorcodetype__parameters"></a>

## 枚举值 [#枚举值]

<ParameterList>
<a id="agoraerrorcodenoerror"></a>
<Parameter name="AgoraErrorCodeNoError">

0: 没有错误。（默认）

</Parameter>
<a id="agoraerrorcodefailed"></a>
<Parameter name="AgoraErrorCodeFailed">

1: 一般性的错误（没有明确归类的错误原因）。

</Parameter>
<a id="agoraerrorcodeinvalidargument"></a>
<Parameter name="AgoraErrorCodeInvalidArgument">

2: API 调用了无效的参数。例如，指定的频道名含有非法字符。

</Parameter>
<a id="agoraerrorcodenotready"></a>
<Parameter name="AgoraErrorCodeNotReady">

3: RTC 初始化失败。处理方法：

- 检查音频设备状态

- 检查程序集完整性

- 尝试重新初始化 AgoraRtcEngineKit

</Parameter>
<a id="agoraerrorcodenotsupported"></a>
<Parameter name="AgoraErrorCodeNotSupported">

4: RTC 当前状态禁止此操作，因此不能进行此操作。

</Parameter>
<a id="agoraerrorcodebuffertoosmall"></a>
<Parameter name="AgoraErrorCodeBufferTooSmall">

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

</Parameter>
<a id="agoraerrorcodenotinitialized"></a>
<Parameter name="AgoraErrorCodeNotInitialized">

7: SDK 尚未初始化，就调用其 API。请确认在调用 API 之前已创建 AgoraRtcEngineKit 对象并完成初始化。

</Parameter>
<a id="agoraerrorcodeinvalidstate"></a>
<Parameter name="AgoraErrorCodeInvalidState">

（8）：状态无效。

</Parameter>
<a id="agoraerrorcodetimedout"></a>
<Parameter name="AgoraErrorCodeTimedOut">

10: API 调用超时。有些 API 调用需要 SDK 返回结果，如果 SDK 处理事件过程，会出现此错误。

</Parameter>
<a id="agoraerrorcodejoinchannelrejected"></a>
<Parameter name="AgoraErrorCodeJoinChannelRejected">

17: 加入频道被拒绝。一般有以下原因：

- 用户已进入频道，再次调用加入频道的 API，例如 `joinChannelByToken`，会返回此错误。停止调用该 API 即可。

- 用户在做 Echo 测试时尝试加入频道。等待 Echo test 结束后再加入频道即可。

</Parameter>
<a id="agoraerrorcodeleavechannelrejected"></a>
<Parameter name="AgoraErrorCodeLeaveChannelRejected">

18: 离开频道失败。一般有以下原因：

- 用户已离开频道，再次调用退出频道的 API，例如 `leaveChannel`，会返回此错误。停止调用该 API 即可。

- 用户尚未加入频道，就调用退出频道的 API。这种情况下无需额外操作。

</Parameter>
<a id="agoraerrorcodealreadyinuse"></a>
<Parameter name="AgoraErrorCodeAlreadyInUse">

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

</Parameter>
<a id="agoraerrorcodeinitnetengine"></a>
<Parameter name="AgoraErrorCodeInitNetEngine">

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

</Parameter>
<a id="agoraerrorcoderesourcelimited"></a>
<Parameter name="AgoraErrorCodeResourceLimited">

22: 资源有限。

</Parameter>
<a id="agoraerrorcodeinvalidappid"></a>
<Parameter name="AgoraErrorCodeInvalidAppId">

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

</Parameter>
<a id="agoraerrorcodeinvalidchannelid"></a>
<Parameter name="AgoraErrorCodeInvalidChannelId">

102: 不是有效的频道名。请更换有效的频道名重新加入频道。

</Parameter>
<a id="agoraerrorcodenoserverresources"></a>
<Parameter name="AgoraErrorCodeNoServerResources">

（103）：在指定区域无法获取服务器资源。请在调用 sharedEngine 时尝试指定其他区域。

</Parameter>
<a id="agoraerrorcodetokenexpired"></a>
<Parameter name="AgoraErrorCodeTokenExpired">

109: 当前使用的 Token 过期，不再有效。一般有以下原因：

- Token 授权时间戳无效：Token 授权时间戳为 Token 生成时的时间戳，自 1970 年 1 月 1 日开始到当前时间的描述。授权该 Token 在生成后的 24 小时内可以访问 Agora 服务。如果 24 小时内没有访问，则该 Token 无法再使用。需要重新在服务端申请生成 Token。

- Token 服务到期时间戳已过期：用户设置的服务到期时间戳小于当前时间戳，无法继续使用 Agora 服务（比如正在进行的通话会被强制终止）；设置服务到期时间并不意味着 Token 失效，而仅仅用于限制用户使用当前服务的时间。需要重新在服务端申请生成 Token。

</Parameter>
<a id="agoraerrorcodeinvalidtoken"></a>
<Parameter name="AgoraErrorCodeInvalidToken">

110: 生成的 Token 无效，一般有以下原因：

- 用户在 Dashboard 上启用了 App Certificate，但仍旧在代码里仅使用了 App ID。当启用了 App Certificate，必须使用 Token。

- 字段 uid 为生成 Token 的必须字段，用户在调用 `joinChannelByToken` 加入频道时必须设置相同的 uid。

</Parameter>
<a id="agoraerrorcodeconnectioninterrupted"></a>
<Parameter name="AgoraErrorCodeConnectionInterrupted">

111: 网络连接中断。仅适用于 Agora Web SDK。

</Parameter>
<a id="agoraerrorcodeconnectionlost"></a>
<Parameter name="AgoraErrorCodeConnectionLost">

112: 网络连接丢失。仅适用于 Agora Web SDK。

</Parameter>
<a id="agoraerrorcodenotinchannel"></a>
<Parameter name="AgoraErrorCodeNotInChannel">

113: 用户不在频道内。

</Parameter>
<a id="agoraerrorcodesizetoolarge"></a>
<Parameter name="AgoraErrorCodeSizeTooLarge">

114: 数据太大。

</Parameter>
<a id="agoraerrorcodebitratelimit"></a>
<Parameter name="AgoraErrorCodeBitrateLimit">

115: 码率受限。

</Parameter>
<a id="agoraerrorcodetoomanydatastreams"></a>
<Parameter name="AgoraErrorCodeTooManyDataStreams">

116: 数据流/通道过多。

</Parameter>
<a id="agoraerrorcodedecryptionfailed"></a>
<Parameter name="AgoraErrorCodeDecryptionFailed">

120: 解密失败，可能是用户加入频道用了不同的密码。请检查加入频道时的设置，或尝试重新加入频道。

</Parameter>
<a id="agoraerrorcodeencryptedstreamnotallowedpublish"></a>
<Parameter name="AgoraErrorCodeEncryptedStreamNotAllowedPublish">

（130）：SDK 不支持将加密流推送到 CDN。

</Parameter>
<a id="agoraerrorcodeinvaliduseraccount"></a>
<Parameter name="AgoraErrorCodeInvalidUserAccount">

（134）：用户账号无效，可能是因为包含无效参数。

</Parameter>
<a id="agoraerrorcodewatermarkparam"></a>
<Parameter name="AgoraErrorCodeWatermarkParam">

124: 水印文件参数错误。

</Parameter>
<a id="agoraerrorcodewatermarkpath"></a>
<Parameter name="AgoraErrorCodeWatermarkPath">

125: 水印文件路径错误。

</Parameter>
<a id="agoraerrorcodewatermarkpng"></a>
<Parameter name="AgoraErrorCodeWatermarkPng">

126: 水印文件格式错误。

</Parameter>
<a id="agoraerrorcodewatermarkinfo"></a>
<Parameter name="AgoraErrorCodeWatermarkInfo">

127: 水印文件信息错误。

</Parameter>
<a id="agoraerrorcodewatermarkagrb"></a>
<Parameter name="AgoraErrorCodeWatermarkAGRB">

128: 水印文件数据格式错误。

</Parameter>
<a id="agoraerrorcodewatermarkread"></a>
<Parameter name="AgoraErrorCodeWatermarkRead">

129: 水印文件读取错误。

</Parameter>
<a id="agoraerrorcodepcmsendformat"></a>
<Parameter name="AgoraErrorCodePcmSendFormat">

（200）：不支持的 PCM 格式。

</Parameter>
<a id="agoraerrorcodepcmsendbufferoverflow"></a>
<Parameter name="AgoraErrorCodePcmSendBufferOverflow">

（201）：缓冲区溢出，PCM 发送速率过快。

</Parameter>
<a id="agoraerrorcodeloadmediaengine"></a>
<Parameter name="AgoraErrorCodeLoadMediaEngine">

1001: 加载媒体引擎失败。

</Parameter>
<a id="agoraerrorcodestartcall"></a>
<Parameter name="AgoraErrorCodeStartCall">

1002: 启动媒体引擎开始通话失败。请尝试重新进入频道。

</Parameter>
<a id="agoraerrorcodestartcamera"></a>
<Parameter name="AgoraErrorCodeStartCamera">

1003: 启动摄像头失败，请检查摄像头是否被其他应用占用，或者尝试重新进入频道。

</Parameter>
<a id="agoraerrorcodestartvideorender"></a>
<Parameter name="AgoraErrorCodeStartVideoRender">

1004: 启动视频渲染模块失败。

</Parameter>
<a id="agoraerrorcodeadmgeneralerror"></a>
<Parameter name="AgoraErrorCodeAdmGeneralError">

1005: 音频设备模块：音频初始化失败。请检查音频设备是否被其他应用占用，或者尝试重新进入频道。

</Parameter>
<a id="agoraerrorcodeadmjavaresource"></a>
<Parameter name="AgoraErrorCodeAdmJavaResource">

1006: 音频设备模块：使用 Java 资源出现错误。

</Parameter>
<a id="agoraerrorcodeadmsamplerate"></a>
<Parameter name="AgoraErrorCodeAdmSampleRate">

1007: 音频设备模块：设置的采样频率出现错误。

</Parameter>
<a id="agoraerrorcodeadminitplayout"></a>
<Parameter name="AgoraErrorCodeAdmInitPlayout">

1008: 音频设备模块：初始化播放设备出现错误。请检查播放设备是否被其他应用占用，或者尝试重新进入频道。

</Parameter>
<a id="agoraerrorcodeadmstartplayout"></a>
<Parameter name="AgoraErrorCodeAdmStartPlayout">

1009: 音频设备模块：启动播放设备出现错误。请检查播放设备是否正常，或者尝试重新进入频道。

</Parameter>
<a id="agoraerrorcodeadmstopplayout"></a>
<Parameter name="AgoraErrorCodeAdmStopPlayout">

1010: 音频设备模块：停止播放设备出现错误。

</Parameter>
<a id="agoraerrorcodeadminitrecording"></a>
<Parameter name="AgoraErrorCodeAdmInitRecording">

1011: 音频设备模块：初始化录音设备时出现错误。请检查录音设备是否正常，或者尝试重新进入频道。

</Parameter>
<a id="agoraerrorcodeadmstartrecording"></a>
<Parameter name="AgoraErrorCodeAdmStartRecording">

1012: 音频设备模块：启动录音设备出现错误。请检查录音设备是否正常，或者尝试重新进入频道。

</Parameter>
<a id="agoraerrorcodeadmstoprecording"></a>
<Parameter name="AgoraErrorCodeAdmStopRecording">

1013: 音频设备模块：停止录音设备出现错误。

</Parameter>
<a id="agoraerrorcodeadmruntimeplayouterror"></a>
<Parameter name="AgoraErrorCodeAdmRuntimePlayoutError">

1015: 音频设备模块：运行时播放出现错误。请检查录音设备是否正常，或者尝试重新进入频道。

</Parameter>
<a id="agoraerrorcodeadmruntimerecordingerror"></a>
<Parameter name="AgoraErrorCodeAdmRuntimeRecordingError">

1017: 音频设备模块：运行时录音错误。请检查录音设备是否正常，或者尝试重新进入频道。

</Parameter>
<a id="agoraerrorcodeadmrecordaudiofailed"></a>
<Parameter name="AgoraErrorCodeAdmRecordAudioFailed">

1018: 音频设备模块：录音失败。

</Parameter>
<a id="agoraerrorcodeadmplayabnormalfrequency"></a>
<Parameter name="AgoraErrorCodeAdmPlayAbnormalFrequency">

1020: 回放频率异常。

</Parameter>
<a id="agoraerrorcodeadmrecordabnormalfrequency"></a>
<Parameter name="AgoraErrorCodeAdmRecordAbnormalFrequency">

1021: 录制频率异常。

</Parameter>
<a id="agoraerrorcodeadminitloopback"></a>
<Parameter name="AgoraErrorCodeAdmInitLoopback">

1022: 音频设备模块：初始化 Loopback 设备错误。

</Parameter>
<a id="agoraerrorcodeadmstartloopback"></a>
<Parameter name="AgoraErrorCodeAdmStartLoopback">

1023: 音频设备模块：启动 Loopback 设备错误。

</Parameter>
<a id="agoraerrorcodeadmnorecordingdevice"></a>
<Parameter name="AgoraErrorCodeAdmNoRecordingDevice">

1359: 音频设备模块：无录制设备。请检查是否有可用的录放音设备或者录放音设备是否已经被其他应用占用。

</Parameter>
<a id="agoraerrorcodeadmnoplayoutdevice"></a>
<Parameter name="AgoraErrorCodeAdmNoPlayoutDevice">

1360: 音频设备模块：无播放设备。

</Parameter>
<a id="agoraerrorcodevdmcameranotauthorized"></a>
<Parameter name="AgoraErrorCodeVdmCameraNotAuthorized">

1501: 视频设备模块：没有摄像头使用权限。请检查是否已经打开摄像头权限。

</Parameter>
<a id="agoraerrorcodevcmunknownerror"></a>
<Parameter name="AgoraErrorCodeVcmUnknownError">

1600: 视频设备模块：未知错误。

</Parameter>
<a id="agoraerrorcodevcmencoderiniterror"></a>
<Parameter name="AgoraErrorCodeVcmEncoderInitError">

1601: 视频设备模块：视频 Codec 初始化错误。该错误为严重错误，请尝试重新加入频道。

</Parameter>
<a id="agoraerrorcodevcmencoderencodeerror"></a>
<Parameter name="AgoraErrorCodeVcmEncoderEncodeError">

1602: 视频设备模块：视频 Codec 错误。该错误为严重错误，请尝试重新加入频道。

</Parameter>
<a id="agoraerrorcodevcmencoderseterror"></a>
<Parameter name="AgoraErrorCodeVcmEncoderSetError">

1603: 视频设备模块：视频 Codec 设置错误。

</Parameter>
<a id="agoraerrorcodevideoeffectassetinvalid"></a>
<Parameter name="AgoraErrorCodeVideoEffectAssetInvalid">

1700: 美颜资产无效。可能是资源包损坏、配置文件解析失败或缺少必填字段。

</Parameter>
<a id="agoraerrorcodevideoeffectsavefailed"></a>
<Parameter name="AgoraErrorCodeVideoEffectSaveFailed">

1701: 保存美颜配置失败。可能由于磁盘空间不足或文件写入权限不足导致。

</Parameter>
<a id="agoraerrorcodevideoeffectengineinvalid"></a>
<Parameter name="AgoraErrorCodeVideoEffectEngineInvalid">

1702: 美颜引擎状态无效。可能是引擎未初始化或渲染引擎实例不存在。

</Parameter>
<a id="agoraerrorcodevideoeffectnodenotactive"></a>
<Parameter name="AgoraErrorCodeVideoEffectNodeNotActive">

1704: 目标美颜节点未激活。请先调用 `addOrUpdateVideoEffect` 激活节点。

</Parameter>
<a id="agoraerrorcodevideoeffectinvalidparam"></a>
<Parameter name="AgoraErrorCodeVideoEffectInvalidParam">

1705: 美颜参数无效。例如，nodeId、actionId、option 或 key 非法或为空。

</Parameter>
<a id="agoraerrorcodevideoeffectnotsupported"></a>
<Parameter name="AgoraErrorCodeVideoEffectNotSupported">

1706: 当前设备不支持美颜效果。

</Parameter>
<a id="agoraerrorcodevideoeffectinvalidbundlepath"></a>
<Parameter name="AgoraErrorCodeVideoEffectInvalidBundlePath">

1707: 美颜资源包路径无效。路径为空或文件系统中不存在。

</Parameter>
</ParameterList>