ErrorCode

错误码定义

Members

(static) INVALID_PARAMETER

Default Value:
  • 0x1000

无效参数

(static) INVALID_OPERATION

Default Value:
  • 0x1001

非法操作

(static) NOT_SUPPORTED

Default Value:
  • 0x1002

不支持
说明：调用 SDK 接口时抛出，表明当前浏览器不支持调用对应接口
处理建议：引导用户使用 SDK 支持的浏览器，参考：检测浏览器支持性

(static) DEVICE_NOT_FOUND

Default Value:
  • 0x1003

未找到对应设备 处理建议：进房前需检查是否有对应设备及设备授权情况。

(static) SIGNAL_CHANNEL_SETUP_FAILED

Default Value:
  • 0x4001

WebSocket 信令通道建立失败

帐号相关错误信息：

错误码 错误类型 描述
70001 帐号系统 userSig 过期，请尝试重新生成。如果是刚生成就过期，请检查有效期填写的是否过小或者误填为 0
70002 帐号系统 userSig 长度为 0，请确认签名计算是否正确，访问 sign_src 获取计算签名的傻瓜式源码，核对参数，确保签名计算正确性
70003 帐号系统 userSig 校验失败，请确认下 userSig 内容是否被截断，例如缓冲区长度不够导致的内容截断
70004 帐号系统 userSig 校验失败，请确认下 uerSig 内容是否被截断，例如缓冲区长度不够导致的内容截断
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 帐号系统 内部第三方票据验证超时，请重试，如果多次重试仍不成功，请联系 TLS 帐号支持，QQ：3268519604
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 帐号系统 内部错误，请重试。如果多次重试仍不成功，请联系 TLS 帐号支持，QQ：3268519604
70201 帐号系统 内部错误，请重试。如果多次重试仍不成功，请联系 TLS 帐号支持，QQ：3268519604
70202 帐号系统 内部错误，请重试。如果多次重试仍不成功，请联系 TLS 帐号支持，QQ：3268519604
70203 帐号系统 内部错误，请重试。如果多次重试仍不成功，请联系 TLS 帐号支持，QQ：3268519604
70204 帐号系统 sdkAppId 没有对应的 acctype
70205 帐号系统 查找 acctype 失败，请重试
70206 帐号系统 请求中批量数量不合法
70207 帐号系统 内部错误，请重试
70208 帐号系统 内部错误，请重试
70209 帐号系统 获取开发者 uin 标志失败
70210 帐号系统 请求中 uin 为非开发者 uin
70211 帐号系统 请求中 uin 非法
70212 帐号系统 内部错误，请重试。如果多次重试仍不成功，请联系 TLS 帐号支持，QQ：3268519604
70213 帐号系统 访问内部数据失败，请重试。如果多次重试仍不成功，请联系 TLS 帐号支持，QQ：3268519604
70214 帐号系统 验证内部票据失败
70221 帐号系统 登录状态无效，请使用 UserSig 重新鉴权
70222 帐号系统 内部错误，请重试
70225 帐号系统 内部错误，请重试。如果多次重试仍不成功，请联系 TLS 帐号支持，QQ：3268519604
70231 帐号系统 内部错误，请重试。如果多次重试仍不成功，请联系 TLS 帐号支持，QQ：3268519604
70236 帐号系统 验证 user signature 失败
70308 帐号系统 内部错误，请重试。如果多次重试仍不成功，请联系 TLS 帐号支持，QQ：3268519604
70346 帐号系统 票据校验失败。
70347 帐号系统 票据因过期原因校验失败
70348 帐号系统 内部错误，请重试。如果多次重试仍不成功，请联系 TLS 帐号支持，QQ：3268519604
70362 帐号系统 内部超时，请重试。如果多次重试仍不成功，请联系 TLS 帐号支持，QQ：3268519604
70401 帐号系统 内部错误，请重试
70402 帐号系统 参数非法。请检查必填字段是否填充，或者字段的填充是否满足协议要求
70403 帐号系统 发起操作者不是 App 管理员，没有权限操作
70050 帐号系统 因失败且重试次数过多导致被限制，请检查票据是否正确，一分钟之后再试
70051 帐号系统 帐号已被拉入黑名单，请联系 TLS 帐号支持，QQ：3268519604

(static) SIGNAL_CHANNEL_ERROR

Default Value:
  • 0x4002

WebSocket 信令通道错误

Note

  • 自 v4.6.5 版本开始，SDK 不会再抛出该错误

(static) ICE_TRANSPORT_ERROR

Default Value:
  • 0x4003

ICE Transport 连接错误，即音视频数据传输通道错误。
这主要是因为用户端的 UDP 端口异常（可能是用户电脑防火墙或路由器防火墙端口限制）引起，具体端口参考端口白名单。

Note

  • 自 v4.6.6 版本开始，SDK 不会再抛出该错误
  • 若需要感知用户网络异常，可以使用 NETWORK_QUALITY 事件

(static) JOIN_ROOM_FAILED

Default Value:
  • 0x4004

进房失败

错误码 错误信息
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 服务端超时，请重试

(static) CREATE_OFFER_FAILED

Default Value:
  • 0x4005

创建 sdp offer 失败

(static) SIGNAL_CHANNEL_RECONNECTION_FAILED

Default Value:
  • 0x4006

WebSocket 信令通道重连失败
描述：当 WebSocket 断开时，SDK 会尝试多次重连，如果都失败了，则会抛出此错误。
处理建议：提醒用户检查网络，然后重新进房。

Default Value:
  • 0x4007

上行 PeerConnection 重连失败
描述：当上行 PeerConnection 断开时，SDK 会尝试多次重连，如果都失败了，则会抛出此错误。
处理建议：提醒用户检查网络，然后重新推流或者重新进房。

Default Value:
  • 0x4008

下行 PeerConnection 重连失败
描述：当下行 PeerConnection 异常断开时，SDK 会尝试多次重连，如果都失败了，则会抛出此错误。
处理建议：提醒用户检查网络，然后重新进房。

(static) CLIENT_BANNED

Default Value:
  • 0x4040

用户被踢出房间

(static) SERVER_TIMEOUT

Default Value:
  • 0x4041

媒体传输服务超时

(static) SUBSCRIPTION_TIMEOUT

Default Value:
  • 0x4042

远端流订阅超时

(static) PLAY_NOT_ALLOWED

Default Value:
  • 0x4043

自动播放被禁止错误
说明：调用 play() 播放音视频时，由于自动播放策略的限制导致无法自动播放。
处理建议：此时应该引导用户通过手势操作调用 resume() 继续进行播放。参考：自动播放受限处理建议

(static) DEVICE_AUTO_RECOVER_FAILED

Default Value:
  • 0x4044

自动恢复摄像头、麦克风采集失败

Note

  • 该错误在 LocalStream 的 error 事件抛出
  • 当用户的正在推流的媒体设备变更（例如：插拔摄像头、麦克风、接口松动等）时，SDK 会尝试恢复采集。发生此错误说明恢复失败。
  • 处理建议：提醒用户 媒体设备自动恢复采集失败，请检查摄像头、麦克风接口是否松动，并确保没有被其他应用占用。
  • 可在页面提供重试按钮，当用户点击重试时，重新采集摄像头、麦克风，可参考下方代码示例：
Example
// 重试流程
localStream.on('error', async error => {
  if (error.getCode() === 0x4044) {
    const newStream = TRTC.createStream({ userId: 'your userId', audio: true, video: true });
    try {
      await newStream.initialize();

      // 获取摄像头和麦克风 track
      const videoTrack = newStream.getVideoTrack();
      const audioTrack = newStream.getAudioTrack();

      // 分别替换摄像头和麦克风 track
      localStream.replaceTrack(videoTrack);
      localStream.replaceTrack(audioTrack);
    } catch (err) {
      // 采集失败，可让用户检查摄像头、麦克风后重试该流程，initialize error 可参考：https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/LocalStream.html#initialize
    }
  }
});

(static) START_PUBLISH_CDN_FAILED

Default Value:
  • 0x4045

开始向 CDN 推流失败

(static) STOP_PUBLISH_CDN_FAILED

Default Value:
  • 0x4046

停止向 CDN 推流失败

(static) START_MIX_TRANSCODE_FAILED

Default Value:
  • 0x4047

开始混流转码失败

(static) STOP_MIX_TRANSCODE_FAILED

Default Value:
  • 0x4048

停止混流转码失败

(static) NOT_SUPPORTED_H264

Default Value:
  • 0x4049

当前设备不支持H.264

(static) SWITCH_ROLE_FAILED

Default Value:
  • 0x404a

切换角色失败

(static) UNKNOWN

Default Value:
  • 0xFFFF

未知错误