tencent cloud

文档反馈

错误码

最后更新时间:2022-05-19 10:26:58
    注意:

    本文适用于4.x.x版本的 TRTC Web SDK。

    错误码定义

    Key getCode 错误码 描述
    INVALID_PARAMETER 4096 0x1000 无效参数
    处理建议:请检查传入参数是否符合 SDK 要求,例如参数类型是否正确。
    INVALID_OPERATION 4097 0x1001 非法操作
    处理建议:请根据对应接口文档检查 API 调用逻辑是否符合 SDK 要求。例如在未进房的情况下,调用 publish 接口是被禁止的。
    NOT_SUPPORTED 4098 0x1002 调用 SDK 接口时抛出,表明当前浏览器不支持调用对应接口
    • 说明:调用 SDK 接口时抛出,表明当前浏览器不支持调用对应接口
    • 处理建议:引导用户使用 SDK 支持的浏览器,请参见 检测浏览器支持性
    DEVICE_NOT_FOUND 4099 0x1003 当前设备没有麦克风或没有摄像头,但尝试采集麦克风、摄像头。
    处理建议:引导用户检查设备的摄像头及麦克风是否正常,业务侧应当增加进房前的设备检测逻辑,请参见 通话前环境与设备检测
    INITIALIZE_FAILED 4100 0x1004 LocalStream.initialize() 采集失败,请参见 详细处理建议
    SIGNAL_CAHNNEL_SETUP_FAILED 16385 0x4001 信令通道建立失败。通常与腾讯云账号有关,参见具体 帐号相关错误信息
    SIGNAL_CHANNEL_ERROR 16386 0x4002 信令通道错误。
    ICE_TRANSPORT_ERROR 16387 0x4003 ICE Transport 连接错误,即音视频数据传输通道错误。这主要是因为用户端的 UDP 端口异常(可能是用户电脑防火墙或路由器防火墙端口限制)引起,具体端口请参见 端口白名单
    JOIN_ROOM_FAILED 16388 0x4004 进房失败。详细请参见 进房失败相关错误信息
    CREATE_OFFER_FAILED 16389 0x4005 创建 sdp offer 失败。
    SIGNAL_CHANNEL_RECONNECTION_FAILED 16390 0x4006 WebSocket 信令通道重连失败
    • 说明:当 WebSocket 断开时,SDK 会尝试多次重连,如果都失败了,则会抛出此错误
    • 处理建议:提醒用户检查网络,然后重新进房
    UPLINK_RECONNECTION_FAILED 16391 0x4007 上行 PeerConnection 重连失败
    • 说明:当上行 PeerConnection 断开时,SDK 会尝试多次重连,如果都失败了,则会抛出此错误
    • 处理建议:提醒用户检查网络,然后重新推流或者重新进房
    DOWNLINK_RECONNECTION_FAILED 16392 0x4008 下行 PeerConnection 重连失败
    • 说明:当下行 PeerConnection 异常断开时,SDK 会尝试多次重连,如果都失败了,则会抛出此错误
    • 处理建议:提醒用户检查网络,然后重新进房
    REMOTE_STREAM_NOT_EXIST 16400 0x4010 远端流不存在
    • 说明:在 A 尝试订阅 B 推的流时,B 取消推流,导致 A 订阅 B 失败
    • 处理建议:属于正常交互流程,接入侧无需处理
    CLIENT_BANNED 16448 0x4040 用户被踢出房间,被踢原因有:
    • 同名用户进入同一房间,注意:禁止同名用户同时进入同一房间,会导致双方音视频通话异常,业务侧应避免出现这种情况
    • 被账户管理员使用服务端 API 踢出房间
    SERVER_TIMEOUT 16449 0x4041 媒体传输服务超时
    SUBSCRIPTION_TIMEOUT 16450 0x4042 远端流订阅超时
    PLAY_NOT_ALLOWED 16451 0x4043 自动播放被禁止错误
    DEVICE_AUTO_RECOVER_FAILED 16452 0x4044 自动恢复摄像头、麦克风采集失败。该错误在 LocalStream 的 error 事件抛出
    • 当用户的正在推流的媒体设备变更(例如:插拔摄像头、麦克风、接口松动等)时,SDK 会尝试恢复采集。发生此错误说明恢复失败
    • 处理建议:提醒用户 媒体设备自动恢复采集失败,请检查摄像头、麦克风接口是否松动,并确保没有被其他应用占用
    • 可在页面提供重试按钮,当用户点击重试时,重新采集摄像头、麦克风
    START_PUBLISH_CDN_FAILED 16453 0x4045 开始向 CDN 推流失败
    STOP_PUBLISH_CDN_FAILED 16454 0x4046 停止向 CDN 推流失败
    START_MIX_TRANSCODE_FAILED 16455 0x4047 开始混流转码失败
    STOP_MIX_TRANSCODE_FAILED 16456 0x4048 停止混流转码失败
    NOT_SUPPORTED_H264 16457 0x4049 当前设备不支持H.264
    SWITCH_ROLE_FAILED 16458 0x404a 切换角色失败
    UNKOWN 65535 0xFFFF 未知错误

    帐号相关错误信息

    错误码 错误类型 描述
    -8 帐号系统 sdkAppId 不正确,请检查 sdkAppId 是否正确填写
    70001 帐号系统 userSig 过期,请尝试重新生成。如果是刚生成就过期,请检查有效期填写的是否过小或者误填为0
    70002 帐号系统 userSig 长度为0,请确认签名计算是否正确,访问 sign_src 获取计算签名的傻瓜式源码,核对参数,确保签名计算正确性
    70003 帐号系统 userSig 校验失败,请确认下 userSig 内容是否被截断,例如缓冲区长度不够导致的内容截断
    70004 帐号系统 userSig 校验失败,请确认下 userSig 内容是否被截断,例如缓冲区长度不够导致的内容截断
    70005 帐号系统 userSig 校验失败,通过工具来验证生成的 userSig 是否正确。
    70006 帐号系统 userSig 校验失败,通过工具来验证生成的 userSig 是否正确
    70007 帐号系统 userSig 校验失败,通过工具来验证生成的 userSig 是否正确
    70008 帐号系统 userSig 校验失败,通过工具来验证生成的 userSig 是否正确
    70009 帐号系统 用业务公钥验证 userSig 失败,请确认生成的 userSig 使用的私钥和 sdkAppId 是否对应
    70010 帐号系统 userSig 校验失败,通过工具来验证生成的 userSig 是否正确
    70013 帐号系统 userSig 中 userId 与请求时的 userId 不匹配,请检查登录时填写的 userId 与 userSig 中的是否一致
    70014 帐号系统 userSig 中 sdkAppId 与请求时的 sdkAppId 不匹配,请检查登录时填写的 sdkAppId 与 userSig 中的是否一致
    70015 帐号系统 未找到该 sdkAppId 和帐号类型对应的验证方式,请确认是否已进行帐号集成操作
    70016 帐号系统 拉取到的公钥长度为0,请确认是否已上传公钥,如果是重新上传的公钥需要十分钟后再尝试
    70017 帐号系统 内部第三方票据验证超时,请重试,如果多次重试仍不成功,请联系我们
    70018 帐号系统 内部验证第三方票据失败
    70019 帐号系统 通过 HTTPS 方式验证的票据字段为空,请正确填写 userSig
    70020 帐号系统 sdkAppId 未找到,请确认是否已在腾讯云上配置
    70052 帐号系统 userSig 已经失效,请重新生成,再次尝试
    70101 帐号系统 请求包信息为空
    70102 帐号系统 请求包帐号类型错误
    70103 帐号系统 电话号码格式错误
    70104 帐号系统 邮箱格式错误
    70105 帐号系统 TLS 帐号格式错误
    70106 帐号系统 非法帐号格式类型
    70107 帐号系统 userId 没有注册
    70113 帐号系统 批量数量不合法
    70114 帐号系统 安全原因被限制
    70115 帐号系统 uin 不是对应 sdkAppId 的开发者 uin
    70140 帐号系统 sdkAppId 和 acctype 不匹配
    70145 帐号系统 帐号类型错误
    70169 帐号系统 内部错误,请重试。如果多次重试仍不成功,请联系我们
    70201 帐号系统 内部错误,请重试。如果多次重试仍不成功,请联系我们
    70202 帐号系统 内部错误,请重试。如果多次重试仍不成功,请联系我们
    70203 帐号系统 内部错误,请重试。如果多次重试仍不成功,请联系我们
    70204 帐号系统 sdkAppId 没有对应的 acctype
    70205 帐号系统 查找 acctype 失败,请重试
    70206 帐号系统 请求中批量数量不合法
    70207 帐号系统 内部错误,请重试
    70208 帐号系统 内部错误,请重试
    70209 帐号系统 获取开发者 uin 标志失败
    70210 帐号系统 请求中 uin 为非开发者 uin
    70211 帐号系统 请求中 uin 非法
    70212 帐号系统 内部错误,请重试。如果多次重试仍不成功,请联系我们
    70213 帐号系统 访问内部数据失败,请重试。如果多次重试仍不成功,请联系我们
    70214 帐号系统 验证内部票据失败
    70221 帐号系统 登录状态无效,请使用 UserSig 重新鉴权
    70222 帐号系统 内部错误,请重试
    70225 帐号系统 内部错误,请重试。如果多次重试仍不成功,请联系我们
    70231 帐号系统 内部错误,请重试。如果多次重试仍不成功,请联系我们
    70236 帐号系统 验证 user signature 失败
    70308 帐号系统 内部错误,请重试。如果多次重试仍不成功,请联系我们
    70346 帐号系统 票据校验失败。
    70347 帐号系统 票据因过期原因校验失败
    70348 帐号系统 内部错误,请重试。如果多次重试仍不成功,请联系我们
    70362 帐号系统 内部超时,请重试。如果多次重试仍不成功,请联系我们
    70401 帐号系统 内部错误,请重试
    70402 帐号系统 参数非法。请检查必填字段是否填充,或者字段的填充是否满足协议要求
    70403 帐号系统 发起操作者不是 App 管理员,没有权限操作
    70050 帐号系统 因失败且重试次数过多导致被限制,请检查票据是否正确,一分钟之后再试
    70051 帐号系统 帐号已被拉入黑名单,请联系我们

    进房失败相关错误信息

    错误码 错误信息
    10006 客户服务欠费, 请登录 实时音视频控制台,单击您已创建的应用,单击应用信息,在应用信息面板即可确认服务状态
    -10011 服务端未知错误,请重试
    -10012 未传入 roomId 或者 roomId 不符合规范, 如需使用 string 类型的 roomId,请在调用 TRTC.createClient 时设置 useStringRoomId 为 true
    -10013 userSig 鉴权失败
    -10015 服务端获取服务器节点失败,请重试
    -10016 服务端创建房间失败,请检查 roomId 是否在流控允许范围内
    -10018 启用高级权限控制后,client.join 未携带 privateMapKey 参数,或者 privateMapKey 为 ' ',请参见 开启高级权限设置
    -10019 启用高级权限控制后,client.join 携带的 privateMapKey 参数不符合规范,请参见 开启高级权限设置
    -10020 服务端超时,请重试

    常见报错及处理方式

    该类型报错,需要应用程序提供干预,例如获取摄像头权限被拒绝,应用程序需要提示用户授权摄像头才能进行音视频通话。

    错误信息 错误原因 解决方案
    publish timeout publish 超时 请尝试刷新重连,再次操作 publish()
    join room timeout 进房超时 建议刷新页面重进
    DTLS Transport connection timeout (10s) DTLS Transport 连接超时 请尝试刷新重连
    failed to connect to remote server via websocket websocket 连接失败 请尝试刷新重连
    ICE/DTLS Transport connection failed 建立媒体传输通道时失败 请检查 防火墙配置
    previous publishing is ongoing, please avoid re-publishing 已经在 publishing 状态中 publish 后请避免再次 publish()
    AbortError 由于某些设备/系统未知原因导致设备无法被使用 建议通话前先进行设备检测
    NotReadableError 找不由于操作系统上某个硬件、浏览器或者网页层面发生的错误导致设备无法被访问 根据浏览器的报错信息处理,提示用户确保当前没有其他应用请求访问摄像头/麦克风,并重试
    NotFoundError 找不到满足请求参数的媒体类型,如音频、视频、屏幕分享 建议通话前先进行设备检测
    NotAllowedError 用户拒绝了当前的浏览器实例的访问音频、视频、屏幕分享请求 用户需授权摄像头/麦克风访问,才能进行音视频通话
    SignalChannel reconnect failed websocket 断开 请尝试刷新重连
    duplicate publishing, please unpublish and then re-publish 重复 publish 请先操作 unpublish(),再操作 publish()
    OverconstrainedError 浏览器获取不到 cameraId / microphoneId 请确保 cameraId / microphoneId 的值是有效的非空字符串
    RtcError: no valid ice candidate found TRTC Web SDK 在 STUN 打洞失败 请检查下 防火墙配置
    联系我们

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

    技术支持

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

    7x24 电话支持