错误码
本文主要介绍 iOS QNRTCKit SDK 相关的错误码及其建议的处理方式。
若返回的错误码本文未提及,请提交工单或者联系七牛技术支持同学协助解决
房间相关错误码
枚举值 | 错误码 | 说明 | 处理方式 |
---|---|---|---|
QNRTCErrorTokenError | 10001 | 房间 Token 错误 | 表示您提供的房间 Token 不符合七牛 Token 签算规则,详情请参考 RoomToken 签发服务 |
QNRTCErrorTokenExpired | 10002 | 房间 Token 过期 | 表示您的房间 Token 过期,需要重新生成 Token 再加入 |
QNRTCErrorReconnectTokenError | 10004 | 30s 内未能重连成功或者重连时房间已被销毁 | 建议检查网络并重新申请 Token 加入房间。当发生该错误时,之前创建的转推任务将被服务销毁,如有需要,应在下次成功加入房间后按业务需要恢复 |
QNRTCErrorUserAlreadyExist | 10022 | 房间内已经有同名用户 | 后台如果配置为开启“禁止自动踢人”,则同一用户重复加入/未正常退出再加入会触发此错误 |
QNRTCErrorMediaCapNotSupport | 10054 | 媒体协商失败 | 表示该设备不支持指定的音视频格式,无法进行连麦的操作 |
QNRTCErrorAuthFailed | 21001 | 加入房间认证失败 | 服务验证时出错,可能为服务网络异常,也可能是 Token 验证失败,建议检查签算 Token 的信息是否异常,若 Token 无误,可重新尝试加入房间 |
QNRTCErrorFatalError | 21005 | 非预期错误 | 表示 RTC 当前状态异常,需要释放进行重新初始化 |
SDK 重连机制:
- SDK 内部会尝试无限重连
- 如果 30s 内无法完成有效的重连过程,则超时后的重连请求在到达 RTC 服务后会抛出
QNRTCErrorReconnectTokenError
错误
发布 Track 相关错误码
枚举值 | 错误码 | 说明 | 处理方式 |
---|---|---|---|
QNRTCErrorInvalidParameter | 10053 | 非法参数 | 请检查待发布 Track 是否为本地 Track,并且不为空 |
QNRTCErrorRoomStateError | 21002 | 非法状态 | 请检查是否已经加入房间 |
QNRTCErrorFatalError | 21005 | 非预期错误 | 表示 RTC 当前状态异常,需要释放进行重新初始化 |
混音相关错误码
枚举值 | 错误码 | 说明 | 处理方式 |
---|---|---|---|
QNAudioMixErrorGraphError | 22006 | AUGraph 操作错误 | 情况多种,需要根据实际 log 信息处理 |
QNAudioMixErrorNodeError | 22007 | AUNode 操作错误 | 情况多种,需要根据实际 log 信息处理 |
QNAudioMixErrorReadDataError | 22008 | 读取混音数据发生错误 | 情况多种,需要根据实际 log 信息处理 |
QNAudioMixErrorPropertyError | 22009 | 混音参数设置错误 | 情况多种,需要根据实际 log 信息处理 |
QNAudioMixErrorCallbackError | 22010 | 配置混音相关回调发生错误 | 情况多种,需要根据实际 log 信息处理 |
QNAudioFileErrorOpenFailed | 30001 | 打开音频文件失败 | 若是在线音频请检查网络,本地文件建议检查文件是否存在且完整 |
QNAudioFileErrorDisposeFailed | 30002 | 配置混音相关回调发生错误 | 情况多种,需要根据实际 log 信息处理 |
QNAudioFileErrorPropertyError | 30011 | 音频文件获取或设置属性失败 | 情况多种,需要根据实际 log 信息处理 |
QNAudioFileErrorReadFailed | 30021 | 音频文件读取失败误 | 若是在线音频请检查网络,本地文件建议检查文件是否完整 |
QNAudioFileErrorSeekFailed | 30022 | 混音文件跳转位置失败 | 若是在线音频请检查网络 |
QNAudioFileErrorFileNotExist | 30031 | 音频文件不存在 | 请检查是否正确传入混音音频文件地址 |
CDN 转推相关错误码
枚举值 | 错误码 | 说明 | 处理方式 |
---|---|---|---|
QNRTCErrorNoPermission | 10051 | 无操作权限 | 请检查用户的 Token 签算权限 |
QNRTCErrorInvalidParameter | 10053 | 参数错误 | 请检查操作的参数是否合法 |
QNRTCErrorRoomStateError | 21002 | 状态异常 | 请检查房间状态,加入房间后才可以创建转推任务 |
QNRTCErrorFatalError | 21005 | 服务端错误 | 请重新尝试操作或者联系七牛技术支持同学协助定位 |
文档反馈
(如有产品使用问题,请提交工单)