错误码(V4.x)
更新时间: 2023/05/06 02:10:47
在调用 SDK API 的过程中,SDK 可能会返回错误码或状态码,您可以根据错误码或状态码判断当前 SDK 或任务的状态。如果遇到未知的错误码,请联系技术支持排查。
当前 SDK API 的错误码如下:
- 通用错误码 (NERtcErrorCode)
- 房间服务错误码 (NERtcRoomServerErrorCode)
- 伴音错误码 (NERtcAudioMixingErrorCode)
- 音视频设备错误码:NERtcDMErrorCode
- 视频水印状态码 (NERtcConstants.NERtcLocalVideoWatermarkState)
- 警告码 (NERtcWarnCode)
通用错误码
错误码 | 说明 |
---|---|
kNERtcNoError = 0 | 没有错误。 |
KNERtcErrChannelReservePermissionDenied = 403 |
权限不足。原因通常包括:
|
kNERtcErrChannelReserveTimeOut = 408 | 请求超时。 |
kNERtcErrChannelReserveErrorParam = 414 | 服务器请求参数错误。 |
kNERtcErrChannelReserveServerFail = 500 | 分配房间服务器出错。 |
kNERtcErrChannelReserveMoreThanTwoUser = 600 | 有第三个用户尝试加入只支持两个用户的房间。 |
kNERtcErrLsTaskRequestInvalid = 1301 | task 请求无效,被后续操作覆盖。 |
kNERtcErrLsTaskIsInvaild = 1400 | task 参数格式错误。 |
kNERtcErrLsTaskRoomExited = 1401 | 房间已经退出。 |
kNERtcErrLsTaskNumLimit = 1402 | 推流任务数量超过限制。 |
kNERtcErrLsTaskDuplicateId = 1403 | 推流 ID 重复。 |
kNERtcErrLsTaskNotFound = 1404 | taskId 任务不存在,或房间不存在。 |
kNERtcErrLsTaskRequestErr = 1417 | 请求失败。 |
kNERtcErrLsTaskInternalServerErr = 1500 | 服务器内部错误。 |
kNERtcErrLsTaskInvalidLayout = 1501 | 布局参数错误。 |
kNERtcErrLsTaskUserPicErr = 1512 | 用户图片错误。 |
kNERtcErrChannelStartFail = 11000 | 通道发起错误。 |
kNERtcErrChannelDisconnected = 11001 | 断开连接。 |
kNERtcErrVersionSelfLow = 11002 | 本端 SDK 版本太低,不兼容。 |
kNERtcErrVersionRemoteLow = 11003 | 对端 SDK 版本太低,不兼容。 |
kNERtcErrChannelClosed = 11004 | 通道被关闭。 |
kNERtcErrChannelKicked = 11005 | 账号被踢。 |
kNERtcErrDataError = 11400 | 数据错误。 |
kNERtcErrInvalid = 11403 | 操作无效。 |
kNERtcErrChannelJoinTimeOut = 20101 | 请求超时。 |
kNERtcErrChannelJoinMeetingModeError = 20102 | 会议模式错误。 |
kNERtcErrChannelJoinRtmpModeError = 20103 | 普通直播拉流观众加入非直播房间。 |
kNERtcErrChannelJoinRtmpNodesError = 20104 | 房间里直播拉流观众的数量超过限制。 |
kNERtcErrChannelJoinRtmpHostError = 20105 | 已经存在一个主播。 |
kNERtcErrChannelJoinRtmpCreateError = 20106 | 需要旁路直播,但房间创建者不是主播。 |
kNERtcErrChannelJoinLayoutError = 20208 | 主播自定义布局错误。 |
kNERtcErrChannelJoinInvalidParam = 20400 | 加入房间的参数无效。 |
kNERtcErrChannelJoinDesKey = 20401 | 密码加密错误。 |
kNERtcErrChannelJoinInvalidRequst = 20417 | 请求无效。 |
kNERtcErrChannelServerUnknown = 20500 | 服务器内部错误。 |
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 | 连接服务器错误。 |
kNERtcErrCreateDumpFileFail = 30016 | 创建音频 dump 文件失败。 |
kNERtcErrStartDumpFail = 30017 | 开启音频 dump 失败。 |
kNERtcErrDesktopCaptureInvalidState = 30020 | 启动桌面录屏失败,不能与摄像头同时启动。 |
kNERtcErrDesktopCaptureInvalidParam = 30021 | 桌面录屏传入的参数无效。 |
kNERtcErrDesktopCaptureNotReady = 30022 | 桌面录屏未就绪。 |
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 登录导致房间被关闭。 |
kNERtcErrMediaBannedByServer = 30403 | 被服务器禁言。 |
kNERtcRuntimeErrADMNoAuthorize = 40000 | 没有音频设备权限。 |
kNERtcRuntimeErrVDMNoAuthorize = 50000 | 没有视频设备权限。 |
kNERtcRuntimeErrScreenCaptureNoAuthorize = 60000 | 没有屏幕共享权限。 |
房间服务错误码
错误码 | 说明 |
---|---|
kNERtcRoomServerErrOK = 200 | 操作成功。 |
kNERtcRoomServerErrAuthError = 401 | 认证错误。 |
kNERtcRoomServerErrChannelNotExist = 404 | 房间不存在。 |
kNERtcRoomServerErrUidNotExist = 405 | 房间下的 uid 不存在。 |
kNERtcRoomServerErrDataError = 417 | 数据请求失败。 |
kNERtcRoomServerErrUnknown = 500 | 内部错误(TurnServer 请求异常)。 |
kNERtcRoomServerErrServerError = 600 | 服务器内部错误。 |
kNERtcRoomServerErrInvilid = 11403 | 非法操作。 |
伴音错误码
错误码 | 说明 |
---|---|
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 错误。 |
音视频设备错误码
错误码 | 说明 |
---|---|
kNERtcRuntimeErrADMInitRecording = 40001 | 录制时,麦克风初始化失败。 |
kNERtcRuntimeErrADMStartRecording = 40002 | 录制时,麦克风启动错误。 |
kNERtcRuntimeErrADMStopRecording = 40003 | 录制时,麦克风运行错误。 |
kNERtcRuntimeErrADMInitPlayout = 40004 | 音频播放设备初始化失败。 |
kNERtcRuntimeErrADMStartPlayout = 40005 | 音频播放设备打开失败。 |
kNERtcRuntimeErrADMStopPlayout = 40006 | 音频播放设备关闭失败。 |
kNERtcErrVDMCameraNoFrame = 1502 | 摄像头获取帧数据失败。 |
kNERtcErrVDMCameraCreateFail = 1503 | 摄像头启用失败。 |
视频水印状态码
错误码 | 说明 |
---|---|
kNERtcLocalVideoWatermarkStateDeviceNotSupported | 设备不支持。 |
kNERtcLocalVideoWatermarkStateImageFormatNotSupported | 图片格式不支持。 |
kNERtcLocalVideoWatermarkStateImageNumberError | 图片数量设置错误。 |
kNERtcLocalVideoWatermarkStateImageNumberError | 图片分辨率设置错误。 |
kNERtcLocalVideoWatermarkStateFontError | 字体设置错误。 |
kNERtcLocalVideoWatermarkStateCancel | 取消水印。 |
警告码
错误码 | 说明 |
---|---|
kNERtcWarnInvalidView = 100 | 指定的 view 无效,使用视频功能时需要指定 view,如果 view 尚未指定,则返回该警告。 |
kNERtcWarnInitVideo = 101 | 初始化视频功能失败。有可能是因视频资源被占用导致的。用户无法看到视频画面,但不影响语音通信。 |
kNERtcWarnPending = 102 | 请求处于待定状态。一般是由于某个模块还没准备好,请求被延迟处理。 |
kNERtcWarningChannelAbilityNotMatch = 406 | 当前客户端设备视频编解码能力与房间不匹配,例如设备不支持 VP8 等编码类型。在此房间中可能无法成功进行视频编解码,即本端可能无法正常显示某些远端的视频画面,同样远端也可能无法显示本端画面。 |
kNERtcWarnADMRuntimePlayoutWarning = 1001 | 播放设备运行时出现警告。 |
kNERtcWarnADMRuntimeRecordingWarning = 1002 | 录音设备运行时出现警告。 |
kNERtcWarnADMRecordAudioSilence = 1003 | 没有采集到有效的声音数据。 |
kNERtcWarnADMPlayoutMalfunction = 1004 | 播放设备故障。 |
kNERtcWarnADMRecordMalfunction = 1005 | 录音设备故障。 |
kNERtcWarnADMRecordAudioLowLevel = 1006 | 录到的声音太低。 |
kNERtcWarnADMPlayoutAudioLowLevel = 1007 | 播放的声音太低。 |
kNERtcWarnAPMHowling =1008 | 录制声音监测到啸叫。 |
kNERtcWarnADMGlitchState = 1009 | 音频播放卡顿。 |
kNERtcWarnADMImproperSettings = 1010 | 音频底层设置被修改。 |
kNERtcWarnADMWinCoreNoDataReadyEvent = 2000 |
音频驱动异常。
|
kNERtcWarnADMWinCoreNoRecordingDevice = 2001 | 无可用音频采集设备。 |
kNERtcWarnADMWinCoreNoPlayoutDevice = 2002 |
无可用音频播放设备。
|
kNERtcWarnADMWinCoreImproperCaptureRelease = 2003 |
音频设备模块:音频采集释放有误。
|
此文档是否对你有帮助?