实时音视频

    • 实时音视频 > 使用指南 > Android >错误码

    错误码

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

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

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

    房间相关错误码

    枚举值错误码说明处理方式
    SUCCESS0无错误无
    ERROR_TOKEN_ERROR10001房间 Token 错误表示您提供的房间 token 不符合七牛 token 签算规则，详情请参考 RoomToken 签发服务
    ERROR_TOKEN_EXPIRED10002房间 Token 过期表示您的房间 token 过期，需要重新生成 token 再加入
    ERROR_PLAYER_ALREADY_EXIST10022房间内已经有同名用户后台如果配置为开启“禁止自动踢人”，则同一用户重复加入/未正常退出再加入会触发此错误
    ERROR_MEDIA_CAP_NOT_SUPPORT10054媒体协商失败表示该设备不支持指定的音视频格式，无法进行连麦的操作
    ERROR_AUTH_FAILED21001加入房间认证失败服务验证时出错，可能为服务网络异常，也可能是 token 验证失败，建议检查签算 token 的信息是否异常，若 token 无误，可重新尝试加入房间
    ERROR_RECONNECT_FAILED2100330s 内未能重连成功或者重连时房间已被销毁建议检查网络并重新申请 token 加入房间。当发生该错误时，之前创建的转推任务将被服务销毁，如有需要，应在下次成功加入房间后按业务需要恢复
    ERROR_FATAL21005非预期错误表示 RTC 生命周期异常，需要释放资源并重新初始化

    SDK 重连机制：

    SDK 内部会尝试不断重连，但若 30s 内无法完成有效的重连过程，则超时后的重连请求在到达 RTC 服务后会抛出 ERROR_RECONNECT_FAILED 错误

    设备采集相关错误码

    枚举值错误码说明处理方式
    ERROR_DEVICE_CAMERA23001系统摄像头错误，无权限或者摄像头被占用请确认应用是否获取 Camera 的权限或者摄像头是否被占用
    ERROR_DEVICE_CAMERA_EVICTED23002摄像头被其他应用抢占请确认是否有其他应用抢占摄像头
    ERROR_MIC_INIT_FAILED23006系统麦克风初始化错误，无权限或者麦克风被占用请确认应用是否获取音频录制的权限或者麦克风是否被占用
    ERROR_MIC_CAPTURE_FAILED23007麦克风录制失败可尝试取消发布并重新发布麦克风 Track
    ERROR_IMAGE_PARSER_FAILED25004图片推流解析图片失败可尝试重新进行图片推流的操作

    发布 Track 相关错误码

    枚举值错误码说明处理方式
    ERROR_INVALID_PARAMETER10053非法参数请检查待发布 Track 是否为本地 Track，并且不为空
    ERROR_INVALID_STATE21002非法状态请检查是否已经加入房间
    ERROR_FATAL21005非预期错误RTC 生命周期异常，需要释放资源并重新初始化

    混音相关错误码

    枚举值错误码说明处理方式
    ERROR_AUDIO_MIXING_RESAMPLE_CREATE_FAILED22001重采样模块创建失败请重新尝试混音操作
    ERROR_AUDIO_MIXING_AUDIO_NOT_FOUND22002混音源没有找到有效音轨请检查混音源文件是否存在有效音轨
    ERROR_AUDIO_MIXING_IO_EXCEPTION22003混音源文件 IO 错误请检查混音源文件是否合法。SDK 支持的音频文件格式为：aac、mp3、mp4、ogg、opus、wav、m4a、flac；若混音的是在线音频，请检查网络是否正常
    ERROR_AUDIO_MIXING_DECODER_EXCEPTION22004音频解码异常可通过 start 接口重新尝试混音操作。若混音的是在线音频，请检查网络是否正常
    ERROR_AUDIO_MIXING_SEEK_FAILED22005seek 失败请检查是否在开始混音前执行了 Seek 操作

    CDN 转推相关错误码

    枚举值错误码说明处理方式
    ERROR_NO_PERMISSION10051无操作权限请确认用户 RoomToken 签算时是否有赋予转推权限
    ERROR_INVALID_PARAMETER10053参数错误请检查操作的参数是否合法
    ERROR_INVALID_STATE21002状态异常请检查房间状态，加入房间后才可以创建转推任务
    ERROR_NETWORK_TIMEOUT21004操作超时请重新尝试操作
    ERROR_FATAL21005服务端错误请重新尝试操作或者联系七牛技术支持同学协助定位
    ERROR_LIVE_STREAMING_CLOSED21009转推任务已关闭通常服务端禁播或者直播流异常断开会回调此错误

    跨房媒体转发相关错误码

    枚举值错误码说明处理方式
    ERROR_RELAY_TOKEN_ERROR24000Token 验证失败请确认 Token 签算是否正确
    ERROR_INVALID_CLIENT_MODE24001使用场景不符请切换到互动直播场景
    ERROR_INVALID_CLIENT_ROLE24002用户角色不符请根据当前场景切换到指定角色再进行操作

    日志上传相关错误码

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

    音视频本地录制相关错误码

    枚举值错误码说明处理方式
    ERROR_RECORD_FORMAT_FAILED40001封装格式操作失败请检查传入的文件地址
    ERROR_RECORD_STREAM_FAILED40002流信息操作失败
    ERROR_RECORD_WRITE_FAILED40003录制过程中写入失败请检查数据源
    ERROR_RECORD_RESAMPLE_FAILED40004录制过程中重采样操作失败内部错误
    ERROR_RECORD_NO_TRACK40005没有可录制的流（采集中断或远端取消发布中断超过 5s）检查输入的 track
    ERROR_RECORD_CONFIG_CHANGED40006录制源配置被改变检查是否改变了 track 相关配置，视频需确保开启了保持分辨率的配置
    ERROR_RECORD_OUT_OF_MEMORY40007存储空间不足请确认存储空间大小
    ERROR_RECORD_SCALE_FAILED40008录制过程中缩放操作失败内部错误

    播放器相关错误码

    枚举值错误码说明处理方式
    ERROR_PLAYER_OPEN_FILE_FAILED50001打开文件失败请检查传入的文件地址
    ERROR_PLAYER_DECODER_FAILED50002解码失败请检查视频文件格式是否支持
    ERROR_PLAYER_SEEK_FAILED50003seek 失败请确认文件是否支持 seek
    ERROR_PLAYER_INVALID_STATE50004无效的播放状态请检查当前播放器状态
    以上内容是否对您有帮助？
    • Close