前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >腾讯会议SaaS SDK登录报错问题排查方法

腾讯会议SaaS SDK登录报错问题排查方法

原创
作者头像
liquid
修改2023-11-16 21:37:23
1.3K0
修改2023-11-16 21:37:23
举报
文章被收录于专栏:腾讯会议

在排查登录问题前需要先确保防火墙已经配置,并且用户已经创建成功,防火墙配置规则列表:防火墙配置腾讯会议域名和IP指引 - 腾讯会议帮助中心

腾讯会议登录报错常见的错误码如下:

名称

错误码

说明

回调函数

kTMSDKErrorInvalidAuthCode

-1002

无效AuthCode,登录参数不正确或IDaaS登录跳转存在问题

onLogin()

kTMSDKErrorUnknown

-1005

登录场景、投屏码投屏、屏幕共享状态获取等异常抛出未知错误,出现该错误码,请与官方联系

onLogin()、onActionResult()

kTMSDKErrorAccountAlreadyLogin

-1012

账号已登录,重复登录调用

onLogin()

kTMSDKErrorIsLogining

-1017

正在登录过程中的重复登录调用

onLogin()

kTMSDKErrorLoginNetError

-1018

登录过程出现网络错误

onLogin()

kTMSDKErrorTokenVerifyFailed

-1019

sdktoken校验失败,可能是登录时sdktoken过期或使用时sdktoken失效,需要refreshSDKToken后再登录

onResetSDKState()、onLogin()

kTMSDKErrorMultiAccountLoginConflict

-1021

A账户已登录,此时未调用logout()就登录B账户导致,如需切换账户,请先调用logout()

onLogin()

上面和网络相关的错误码一般是-1002、-1005和-1018,非网络相关的有-1002、-1012、-1017、-1019和-1021

网络问题排查步骤(-1002、-1005、-1018):

1、 报错回调的信息里面一般都会有URL和IP信息,需要在机器上的系统浏览器打开URL,并ping里面的IP,确认网络是否可达,如果不可达,需要客户网络同事确认请求出公网的路径存在的连通问题。都可达则进入下一步继续排查。

2、 使用telnet命令确认下面表中的URL及端口是否网络可达,示例如下:

URL

端口

描述

conn.wemeet.tencent.com

TCP: 443

信令接入

XXXX.sso.meeting.qq.com

TCP: 80, 443

sso登录 (根据企业SSO域名实际填写)

XXXX.id.meeting.qq.com

TCP: 80, 443

sso登录 (根据企业SSO域名实际填写)

work.medialab.qq.com

TCP: 80, 443

接入类

quic.conn.wemeet.qq.com

UDP+TCP: 80, 443, 8080

信令接入

cdn.meeting.tencent.com

TCP: 80, 443

资源类

oth.eve.mdt.qq.com

TCP: 8081

代理

ten.sngapm.qq.com

TCP: 80, 443

安全

report.meeting.tencent.com

TCP: 80, 443

数据类

updatecdn.meeting.qq.com

TCP: 80, 443

下载更新

如果不可达,需要客户网络同事确认请求出公网的路径存在的联通问题。都可达则进入下一步继续排查。

3、 确认用户设备是否存在翻墙软件/代理软件,存在的话登录失败时间点附近是否存在开关代理/切换代理等行为,如果有的话需要退出SDK软件,待代理软件运行正常或者完全退出后(可以重启电脑尝试),再运行SDK,看是否恢复正常。

4、 如果以上方式都排查过,仍然无法确定原因,需要收集日志提交工单,寻求腾讯会议后台技术支持。由于部分网络问题出现后能自行恢复,这种情况对后台反馈日志定位结果的时效性要求比较高,需要在提单时备注说明清楚;在后台反馈报错原因后,需要将结果反馈给客户网络同事进行排查。常见情况的排查方式如下:

1)IP或者URL不通 - 定位设备到IP或者URL请求的记录,确认不可达的原因

2)IPV4/IPV6网络完全不通 - 是否存在对应用或者服务的网络访问限制

3)HTTPS证书被替换 - 根据后台提供的域名,确认证书被替换的原因,如果找不到,需要安全系统供应商介入排查

非网络问题排查方法

1、 -1002错误码

回调的报错内容里面有如下图的Token is expired字样,原因是ID Token过期了,需要使用在有效期内的ID Token进行登录

2、 -1012错误码

原因是当前SDK已经登录了,重复调用登录会报错,需要在登录代码里面增加判断SDK是否已登录的逻辑

3、 -1017错误码

原因是正在登录过程中的重复登录调用,在收到登录结果回调之前不要重复调用登录结果

4、 -1019错误码

原因是SDK Token已过期,需要向APP后台申请新的SDK Token,然后调用SDK的refreshSDKToken接口刷新,再调用登录接口重新登录

5、 -1021错误码

原因是切换SDK账号是没有先调用logout退出上一个账号,在切换账号时需要先调用logout接口,然后调用login接口登录新的账号

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 腾讯会议登录报错常见的错误码如下:
  • 网络问题排查步骤(-1002、-1005、-1018):
  • 非网络问题排查方法
相关产品与服务
腾讯会议
腾讯会议(Tencent Meeting)为企业打造专属的会议能力,卓越的音视频性能,丰富的会议协作能力,坚实的会议安全保障,提升协作效率,满足大中小会议全场景需求。您可以使用腾讯会议进行远程音视频会议、在线协作、会管会控、会议录制、指定邀请、布局管理、同声传译等。
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档