实时音视频

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

    错误码

    最近更新时间: 2022-06-30 17:12:54

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

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

    房间相关错误码

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

    SDK 重连机制:

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

    发布 Track 相关错误码

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

    混音相关错误码

    枚举值错误码说明处理方式
    QNAudioMixErrorResampleFailed22001重采样模块创建失败请重新尝试混音操作
    QNAudioMixErrorAudioNotFound22002混音源没有找到有效音轨请检查混音文件的合法性
    QNAudioMixErrorIOException22003混音源文件 IO 错误请检查混音源文件是否存在异常
    QNAudioMixErrorDecoderException22004系统不支持混音源中的音频类型支持的音频文件格式为:aac、mp3、mp4、ogg、opus、wav、m4a、flac
    QNAudioMixErrorSeekFailed22005seek 失败请检查是否在开始混音前执行了 Seek 操作

    CDN 转推相关错误码

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

    跨房媒体转发相关错误码

    枚举值错误码说明处理方式
    QNMediaRelayErrorTokenError24000跨房转推 Token 错误请检查 Token 是否可用
    QNMediaRelayErrorAlreadyStart24001当前跨房已开始跨房已开始,请确认实际状态
    QNMediaRelayErrorNotStart24002当前跨房未开始跨房未开始,请确认实际状态
    QNMediaRelayErrorDestinationRoomNotExisted24003目标房间不存在请确认目标房间 是否存在
    QNMediaRelayErrorPlayerInDestRoom24004已在房间内不可重复跨进同一房间
    QNMediaRelayErrorStartFailed24005开始失败跨房失败
    QNRTCErrorInvalidMode24006使用场景不符请确认实际使用场景
    QNRTCErrorInvalidRole24007用户角色不符请确认实际用户角色
    以上内容是否对您有帮助?
  • Qvm free helper
    Close