含 UI 集成方案

有奖征文|投稿上云技术实践,赢取价值5000元大奖> HOT
注意
本文适用于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
自动播放被禁止错误
说明:调用 play() 播放音视频时,由于自动播放策略 的限制导致无法自动播放
处理建议:此时应该引导用户通过手势操作调用 resume() 继续进行播放,请参见 自动播放受限处理建议
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
帐号系统
内部第三方票据验证超时,请重试,如果多次重试仍不成功,请联系 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

进房失败相关错误信息

错误码
错误信息
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
服务端超时,请重试
-100027
检查 TRTC 状态是否正常,需在腾讯云实时音视频控制台,开启 TRTC 服务后再加入房间

常见报错及处理方式

该类型报错,需要应用程序提供干预,例如获取摄像头权限被拒绝,应用程序需要提示用户授权摄像头才能进行音视频通话。
错误信息
错误原因
解决方案
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 打洞失败
请检查下 防火墙配置

目录