实时音视频

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

    错误码

    最近更新时间:2021-11-08 15:54:08

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

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

    房间相关错误码

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

    SDK 重连机制:

    • SDK 内部会尝试无限重连
    • 如果 30s 内无法完成有效的重连过程,则超时后的重连请求在到达 RTC 服务后会抛出 QNRTCErrorReconnectTokenError 错误

    发布 Track 相关错误码

    枚举值错误码说明处理方式
    QNRTCErrorInvalidParameter10053非法参数请检查待发布 Track 是否为本地 Track,并且不为空
    QNRTCErrorRoomStateError21002非法状态请检查是否已经加入房间
    QNRTCErrorFatalError21005非预期错误表示 RTC 当前状态异常,需要释放进行重新初始化

    混音相关错误码

    枚举值错误码说明处理方式
    QNAudioMixErrorGraphError22006AUGraph 操作错误情况多种,需要根据实际 log 信息处理
    QNAudioMixErrorNodeError22007AUNode 操作错误情况多种,需要根据实际 log 信息处理
    QNAudioMixErrorReadDataError22008读取混音数据发生错误情况多种,需要根据实际 log 信息处理
    QNAudioMixErrorPropertyError22009混音参数设置错误情况多种,需要根据实际 log 信息处理
    QNAudioMixErrorCallbackError22010配置混音相关回调发生错误情况多种,需要根据实际 log 信息处理
    QNAudioFileErrorOpenFailed30001打开音频文件失败若是在线音频请检查网络,本地文件建议检查文件是否存在且完整
    QNAudioFileErrorDisposeFailed30002配置混音相关回调发生错误情况多种,需要根据实际 log 信息处理
    QNAudioFileErrorPropertyError30011音频文件获取或设置属性失败情况多种,需要根据实际 log 信息处理
    QNAudioFileErrorReadFailed30021音频文件读取失败误若是在线音频请检查网络,本地文件建议检查文件是否完整
    QNAudioFileErrorSeekFailed30022混音文件跳转位置失败若是在线音频请检查网络
    QNAudioFileErrorFileNotExist30031音频文件不存在请检查是否正确传入混音音频文件地址

    CDN 转推相关错误码

    枚举值错误码说明处理方式
    QNRTCErrorNoPermission10051无操作权限请检查用户的 Token 签算权限
    QNRTCErrorInvalidParameter10053参数错误请检查操作的参数是否合法
    QNRTCErrorRoomStateError21002状态异常请检查房间状态,加入房间后才可以创建转推任务
    QNRTCErrorFatalError21005服务端错误请重新尝试操作或者联系七牛技术支持同学协助定位
    以上内容是否对您有帮助?
  • Qvm free helper
    Close