实时音视频

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

    错误码

    最近更新时间:2021-11-04 15:15:10

    本文主要介绍 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系统摄像头错误,无需权限或者被占用请确认应用是否获取相应的权限
    ERROR_DEVICE_CAMERA_EVICTED23002摄像头被其他应用抢占请确认是否有其他应用抢占摄像头

    发布 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 错误请检查混音源文件是否存在异常
    ERROR_AUDIO_MIXING_DECODER_EXCEPTION22004系统不支持混音源中的音频类型建议使用 'mp3' 等更通用的音频格式
    ERROR_AUDIO_MIXING_SEEK_FAILED22005seek 失败请检查是否在开始混音前执行了 Seek 操作

    CDN 转推相关错误码

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