实时音视频

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

    错误码

    最近更新时间: 2024-12-24 14:52:30

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

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

    房间相关错误码

    枚举值错误码说明处理方式
    TokenError10001房间 Token 错误表示您提供的房间 Token 不符合七牛 Token 签算规则，详情请参考 RoomToken 签发服务
    TokenExpired10002房间 Token 过期表示您的房间 Token 过期，需要重新生成 Token 再加入
    UserAlreadyExist10022房间内已经有同名用户后台如果配置为开启“禁止自动踢人”，则同一用户重复加入/未正常退出再加入会触发此错误
    AuthFailed21001加入房间认证失败服务验证时出错，可能为服务网络异常，也可能是 Token 验证失败，建议检查签算 Token 的信息是否异常，若 Token 无误，可重新尝试加入房间
    ReconnectFailed21003房间重连失败表示 SDK 发生掉线,并且 30s 内无法完成有效的重连
    FatalError21005非预期错误表示 RTC 当前状态异常，需要释放进行重新初始化

    SDK 重连机制：

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

    设备采集相关错误码

    枚举值错误码说明处理方式
    CameraInitFailed23001系统摄像头错误，无权限或者摄像头被占用请确认应用是否获取摄像头的权限或者摄像头是否被占用
    ScreenCaptureFailed23003屏幕采集失败请确认应用配置参数是否正确
    MicInitFailed23006系统麦克风初始化错误，无权限或者麦克风被占用请确认应用是否获取音频录制的权限或者麦克风是否被占用
    MicCaptureFailed23007麦克风录制失败，彻底失去音频焦点提示音频停止，需要通过执行 QNMicrophoneAudioTrack.StopRecording 和 QNMicrophoneAudioTrack.StartRecording 的方式重启麦克风

    发布 Track 相关错误码

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

    CDN 转推相关错误码

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

    通用错误码

    枚举值错误码说明处理方式
    NotInitialized30001没有初始化，用于 SDK 或者对象没有初始化的情况下，调用了 API请检查初始化是否正常
    UnauthorizedDomain30002未授权的域名，推流地址的域名，未通过后台审核请在后台确认审核状态
    DuplicatedOperation30003重复调用 API，可能会触发下面错误请确认调用逻辑
    以上内容是否对您有帮助？
    • Qvm free helper
    Close