实时音视频 > API 文档 > Android >QNErrorCode

QNErrorCode

最近更新时间: 2023-08-17 15:47:03

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

若返回的错误码本文未提及，请提交工单或者联系七牛技术支持同学协助解决

房间相关错误码

枚举值	错误码	说明	处理方式
SUCCESS	0	无错误	无
ERROR_TOKEN_ERROR	10001	房间 Token 错误	表示您提供的房间 token 不符合七牛 token 签算规则，详情请参考 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_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 操作

枚举值	错误码	说明	处理方式
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_FETCH_TOKEN	25001	获取 token 失败	请检查网络是否联通，并重新上传
ERROR_READ_FILE	25002	读取日志文件失败	当前日志文件不可用，需重新复现场景并上传
ERROR_INVALID_DIR	25003	非法日志文件存储路径	检查日志文件存储路径的合法性以及是否拥有该路径存储空间的访问权限
ERROR_NETWORK_TIMEOUT	21004	操作超时	保证网络情况良好的情况下，尝试重新操作
其他	无	其他错误，可参考上传错误码文档	根据对应的错误码处理建议处理

以上内容是否对您有帮助？