实时音视频

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

    错误码

    最近更新时间:2022-03-24 15:40:56

    本文主要介绍 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_CAMERA_EVICTED23002摄像头被其他应用抢占请确认是否有其他应用抢占摄像头
    ERROR_MIC_INIT_FAILED23006系统麦克风初始化错误,无权限或者麦克风被占用请确认应用是否获取音频录制的权限或者麦克风是否被占用
    ERROR_MIC_CAPTURE_FAILED23007麦克风录制失败可尝试取消发布并重新发布麦克风 Track
    Err_Speaker_Init_failed23008扬声器无权限或者被占用请确认应用是否获取音频播放的权限或者扬声器被占用

    发布 Track 相关错误码

    枚举值错误码说明处理方式
    ERROR_INVALID_PARAMETER10053非法参数请检查待发布 Track 是否为本地 Track,并且不为空
    ERROR_INVALID_STATE21002非法状态请检查是否已经加入房间
    ERROR_FATAL21005非预期错误RTC 生命周期异常,需要释放资源并重新初始化

    CDN 转推相关错误码

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

    跨房媒体转发相关错误码

    枚举值错误码说明处理方式
    Err_Relay_Token_Invalid24000Token 验证失败请确认 Token 签算是否正确
    Err_Relay_Already_Start24001已开启跨房请勿重复操作
    Err_Relay_Not_Start24002跨房没有开启请先开启跨房再进行操作
    Err_Relay_Destination_Room_Not_Existed24003目标房间不存在请确认跨房的目标房间是否存在
    Err_Relay_Player_In_Dest_Room24004用户不在目标房间内请确认用户是否在目标房间内
    Err_Relay_Start_Failed24004跨房开启失败请确认跨房参数是否正确
    Err_Invalid_Client_Mode24006使用场景不符请切换到互动直播场景
    Err_Invalid_Client_Role24007用户角色不符请根据当前场景切换到指定角色再进行操作
    以上内容是否对您有帮助?
  • Qvm free helper
    Close