human: 如何处理七牛云的实时音视频错误码

gpt: [实时音视频](https://developer.qiniu.com/rtc) > 使用指南 > Android >错误码

#  错误码

最近更新时间: 2024-08-23 17:56:29

本文主要介绍 Android QNRTC SDK 相关的错误码及其建议的处理方式。

> 若返回的错误码本文未提及，请[提交工单](https://support.qiniu.com/tickets/new)或者联系七牛技术支持同学协助解决

# 房间相关错误码

枚举值| 错误码| 说明| 处理方式  
---|---|---|---  
SUCCESS| 0| 无错误| 无  
ERROR_TOKEN_ERROR| 10001| 房间 Token 错误| 表示您提供的房间 token 不符合七牛 token 签算规则，详情请参考
[RoomToken 签发服务](https://developer.qiniu.com/rtc/8813/roomToken)  
ERROR_TOKEN_EXPIRED| 10002| 房间 Token 过期| 表示您的房间 token 过期，需要重新生成 token 再加入  
ERROR_PLAYER_ALREADY_EXIST| 10022| 房间内已经有同名用户|
后台如果配置为开启“禁止自动踢人”，则同一用户重复加入/未正常退出再加入会触发此错误  
ERROR_MEDIA_CAP_NOT_SUPPORT| 10054| 媒体协商失败| 表示该设备不支持指定的音视频格式，无法进行连麦的操作  
ERROR_AUTH_FAILED| 21001| 加入房间认证失败| 服务验证时出错，可能为服务网络异常，也可能是 token 验证失败，建议检查签算
token 的信息是否异常，若 token 无误，可重新尝试加入房间  
ERROR_RECONNECT_FAILED| 21003| 30s 内未能重连成功或者重连时房间已被销毁| 建议检查网络并重新申请 token
加入房间。当发生该错误时，之前创建的转推任务将被服务销毁，如有需要，应在下次成功加入房间后按业务需要恢复  
ERROR_FATAL| 21005| 非预期错误| 表示 RTC 生命周期异常，需要释放资源并重新初始化  
  
> **SDK 重连机制：**
>
> SDK 内部会尝试不断重连，但若 30s 内无法完成有效的重连过程，则超时后的重连请求在到达 RTC 服务后会抛出
> `ERROR_RECONNECT_FAILED` 错误

# 设备采集相关错误码

枚举值| 错误码| 说明| 处理方式  
---|---|---|---  
ERROR_DEVICE_CAMERA| 23001| 系统摄像头错误，无权限或者摄像头被占用| 请确认应用是否获取 Camera
的权限或者摄像头是否被占用  
ERROR_DEVICE_CAMERA_EVICTED| 23002| 摄像头被其他应用抢占| 请确认是否有其他应用抢占摄像头  
ERROR_MIC_INIT_FAILED| 23006| 系统麦克风初始化错误，无权限或者麦克风被占用|
请确认应用是否获取音频录制的权限或者麦克风是否被占用  
ERROR_MIC_CAPTURE_FAILED| 23007| 麦克风录制失败| 可尝试取消发布并重新发布麦克风 Track  
ERROR_IMAGE_PARSER_FAILED| 25004| 图片推流解析图片失败| 可尝试重新进行图片推流的操作  
  
# 发布 Track 相关错误码

枚举值| 错误码| 说明| 处理方式  
---|---|---|---  
ERROR_INVALID_PARAMETER| 10053| 非法参数| 请检查待发布 Track 是否为本地 Track，并且不为空  
ERROR_INVALID_STATE| 21002| 非法状态| 请检查是否已经加入房间  
ERROR_FATAL| 21005| 非预期错误| RTC 生命周期异常，需要释放资源并重新初始化  
  
# 混音相关错误码

枚举值| 错误码| 说明| 处理方式  
---|---|---|---  
ERROR_AUDIO_MIXING_RESAMPLE_CREATE_FAILED| 22001| 重采样模块创建失败| 请重新尝试混音操作  
ERROR_AUDIO_MIXING_AUDIO_NOT_FOUND| 22002| 混音源没有找到有效音轨| 请检查混音源文件是否存在有效音轨  
ERROR_AUDIO_MIXING_IO_EXCEPTION| 22003| 混音源文件 IO 错误| 请检查混音源文件是否合法。SDK
支持的音频文件格式为：aac、mp3、mp4、ogg、opus、wav、m4a、flac；若混音的是在线音频，请检查网络是否正常  
ERROR_AUDIO_MIXING_DECODER_EXCEPTION| 22004| 音频解码异常| 可通过 start
接口重新尝试混音操作。若混音的是在线音频，请检查网络是否正常  
ERROR_AUDIO_MIXING_SEEK_FAILED| 22005| seek 失败| 请检查是否在开始混音前执行了 Seek 操作  
  
# CDN 转推相关错误码

枚举值| 错误码| 说明| 处理方式  
---|---|---|---  
ERROR_NO_PERMISSION| 10051| 无操作权限| 请确认用户 RoomToken 签算时是否有赋予转推权限  
ERROR_INVALID_PARAMETER| 10053| 参数错误| 请检查操作的参数是否合法  
ERROR_INVALID_STATE| 21002| 状态异常| 请检查房间状态，加入房间后才可以创建转推任务  
ERROR_NETWORK_TIMEOUT| 21004| 操作超时| 请重新尝试操作  
ERROR_FATAL| 21005| 服务端错误| 请重新尝试操作或者联系七牛技术支持同学协助定位  
ERROR_LIVE_STREAMING_CLOSED| 21009| 转推任务已关闭| 通常服务端禁播或者直播流异常断开会回调此错误  
  
# 跨房媒体转发相关错误码

枚举值| 错误码| 说明| 处理方式  
---|---|---|---  
ERROR_RELAY_TOKEN_ERROR| 24000| Token 验证失败| 请确认 Token 签算是否正确  
ERROR_INVALID_CLIENT_MODE| 24001| 使用场景不符| 请切换到互动直播场景  
ERROR_INVALID_CLIENT_ROLE| 24002| 用户角色不符| 请根据当前场景切换到指定角色再进行操作  
  
# 日志上传相关错误码

枚举值| 错误码| 说明| 处理方式  
---|---|---|---  
ERROR_FETCH_TOKEN| 25001| 获取 token 失败| 请检查网络是否联通，并重新上传  
ERROR_READ_FILE| 25002| 读取日志文件失败| 当前日志文件不可用，需重新复现场景并上传  
ERROR_INVALID_DIR| 25003| 非法日志文件存储路径| 检查日志文件存储路径的合法性以及是否拥有该路径存储空间的访问权限  
ERROR_NETWORK_TIMEOUT| 21004| 操作超时| 保证网络情况良好的情况下，尝试重新操作  
其他| 无| 其他错误，可参考[上传错误码](https://developer.qiniu.com/insight/5256/the-error)文档|
根据对应的错误码处理建议处理  
  
# 音视频本地录制相关错误码

枚举值| 错误码| 说明| 处理方式  
---|---|---|---  
ERROR_RECORD_FORMAT_FAILED| 40001| 封装格式操作失败| 请检查传入的文件地址  
ERROR_RECORD_STREAM_FAILED| 40002| 流信息操作失败|  
ERROR_RECORD_WRITE_FAILED| 40003| 录制过程中写入失败| 请检查数据源  
ERROR_RECORD_RESAMPLE_FAILED| 40004| 录制过程中重采样操作失败| 内部错误  
ERROR_RECORD_NO_TRACK| 40005| 没有可录制的流（采集中断或远端取消发布中断超过 5s）| 检查输入的 track  
ERROR_RECORD_CONFIG_CHANGED| 40006| 录制源配置被改变| 检查是否改变了 track
相关配置，视频需确保开启了保持分辨率的配置  
ERROR_RECORD_OUT_OF_MEMORY| 40007| 存储空间不足| 请确认存储空间大小  
ERROR_RECORD_SCALE_FAILED| 40008| 录制过程中缩放操作失败| 内部错误  
  
# 播放器相关错误码

枚举值| 错误码| 说明| 处理方式  
---|---|---|---  
ERROR_PLAYER_OPEN_FILE_FAILED| 50001| 打开文件失败| 请检查传入的文件地址  
ERROR_PLAYER_DECODER_FAILED| 50002| 解码失败| 请检查视频文件格式是否支持  
ERROR_PLAYER_SEEK_FAILED| 50003| seek 失败| 请确认文件是否支持 seek  
ERROR_PLAYER_INVALID_STATE| 50004| 无效的播放状态| 请检查当前播放器状态  
  
以上内容是否对您有帮助？