实时音视频

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

    错误码

    最近更新时间: 2024-08-16 17:44:40

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

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

    房间相关错误码

    枚举值错误码说明处理方式
    QNRTCErrorTokenError10001房间 Token 错误表示您提供的房间 Token 不符合七牛 Token 签算规则，详情请参考 RoomToken 签发服务
    QNRTCErrorTokenExpired10002房间 Token 过期表示您的房间 Token 过期，需要重新生成 Token 再加入
    QNRTCErrorUserAlreadyExist10022房间内已经有同名用户后台如果配置为开启“禁止自动踢人”，则同一用户重复加入/未正常退出再加入会触发此错误
    QNRTCErrorMediaCapNotSupport10054媒体协商失败表示该设备不支持指定的音视频格式，无法进行连麦的操作
    QNRTCErrorAuthFailed21001加入房间认证失败服务验证时出错，可能为服务网络异常，也可能是 Token 验证失败，建议检查签算 Token 的信息是否异常，若 Token 无误，可重新尝试加入房间
    QNRTCErrorReconnectFailed21003房间重连失败表示 SDK 发生掉线,并且 30s 内无法完成有效的重连
    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用户角色不符请确认实际用户角色

    通用错误码

    枚举值错误码说明处理方式
    QNErrorCodeNotInitialized30001没有初始化，用于 SDK 或者对象没有初始化的情况下，调用了 API请检查初始化是否正常
    QNErrorCodeUnauthorizedDomain30002未授权的域名，推流地址的域名，未通过后台审核请在后台确认审核状态
    QNErrorCodeDuplicatedOperation30003重复调用 API，可能会触发下面错误请确认调用逻辑

    录制相关错误码

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

    播放器相关错误码

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