错误码

更新时间: 2022/06/10 02:03:44

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

当前 SDK API 的错误码如下:

通用错误码

错误码 说明
OK = 0 成功。
ILLEGAL_ARGUMENT = - 400 参数错误。

RESERVE_ERROR_NO_PERMISSION = 403

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

  • 未开通音视频通话 2.0 服务,或试用期已过、未及时续费等。
  • 安全模式下加入房间时未设置 Token。
  • 其他权限问题。
RESERVE_ERROR_TIME_OUT = 408 请求超时。
RESERVE_ERROR_INVALID_PARAMETER = 414 参数错误。
RESERVE_ERROR_RESERVE_SERVER_FAIL = 500 分配房间时,服务器出错。
RESERVE_ERROR_MORE_THAN_TWO_USER = 600 有第三个用户尝试加入只支持两个用户的房间。
ENGINE_ERROR_FATAL = 30001 内部错误。
ENGINE_ERROR_OUT_OF_MEMORY = 30002 内存溢出。
ENGINE_ERROR_INVALID_PARAM = 30003 参数错误。
ENGINE_ERROR_NOT_SUPPORTED = 30004 不支持。
ENGINE_ERROR_INVALID_STATE = 30005 状态错误。
ENGINE_ERROR_LACK_OF_RESOURCE = 30006 缺乏资源。
ENGINE_ERROR_INVALID_INDEX = 30007 序号非法。
ENGINE_ERROR_DEVICE_NOT_FOUND = 30008 设备未找到。
ENGINE_ERROR_INVALID_DEVICE_SOURCEID = 30009 设备 ID 非法。
ENGINE_ERROR_INVALID_VIDEO_PROFILE = 30010 视频能力非法。
ENGINE_ERROR_CREATE_DEVICE_SOURCE_FAIL = 30011 创建设备失败。
ENGINE_ERROR_INVALID_RENDER = 30012 画布非法。
ENGINE_ERROR_DEVICE_PREVIEW_ALREADY_STARTED = 30013 预览已打开。
ENGINE_ERROR_TRANSMIT_PENDDING = 30014 挂起。
ENGINE_ERROR_CONNECT_FAIL = 30015 连接失败。
ENGINE_ERROR_CREATE_DUMP_FILE_FAIL = 300016 创建 dump 失败。
ENGINE_ERROR_START_DUMP_FAIL = 300017 开始 dump 失败。
ENGINE_ERROR_ROOM_ALREADY_JOINED = 30100 房间已加入。
ENGINE_ERROR_ROOM_NOT_JOINED = 30101 房间未加入。
NGINE_ERROR_ROOM_REPLEATEDLY_LEAVE = 30102 重复离开房间。
ENGINE_ERROR_REQUEST_JOIN_ROOM_FAIL = 30103 请求加入房间失败。
ENGINE_ERROR_SESSION_NOT_FOUND = 30104 会话未找到。
ENGINE_ERROR_USER_NOT_FOUND = 30105 用户未找到。
ENGINE_ERROR_INVALID_USERID = 30106 非法用户。
ENGINE_ERROR_MEDIA_NOT_STARTED = 30107 媒体会话未建立。
ENGINE_ERROR_SOURCE_NOT_FOUND = 30108 媒体源未找到。
SWITCH_CHANNEL_NOT_JOINED = 30109 切换房间时不在会议中。

ENGINE_ERROR_CHANNEL_MEDIARELAY_STATE_INVALID = 30110

媒体流转发状态无效。原因通常为重复调用 startChannelMediaRelay 方法。
成功调用 startChannelMediaRelay 方法后,必须先调用 stopChannelMediaRelay 方法退出当前的转发状态,才能再次调用该方法。

ENGINE_ERROR_CHANNEL_MEDIARELAY_DENIED = 30111

媒体流转发权限不足。原因通常包括:

  • 源房间的房间类型为双人房间(1V1 模式)。此时无法转发媒体流。
  • 调用 startChannelMediaRelay 方法开启媒体流转发的成员角色为观众角色。仅主播角色可以转发媒体流。

ENGINE_ERROR_CHANNEL_MEDIARELAY_STOP_FAILED = 30112

停止媒体流转发操作失败。原因通常为未开启媒体流转发。
请确认调用 stopChannelMediaRelay 方法前,是否已成功调用 startChannelMediaRelay 方法开启媒体流转发。

ENGINE_ERROR_ENCRYPT_NOT_SUITABLE = 30113

设置的媒体流加密密钥与房间中其他成员不一致,加入房间失败。
请通过 enableEncryption 方法重新设置加密密钥。

ENGINE_ERROR_CONNECTION_NOT_FOUND = 30200 连接未找到。
ENGINE_ERROR_STREAM_NOT_FOUND = 30201 媒体流未找到。
ENGINE_ERROR_ADD_TRACK_FAIL = 30202 添加 Track 失败。
ENGINE_ERROR_TRACK_NOT_FOUND = 30203 Track 未找到。
ENGINE_ERROR_MEDIA_CONNECTION_DISCONNECTED = 30204 媒体连接已断开。
ENGINE_ERROR_SIGNAL_DISCONNECTED = 30205 信令断开。
ENGINE_ERROR_SERVER_KICKED = 30206 被管理员踢出房间。
ENGINE_ERROR_ROOM_CLOSED = 30207 房间被关闭。
LEAVE_CHANNEL_FOR_SWITCH = 30208 因为切换房间而离开房间。
LEAVE_CHANNEL_FOR_DUPLICATE_UID = 30209 因为重复 UID 登陆而离开房间。
ENGINE_ERROR_MEDIA_BANNED = 30403 被服务器禁言。

伴音错误码

错误码 说明
AUDIO_MIXING_FINISH = 0 伴音正常结束。
AUDIO_MIXING_ERROR_DECODE = 1 音频解码错误。
AUDIO_MIXING_ERROR_INTERRUPT = 2 操作中断。
AUDIO_MIXING_ERROR_HTTP_NOT_FOUND = 3 404 http/https 对应的文件找不到。
AUDIO_MIXING_ERROR_OPEN = 4 打开流或文件失败。
AUDIO_MIXING_ERROR_NINFO = 5 获取解码信息失败或超时。
AUDIO_MIXING_ERROR_NSTREAM = 6 无音频流。
AUDIO_MIXING_ERROR_NCODEC = 7 无解码器。
AUDIO_MIXING_ERROR_NMEM = 8 无内存。
AUDIO_MIXING_ERROR_CODEC_OPEN = 9 解码器打开失败或超时。
AUDIO_MIXING_ERROR_INVALID_INFO = 10 无效音频参数(声道、采样率)。
AUDIO_MIXING_ERROR_OPEN_TIMEOUT = 11 打开流或文件超时。
AUDIO_MIXING_ERROR_IO_TIMEOUT = 12 网络 I/O 超时。
AUDIO_MIXING_ERROR_IO = 13 网络 I/O 错误。

直播推流错误码

错误码 说明
STATE_PUSHING = 505 推流中。
STATE_PUSH_FAIL = 506 互动直播推流失败。
STATE_PUSH_STOPPED = 511 推流结束。
STATE_IMAGE_ERROR = 512 背景图片设置出错。

客户端录音状态码

错误码 说明
AUDIO_RECORD_ERROR_SUFFIX = 1 不支持的录音文件格式。

AUDIO_RECORD_OPEN_FILE_FAILED = 2

无法创建录音文件,原因通常包括:

  • 应用没有磁盘写入权限。
  • 文件路径不存在。
AUDIO_RECORD_START = 3 开始录制。
AUDIO_RECORD_ERROR = 4 录制错误。原因通常为磁盘空间已满,无法写入。
AUDIO_RECORD_FINISH = 5 完成录制。

视频水印状态码

错误码 说明
LVW_STATE_DEVICE_NOT_SUPPORTED = 1 设备不支持。
LVW_STATE_IMG_FORMAT_NOT_SUPPORTED = 2 图片格式不支持。
LVW_STATE_IMG_NUM_ERR = 3 图片数量设置错误。
LVW_STATE_IMG_SIZE_ERR = 4 图片尺寸设置错误。
LVW_STATE_IMG_FPS_ERR = 5 图片分辨率设置错误。
LVW_STATE_FONT_ERR = 6 字体设置错误。
LVW__STATE_CANCEL = 20 取消水印。

其他错误码

错误码 说明
ADM_RECORD_START_ERROR = 40632 录制时,麦克风打开失败。
ADM_NO_AUTHORIZE = 50000 不支持的录音文件格式。
VDM_NO_AUTHORIZE = 50001 没有视频权限。

ADM_RECORD_INIT_ERROR = 50103

无法创建录音文件,原因通常包括:

  • 应用没有磁盘写入权限。
  • 文件路径不存在。
ADM_RECORD_UNKNOWN_ERROR = 50105 录制时,麦克风运行错误。
ADM_PLAYOUT_INIT_ERROR = 50203 音频播放设备初始化失败。
ADM_PLAYOUT_START_ERROR = 50204 音频播放设备打开失败。
ADM_PLAYOUT_UNKNOWN_ERROR = 50205 音频播放设备运行错误。
VDM_CAMERA_DISCONNECT_ERROR = 50303 相机被其他应用抢占。
VDM_CAMERA_FREEZED_ERROR = 50304 相机已冻结。
VDM_CAMERA_UNKNOWN_ERROR = 50305 相机运行错误。
此文档是否对你有帮助?
有帮助
去反馈
  • 通用错误码
  • 伴音错误码
  • 直播推流错误码
  • 客户端录音状态码
  • 视频水印状态码
  • 其他错误码