iOS
错误码（V4.x）
更新时间： 2023/05/05 12:37:19
在调用 SDK API 的过程中，SDK 可能会返回错误码或状态码，您可以根据错误码或状态码判断当前 SDK 或任务的状态。如果遇到未知的错误码，请联系技术支持排查。
当前 SDK API 的错误码如下：
- 通用错误码 （NERtcEngineErrorCode.NERtcError）
- 伴音错误码 （NERtcAudioMixingErrorCode）
- 直播推流错误码 （NERtcEngineErrorCode.kNERtcLiveStreamError）
- 客户端录音状态码 （NERtcAudioRecordingCode）
- 视频水印状态码 （NERtcConstants.NERtcLocalVideoWatermarkState）
- 警告码 （NERtcWarning）
通用错误码
| 错误码 | 说明 |
|---|---|
| kNERtcNoError = 0 | 没有错误。 |
|
KNERtcErrChannelReservePermissionDenied = 403 |
权限不足。原因通常包括：
|
| kNERtcErrChannelReserveTimeOut = 408 | 请求超时。 |
| kNERtcErrChannelReserveErrorParam = 414 | 服务器请求参数错误。 |
| kNERtcErrChannelReserveErrorAppKey = 417 | 非法的 App Key。 |
| kNERtcErrChannelReserveMoreThanTwoUser = 600 | 有第三个用户尝试加入只支持两个用户的房间。 |
| kNERtcErrChannelReserveServerFail = 601 | 分配房间服务器出错。 |
| kNERtcErrFatal = 30001 | 通用错误。 |
| kNERtcErrOutOfMemory = 30002 | 内存耗尽。 |
| kNERtcErrInvalidParam = 30003 | 错误的参数。 |
| kNERtcErrNotSupported = 30004 | 不支持的操作。 |
| kNERtcErrInvalidState = 30005 | 当前状态不支持的操作。 |
| kNERtcErrLackOfResource = 30006 | 资源耗尽。 |
| kNERtcErrInvalidIndex = 30007 | 非法 index。 |
| kNERtcErrDeviceNotFound = 30008 | 设备未找到。 |
| kNERtcErrInvalidDeviceSourceID = 30009 | 非法设备 ID。 |
| kNERtcErrInvalidVideoProfile = 300010 | 非法的视频 profile type。 |
| kNERtcErrCreateDeviceSourceFail = 30011 | 设备创建错误。 |
| kNERtcErrInvalidRender = 30012 | 非法的渲染容器。 |
| kNERtcErrDevicePreviewAlreadyStarted = 30013 | 设备已经打开。 |
| kNERtcErrTransmitPendding = 30014 | 传输错误。 |
| kNERtcErrConnectFail = 30015 | 连接服务器错误。 |
| kNERtcErrChannelAlreadyJoined = 30100 | 重复加入房间。 |
| kNERtcErrChannelNotJoined = 30101 | 尚未加入房间。 |
| kNERtcErrChannelRepleatedlyLeave = 30102 | 重复离开房间。 |
| kNERtcErrRequestJoinChannelFail = 30103 | 加入房间操作失败。 |
| kNERtcErrSessionNotFound = 30104 | 会话未找到。 |
| kNERtcErrUserNotFound = 30105 | 用户未找到。 |
| kNERtcErrInvalidUserID = 30106 | 非法的用户 ID。 |
| kNERtcErrMediaNotStarted = 30107 | 用户多媒体数据未连接。 |
| kNERtcErrSourceNotFound = 30108 | source 未找到。 |
| kNERtcErrSwitchChannelInvalidState = 30109 | 切换房间状态无效。 |
| kNERtcErrChannelMediaRelayInvalidState = 30110 | 媒体流转发状态无效。 原因通常为重复调用 startChannelMediaRelay。成功调用 startChannelMediaRelay 后，必须先调用 stopChannelMediaRelay 方法退出当前的转发状态，才能再次调用该方法。 |
| kNERtcErrChannelMediaRelayPermissionDenied = 30111 | 媒体流转发权限不足。 原因通常包括： 源房间的房间类型为双人房间（1V1 模式）。此时无法转发媒体流。 调用 startChannelMediaRelay 开启媒体流转发的成员角色为观众角色，仅主播角色可以转发媒体流。 |
| kNERtcErrChannelMediaRelayStopFailed = 30112 | 停止媒体流转发操作失败。 原因通常为未开启媒体流转发。请确认调用 stopChannelMediaRelay 前，是否已成功调用 startChannelMediaRelay 开启媒体流转发。 |
| kNERtcErrEncryptNotSuitable = 30113 | 设置的媒体流加密密钥与房间中其他成员不一致，加入房间失败。 请通过 enableEncryption 重新设置加密密钥。 |
| kNERtcErrConnectionNotFound = 30200 | 连接未找到。 |
| kNERtcErrStreamNotFound = 30201 | 媒体流未找到。 |
| kNERtcErrAddTrackFail = 30202 | 加入 track 失败。 |
| kNERtcErrTrackNotFound = 30203 | track 未找到。 |
| kNERtcErrMediaConnectionDisconnected = 30204 | 媒体连接断开。 |
| kNERtcErrSignalDisconnected = 30205 | 信令连接断开。 |
| kNERtcErrServerKicked = 30206 | 被踢出房间。 |
| kNERtcErrChannelBeClosed = 30207 | 房间已被关闭。 |
| kNERtcErrChannelLeaveBySwitchAction = 30208 | 房间被关闭因为切换房间的操作。 |
| kNERtcErrChannelLeaveByDuplicateUidLogin = 30209 | 房间被关闭因为有重复 uid 登录。 |
| kNERtcErrOSAuthorize = 30300 | 操作系统权限问题。 |
| kNERtcErrMediaOpenBannedByServer = 30403 | 被服务器禁言。 |
| kNERtcRuntimeErrADMNoAuthorize = 40000 | 没有音频设备权限。 |
| kNERtcRuntimeErrADMInitRecording = 40001 | 音频采集设备初始化失败。 |
| kNERtcRuntimeErrADMStartRecording = 40002 | 音频采集设备开始失败。 |
| kNERtcRuntimeErrADMStopRecording = 40003 | 音频采集设备停止失败。 |
| kNERtcRuntimeErrADMInitPlayout = 40004 | 音频播放设备初始化失败。 |
| kNERtcRuntimeErrADMStartPlayout = 40005 | 音频播放设备开始失败。 |
| kNERtcRuntimeErrADMStopPlayout = 40006 | 音频播放设备停止失败。 |
| kNERtcRuntimeErrVDMNoAuthorize = 50000 | 没有视频设备权限。 |
| kNERtcRuntimeErrVDMNotScreenUseSubStream = 50001 | 非屏幕共享使用辅流。 |
伴音错误码
| 错误码 | 说明 |
|---|---|
| kNERtcAudioMixingErrorOK = 0 | 伴音正常。 |
| kNERtcAudioMixingErrorFatal = 1 | 伴音出现严重错误。 |
| kNERtcAudioMixingErrorCanNotOpen = 2 | 伴音不能正常打开。 |
| kNERtcAudioMixingErrorDecode = 3 | 音频解码错误。 |
| kNERtcAudioMixingErrorInterrupt = 4 | 操作中断码。 |
| kNERtcAudioMixingErrorHttpNotFound = 5 | 404 http/https 对应的文件找不到。 |
| kNERtcAudioMixingErrorOpen = 6 | 打开流或文件失败。 |
| kNERtcAudioMixingErrorNInfo = 7 | 获取解码信息失败或超时。 |
| kNERtcAudioMixingErrorNStream = 8 | 无音频流。 |
| kNERtcAudioMixingErrorNCodec = 9 | 无解码器。 |
| kNERtcAudioMixingErrorNMem = 10 | 无内存。 |
| kNERtcAudioMixingErrorCodecOpen = 11 | 解码器打开失败或超时。 |
| kNERtcAudioMixingErrorInvalidInfo = 12 | 无效音频参数（声道、采样率）。 |
| kNERtcAudioMixingErrorOpenTimeout = 13 | 打开流或文件超时。 |
| kNERtcAudioMixingErrorIoTimeout = 14 | 网络 I/O 超时。 |
| kNERtcAudioMixingErrorIo = 15 | 网络 I/O 错误。 |
直播推流错误码
| 错误码 | 说明 |
|---|---|
| kNERtcLiveStreamErrorRequestIsInvaild = 1301 | task 请求无效，被后续操作覆盖。 |
| kNERtcLiveStreamErrorIsInvaild = 1400 | task 参数格式错误。 |
| kNERtcLiveStreamErrorRoomExited = 1401 | 房间已经退出。 |
| kNERtcLiveStreamErrorNumLimit = 1402 | 推流任务超出上限。 |
| kNERtcLiveStreamErrorDuplicateId = 1403 | 推流 ID 重复。 |
| kNERtcLiveStreamErrorNotFound = 1404 | taskId 任务不存在，或房间不存在。 |
| kNERtcLiveStreamErrorRequestErr = 1417 | 请求失败。 |
| kNERtcLiveStreamErrorInternalServerErr = 1500 | 服务器内部错误。 |
| kNERtcErrLsTaskInvalidLayout = 1501 | 布局参数错误。 |
| kNERtcErrLsTaskUserPicErr = 1502 | 用户图片错误。 |
客户端录音状态码
| 错误码 | 说明 |
|---|---|
| NERtcAudioRecordingCodeErrorSuffix = 1 | 不支持的录音文件格式。 |
|
kNERtcAudioRecordingOpenFileFailed = 2 |
无法创建录音文件。原因通常包括：
|
| kNERtcAudioRecordingCodeStart = 3 | 开始录制。 |
| kNERtcAudioRecordingRecordError = 4 | 录制错误。原因通常为磁盘空间已满，无法写入。 |
| kNERtcAudioRecordingCodeFinish = 5 | 完成录制。 |
视频水印状态码
| 错误码 | 说明 |
|---|---|
| kNERtcLocalVideoWatermarkStateDeviceNotSupported | 设备不支持。 |
| kNERtcLocalVideoWatermarkStateImageFormatNotSupported | 图片格式不支持。 |
| kNERtcLocalVideoWatermarkStateImageNumberError | 图片数量设置错误。 |
| kNERtcLocalVideoWatermarkStateImageNumberError | 图片尺寸设置错误。 |
| kNERtcLocalVideoWatermarkStateImageNumberError | 图片分辨率设置错误。 |
| kNERtcLocalVideoWatermarkStateFontError | 字体设置错误。 |
| kNERtcLocalVideoWatermarkStateCancel | 取消水印。 |
警告码
| 错误码 | 说明 |
|---|---|
| kNERtcNoWarning = 0 | 不支持的录音文件格式。 |
| KNERtcWarningChannelAbilityNotMatch = 406 | 无法创建录音文件。原因通常包括： |
| kNERtcWarningASLFallback = 407 | 开启音频 ASL 失败。 |
此文档是否对你有帮助？
