【转载】腾讯TBS SDK 近期热点问题汇总

原文地址:https://docs.qq.com/doc/DYW9QdXJNWFZnbVdz

最新 SDK:44153

一、 近期热点问题:(2022.1.20)

1、SDK版本更新(Maven Central接入):api 'com.tencent.tbs:tbssdk:44153'

2、(问题更新)首次安装应用,一直加载不起 X5 内核?

首次安装应用时,本应用下没有内核,通常会触发异步内核下载,此时本App下没有x5内核可用,将采用系统内核,下次启动再使用下载的内核。

image.png

二、 历史常见问题:

2.1 隐私合规相关

1、TBS SDK是否有隐私合规相关说明?

请使用最新版TBS SDK 44153,官网下载包内提供了隐私合规说明文档https://x5.tencent.com/docs/privacy.html以及隐私接口调用说明文档

2.2 SDK接入及内核下载相关

1、可以通过什么渠道获取TBS最新版本SDK?

方式一:通过官网下载,手动接入 https://x5.tencent.com/tbs/sdk.html

方式二:MavenCentral接入。在根目录 build.gradle 添加 mavenCentral() 库索引,在模块中引入依赖:api 'com.tencent.tbs:tbssdk:44115'

ps:使用方式二时,请阅读隐私文档(https://x5.tencent.com/docs/privacy.html 及 官网下载包内的隐私接口使用文档

2、(更新)首次安装应用,一直加载不起 X5 内核?

首次安装应用时,本应用下没有内核,通常会触发异步内核下载,此时本App下没有x5内核可用,将采用系统内核,下次启动再使用下载的内核。

image.png

3、经常遇到因为流控而导致无法下载到内核的情况,如何优化解决?

由于庞大的用户量,对于X5下载内核会有带宽压力,后台会根据当前的流量情况去流控请求,稍后再试。建议优化:请求SD卡授权,加载稳定备份内核。

4、本地无内核可用,且TbsListener.onDownLoadFinished()返回错误码 110 ?

该情况在本地无内核时,大概率命中了流控,可通过debugtbs.qq.com手动安装线上内核。

5、是否有静态内核接入方案?

静态接入版本已不再维护与发布,请接入官方最新动态下发内核的SDK版本。

6、多次卸载重装、重启都加载不了内核,通过 debugtbs.qq.com 也下载不了,显示“不需要下载”?(已解决,遇到此问题 Q群请联系 腾讯开发-ater

A:大概率是DNS出现了问题,尝试链接 Wi-Fi,并调整手机 DNS代理至 114.114.114.114

7、周五周六(18:00-21:00)debugtbs.qq.com下载不了内核?

A:服务器维护期不支持下载。

2.3 常见内核加载问题

1、内核已经下载却加载不起来?debugtbs.qq.com能看到内核信息,但打不开debugx5.qq.com?

A:自查一下是否调用了QbSdk.forceSysWebView()

2.4 x5调试相关

1、如何查看TBS相关信息?如何进行TBS调试?

使用设置了 WebViewClient 的TBS SDK的 webview 打开 https://debugtbs.qq.com,会出现 TBS调试工具页面。

2、下载不到内核时,如何获取并加载内核?

使用debugtbs.qq.com工具,点击安装线上内核。若提示115,在周五周六晚属于正常运维,或者此时环境为x86模拟器等x5内核不支持的环境,请使用真机再次尝试。

2.5 其他能力相关

1、已经实现了CustomView相关方法,但使用TBS SDK的webview时,h5视频全屏按钮不生效?

该问题为系统内核下的已知问题,并于44085版本SDK中修复。

2、使用文件能力的插件依赖于x5内核,但内核有加载失败的情况怎么办?

参考 2.4、2.5,建议通过:

(1)首次打开应用尽量在wifi下

(2) 调用QbSdk.setDownloadWithoutWifi允许4G下载

(3)获取sdcard存储权限使用备份稳定内核

等手段提高x5占比来规避系统内核情况。

3、“插件加载失败” ?

a. app内进入http://debugx5.qq.com,点击第二个“信息”,拉到下面点击“清理本地插件”

b. 手机设置-应用管理-强制停止或结束运行 本app

三、 X5内核常用功能使用文档

【腾讯文档】X5内核常用功能使用说明

https://docs.qq.com/doc/DSndPaG5SSkdDUmxZ

你可能感兴趣的:(【转载】腾讯TBS SDK 近期热点问题汇总)