错误码(V4.x)

更新时间: 2023/05/06 02:10:47

在调用 SDK API 的过程中,SDK 可能会返回错误码或状态码,您可以根据错误码或状态码判断当前 SDK 或任务的状态。如果遇到未知的错误码,请联系技术支持排查。

当前 SDK API 的错误码如下:

通用错误码

错误码 说明
kNERtcNoError = 0 没有错误。

KNERtcErrChannelReservePermissionDenied = 403

权限不足。原因通常包括:

  • 未开通音视频通话 2.0 服务,或试用期已过、未及时续费等。
  • 安全模式下加入房间时未设置 Token。
  • 其他权限问题。
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

音频设备模块:音频采集释放有误。
解决方案:禁用并重新启用音频设备,或者重启机器,或者更新声卡驱动。

此文档是否对你有帮助?
有帮助
去反馈
  • 通用错误码
  • 房间服务错误码
  • 伴音错误码
  • 音视频设备错误码
  • 视频水印状态码
  • 警告码