腾讯云实时音视频错误码_音视频解决方案_同尘科技

实时音视频 2年前 (2023-08-16) 浏览 100

注意:本文适用于 5.x.x 版本的 TRTC Web SDK,详情参考:ERROR_CODE。若您使用 4.x.x 版本,请参考此处文档。TRTC Web SDK 定义了 8 种错误码类型,通过 RtcError 对象来获取 errorCode 并做相应的处理。

错误码定义

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



对音视频的解决方案有疑惑?想了解解决方案收费? 联系解决方案专家

腾讯云限时活动1折起,即将结束: 马上收藏

同尘科技为腾讯云授权服务中心,购买腾讯云享受折上折,更有现金返利:同意关联,立享优惠

阿里云解决方案也看看?: 点击对比阿里云的解决方案

- 0人点赞 -

发表点评 (0条)

not found

暂无评论,你要说点什么吗?