tencent cloud

文档反馈

错误码

最后更新时间:2024-03-26 10:55:04
    注意:
    本文适用于 5.x.x 版本的 TRTC Web SDK。
    TRTC SDK v5.0 定义了 8 种错误码类型,通过 RtcError 对象来获取 RtcError.code 并做相应的处理。

    错误码定义

    Key
    Code
    描述
    5000
    说明:调用接口时传入了不满足 API 要求的参数 处理建议:请检查传入参数是否符合 API 的规范,例如参数类型是否正确。
    5100
    说明:调用接口时,不满足 API 的前提要求。 处理建议:请根据对应 API 文档检查调用逻辑是否符合 API 的前提要求。例如:1.未进房成功就进行切换角色,2.播放的远端用户和流不存在。
    5200
    说明:当前环境不支持该功能,表明当前浏览器不支持调用对应 API 处理建议:通常使用 TRTC.isSupported 可感知当前浏览器支持哪些能力。如果浏览器不支持,需要引导用户使用支持该能力的浏览器,参考:检测浏览器支持性
    5300
    说明:获取设备或者采集音视频出现异常
    以下接口出现异常时会抛出该错误码:startLocalVideo、updateLocalVideo、startLocalAudio、updateLocalAudio、startScreenShare、updateScreenShare
    处理建议:引导用户检查设备是否有摄像头及麦克风、系统是否给浏览器授权以及浏览器是否给页面授权。建议增加进房前的设备检测流程,确认麦克风和摄像头是否存在,并且能正常采集,再进行下一步通话操作。通常经过设备检查后都能避免该异常。 实现方式请参考:通话前环境与设备检测
    如果需要区分更详细的异常类别,可以参考 extraCode
    5400
    说明:收到服务端返回的异常数据时抛出该错误码 以下接口出现异常时会抛出该错误码:enterRoom、startLocalVideo、startLocalAudio、startScreenShare、startRemoteVideo、switchRole 处理建议:服务端异常通常在开发阶段处理,常见的异常有:传入的 userSig 过期,腾讯云账号欠费,未开通TRTC服务等,服务端返回异常数据有以下原因。
    5500
    说明:在满足 API 调用要求的情况下,SDK 经过多次重试仍然无法解决的异常,通常是由于浏览器、网络的问题造成。 以下接口出现异常时会抛出该错误码:enterRoom、startLocalVideo、startLocalAudio、startScreenShare、startRemoteVideo、switchRole 处理建议:
    确认通信必需的域名和端口是否满足您的网络环境要求,参考文档应对防火墙限制及设置代理
    其他问题需要联系工程师处理,在 Telegram 联系我们
    5998
    说明:中止 API 执行时抛出该错误码。在不满足 API 生命周期的调用或重复调用时 API 会中止执行,避免无意义的操作。 例如:连续调用 enterRoom,startLocalXxx等接口,在没有进房就调用退房。 以下接口出现异常时会抛出该错误码:enterRoom、startLocalVideo、startLocalAudio、startScreenShare、startRemoteVideo、switchRole 处理建议:捕获并识别该错误码,然后在业务逻辑规避不必要的调用,或者也可以不做任何处理,因为 SDK 做了无副作用处理,您只需在 catch 时识别该错误码并忽略。
    5999
    说明:未知错误或者未被定义的错误
    处理建议:联系工程师处理在 Telegram 联系我们
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持