音视频通话 2.0
Android
动态与公告
更新日志(V4.6)
更新日志(V5)
活动与公告
【活动】音视频通话内容安全检测限时补贴
【活动】赠送100万分钟音视频通话时长
【邀测】音视频通话2.0V5.3邀请公测
新手接入指南
产品简介
产品介绍
功能特性
产品优势
应用场景
基本概念
使用限制
性能指标
产品计费
按量计费
资源包
体验 Demo
下载 SDK 和示例代码
升级指南
快速开始
快速跑通 Sample Code
接入流程
创建应用
开通服务
集成 SDK
实现音视频通话
Token 鉴权
高级 Token 鉴权
基础功能
设置音频属性
设置视频属性
设置视频旋转方向
设置通话音量
屏幕共享
音频共享
监测发言者音量
通话前网络质量探测
通话中质量监测
进阶功能
音频管理
客户端音频录制
原始音频数据
美声变声与混响
耳返
自定义音频采集与渲染
音效与伴音
设置音频订阅优先级
音频裸流传输
媒体补充增强信息SEI
视频管理
视频截图
水印
云信美颜
相芯美颜
自定义视频采集
虚拟背景
视频图像畸变矫正
视频裸流传输
多房间管理
设备管理
视频设备管理
音频设备管理
媒体流管理
跨房间媒体流转发
媒体流加密
视频流回退
云端录制
使用云代理
本地服务端录制
AI 融合功能
AI 超分
AI 降噪
场景实践
1 对 1 娱乐社交
语聊房
PK连麦
在线教育
互联网问诊
最佳实践
音视频参数配置推荐
房间连接状态管理
实现音视频安全检测
轻松构建本土Clubhouse
API 参考
Android API 参考
服务端 API
错误码(V5)
错误码(V4.x)
控制台指南
常见问题处理
FAQ
错题集
获取音频 Dump 文件
音频常见问题排查
视频常见问题排查
服务协议

错误码(V4.x)

更新时间: 2023/05/05 20:33:15

在调用 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 相机运行错误。
此文档是否对你有帮助?
有帮助
我要吐槽
  • 通用错误码
  • 伴音错误码
  • 直播推流错误码
  • 客户端录音状态码
  • 视频水印状态码
  • 其他错误码