AgoraErrorCode

  • macOS

更新时间不可用

表示错误代码。

枚举值

参数名描述
AgoraErrorCodeNoError

0: 没有错误。(默认)

AgoraErrorCodeFailed

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

AgoraErrorCodeInvalidArgument

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

AgoraErrorCodeNotReady

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

  • 检查音频设备状态

  • 检查程序集完整性

  • 尝试重新初始化 AgoraRtcEngineKit

AgoraErrorCodeNotSupported

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

AgoraErrorCodeBufferTooSmall

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

AgoraErrorCodeNotInitialized

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

AgoraErrorCodeInvalidState

(8):状态无效。

AgoraErrorCodeTimedOut

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

AgoraErrorCodeJoinChannelRejected

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

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

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

AgoraErrorCodeLeaveChannelRejected

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

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

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

AgoraErrorCodeAlreadyInUse

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

AgoraErrorCodeInitNetEngine

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

AgoraErrorCodeResourceLimited

22: 资源有限。

AgoraErrorCodeInvalidAppId

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

AgoraErrorCodeInvalidChannelId

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

AgoraErrorCodeNoServerResources

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

AgoraErrorCodeTokenExpired

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

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

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

AgoraErrorCodeInvalidToken

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

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

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

AgoraErrorCodeConnectionInterrupted

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

AgoraErrorCodeConnectionLost

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

AgoraErrorCodeNotInChannel

113: 用户不在频道内。

AgoraErrorCodeSizeTooLarge

114: 数据太大。

AgoraErrorCodeBitrateLimit

115: 码率受限。

AgoraErrorCodeTooManyDataStreams

116: 数据流/通道过多。

AgoraErrorCodeDecryptionFailed

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

AgoraErrorCodeEncryptedStreamNotAllowedPublish

(130):SDK 不支持将加密流推送到 CDN。

AgoraErrorCodeInvalidUserAccount

(134):用户账号无效,可能是因为包含无效参数。

AgoraErrorCodeWatermarkParam

124: 水印文件参数错误。

AgoraErrorCodeWatermarkPath

125: 水印文件路径错误。

AgoraErrorCodeWatermarkPng

126: 水印文件格式错误。

AgoraErrorCodeWatermarkInfo

127: 水印文件信息错误。

AgoraErrorCodeWatermarkAGRB

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

AgoraErrorCodeWatermarkRead

129: 水印文件读取错误。

AgoraErrorCodePcmSendFormat

(200):不支持的 PCM 格式。

AgoraErrorCodePcmSendBufferOverflow

(201):缓冲区溢出,PCM 发送速率过快。

AgoraErrorCodeLoadMediaEngine

1001: 加载媒体引擎失败。

AgoraErrorCodeStartCall

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

AgoraErrorCodeStartCamera

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

AgoraErrorCodeStartVideoRender

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

AgoraErrorCodeAdmGeneralError

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

AgoraErrorCodeAdmJavaResource

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

AgoraErrorCodeAdmSampleRate

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

AgoraErrorCodeAdmInitPlayout

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

AgoraErrorCodeAdmStartPlayout

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

AgoraErrorCodeAdmStopPlayout

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

AgoraErrorCodeAdmInitRecording

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

AgoraErrorCodeAdmStartRecording

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

AgoraErrorCodeAdmStopRecording

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

AgoraErrorCodeAdmRuntimePlayoutError

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

AgoraErrorCodeAdmRuntimeRecordingError

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

AgoraErrorCodeAdmRecordAudioFailed

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

AgoraErrorCodeAdmPlayAbnormalFrequency

1020: 回放频率异常。

AgoraErrorCodeAdmRecordAbnormalFrequency

1021: 录制频率异常。

AgoraErrorCodeAdmInitLoopback

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

AgoraErrorCodeAdmStartLoopback

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

AgoraErrorCodeAdmNoRecordingDevice

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

AgoraErrorCodeAdmNoPlayoutDevice

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

AgoraErrorCodeVdmCameraNotAuthorized

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

AgoraErrorCodeVcmUnknownError

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

AgoraErrorCodeVcmEncoderInitError

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

AgoraErrorCodeVcmEncoderEncodeError

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

AgoraErrorCodeVcmEncoderSetError

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

AgoraErrorCodeVideoEffectAssetInvalid

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

AgoraErrorCodeVideoEffectSaveFailed

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

AgoraErrorCodeVideoEffectEngineInvalid

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

AgoraErrorCodeVideoEffectNodeNotActive

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

AgoraErrorCodeVideoEffectInvalidParam

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

AgoraErrorCodeVideoEffectNotSupported

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

AgoraErrorCodeVideoEffectInvalidBundlePath

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

表格内容超出当前宽度,可横向滚动查看更多列。

这个页面有帮助吗?