Android在项目中接入腾讯TBS浏览器WebView的教程与注意的地方(1)

2401_84123357

于 2024-04-29 20:57:44 发布

阅读量129

点赞数 3

分类专栏：程序员文章标签： android harmonyos 华为

本文链接：https://blog.csdn.net/2401_84123357/article/details/138325318

版权

程序员专栏收录该内容

470 篇文章 0 订阅

订阅专栏

视频和文件格式的支持x5内核多于系统内核
防劫持是x5内核的一大亮点

2. 运行环境

手机ROM版本高于或等于2.2版本
手机RAM大于500M，该RAM值通过手机 /proc/meminfo 文件的MemTotal动态获取

注：如果不满足上述条件，SDK会自动切换到系统WebView，SDK使用者不用关心该切换过程。

3. SDK尺寸指标

SDK提供的JAR包约293K

4. 原生和X5 WebView的类对应表

| 系统内核 | SDK内核 |

| — | — |

| android.webkit.ConsoleMessage | com.tencent.smtt.export.external.interfaces.ConsoleMessage |

| android.webkit.CacheManager | com.tencent.smtt.sdk.CacheManager(deprecated) |

| android.webkit.CookieManager | com.tencent.smtt.sdk.CookieManager |

| android.webkit.CookieSyncManager | com.tencent.smtt.sdk.CookieSyncManager |

| android.webkit.CustomViewCallback | com.tencent.smtt.export.external.interfaces.IX5WebChromeClient.CustomViewCallback |

| android.webkit.DownloadListener | com.tencent.smtt.sdk.DownloadListener |

| android.webkit.GeolocationPermissions | com.tencent.smtt.export.external.interfaces.GeolocationPermissionsCallback |

| android.webkit.HttpAuthHandler | com.tencent.smtt.export.external.interfaces.HttpAuthHandler |

| android.webkit.JsPromptResult | com.tencent.smtt.export.external.interfaces.JsPromptResult |

| android.webkit.JsResult | com.tencent.smtt.export.external.interfaces.JsResult |

| android.webkit.SslErrorHandler | com.tencent.smtt.export.external.interfaces.SslErrorHandler |

| android.webkit.ValueCallback | com.tencent.smtt.sdk.ValueCallback |

| android.webkit.WebBackForwardList | com.tencent.smtt.sdk.WebBackForwardList |

| android.webkit.WebChromeClient | com.tencent.smtt.sdk.WebChromeClient |

| android.webkit.WebHistoryItem | com.tencent.smtt.sdk.WebHistoryItem |

| android.webkit.WebIconDatabase | com.tencent.smtt.sdk.WebIconDatabase |

| android.webkit.WebResourceResponse | com.tencent.smtt.export.external.interfaces.WebResourceResponse |

| android.webkit.WebSettings | com.tencent.smtt.sdk.WebSettings |

| android.webkit.WebSettings.LayoutAlgorithm | com.tencent.smtt.sdk.WebSettings.LayoutAlgorithm |

| android.webkit.WebStorage | com.tencent.smtt.sdk.WebStorage |

| android.webkit.WebView | com.tencent.smtt.sdk.WebView |

| android.webkit.WebViewClient | com.tencent.smtt.sdk.WebViewClient |

在APP中集成

1. 导Jar包

去这个网址： http://x5.tencent.com/tbs/sdk.html ，看到Android SDK（完整版） 这个就是Jar包，下载回来放到你项目的lib文件夹，右键add as library即可。

2. 权限

在Manifest添加下面的权限

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.READ_PHONE_STATE" />

3. 初始化X5内核

在Application里面使用QbSdk.initX5Environment进行初始化X5内核,第一个参数传入context，第二个参数传入PreInitCallback，不需要callback的可以传入null。

initX5Environment内部会创建一个线程向后台查询当前可用内核版本号，这个函数内是异步执行所以不会阻塞 App 主线程，这个函数内是轻量级执行所以对App启动性能没有影响，当App后续创建webview 时就可以首次加载x5内核了:

public class BaseApplicatiom extends Application { @Override public void onCreate() { super.onCreate(); //初始化X5内核 QbSdk.initX5Environment(this, new QbSdk.PreInitCallback() { @Override public void onCoreInitFinished() { //x5内核初始化完成回调接口，此接口回调并表示已经加载起来了x5，有可能特殊情况下x5内核加载失败，切换到系统内核。 } @Override public void onViewInitFinished(boolean b) { //x5內核初始化完成的回调，为true表示x5内核加载成功，否则表示x5内核加载失败，会自动切换到系统内核。 Log.e("@@","加载内核是否成功:"+b); } }); } }

4. 使用WebView

然后需要用到WebView的时候，在布局这样子下面这样子写，注意要全路径com.tencent.smtt.sdk.WebView:

<com.tencent.smtt.sdk.WebView android:id="@+id/twv_test" android:layout_width="match_parent" android:layout_height="match_parent"/>

其余使用方法基本和系统的WebView一样，例如js的交互是，也是一样的addJavascriptInterface，所以使用成本还不算高。但是有些是需要注意的，继续看下去:

高级一点的使用

1. 全屏播放视频

页面的Activity需要声明:

android:configChanges="orientation|screenSize|keyboardHidden"

视频为了避免闪屏和透明问题，Activity在onCreate时需要设置:

//这个对宿主没什么影响，建议声明 getWindow().setFormat(PixelFormat.TRANSLUCENT);

在非硬绘手机和声明需要controller的网页上，视频切换全屏和全屏切换回页面内会出现视频窗口透明问题，需要在activity的style进行如下设置:

 <item name="android:windowIsTranslucent">false</item>。

以下接口禁止(直接或反射)调用，避免视频画面无法显示：

webview.setLayerType() webview.setDrawingCacheEnabled(true);

2. 输入法

避免输入法界面弹出后遮挡输入光标的问题，所在的Activity添加属性：

android:windowSoftInputMode="stateHidden|adjustResize"

或者在ActivityonCreate时候代码设置也行：

getWindow().setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE | WindowManager.LayoutParams.SOFT_INPUT_STATE_HIDDEN);

3. 自定义UA

UA是什么？

userAgent,用户代理。是一个特殊字符串头，使得服务器能够识别客户使用的操作系统及版本、CPU 类型、浏览器及版本、浏览器渲染引擎、浏览器语言、浏览器插件等。作用就是告诉网页我这个是什么系统。

如果 app 需要自定义 UA，建议采取在 SDK 默认UA 后追加 app UA 的方式。示例：

//其中APP_NAME_UA是app自定义UA webSetting.setUserAgentString(webSetting.getUserAgentString() + APP_NAME_UA);

4. 额外的视频播放器

没错，这货还提供了一个视频播放的功能，下面官方的说明:

TBS不仅提供了强大的网页浏览功能，更提供了强大的页面H5视频播放支持，播放器同时支持页面，小窗，全屏播放体验，强大的解码能力，包括mp4，rmvb，flv，avi等26种视频格式支持。

TBS播放器的播放场景不仅局限于H5页面播放，也可以接入一般的视频流链接，比如本地文件，网络的视频流链接。开发者如果想播放一个视频链接，在不自己开发播放器的前提下，一般做法是将视频的播放链接放到一个Intent里面，抛给系统的播放器进行播放，那么当你集成了TBS后，你只需要通过简单的方式接入视频播放调用接口，这样你不需要写任何一句关于播放器的代码，就可以享受一个本地播放器体验，播放视频再不需要Intent来跨App、跨进程的调用了。

第一步，在Manifest添加Activity声明：

<activity android:name="com.tencent.smtt.sdk.VideoActivity" android:configChanges="orientation|screenSize|keyboardHidden" android:exported="false" android:launchMode="singleTask" android:alwaysRetainTaskState="true"> <intent-filter> <action android:name="com.tencent.smtt.tbs.video.PLAY" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>

第二步，调用播放视频的调用接口，通过TbsVideo的静态方法，如下：

//判断当前Tbs播放器是否已经可以使用。 public static boolean canUseTbsPlayer(Context context) //直接调用播放接口，传入视频流的url public static void openVideo(Context context, String videoUrl) //extraData对象是根据定制需要传入约定的信息，没有需要可以传如null public static void openVideo(Context context, String videoUrl, Bundle extraData)

5. 文件选择器

官方demo中有。简单说一下流程

在WebChromeClient里面有回调openFileChooser、onShowFileChooser方法。

点击了网页的控件就可以回调上面的方法

在回调方法里面我们利用Intent打开文件选择器

然后选择完文件后在onActivityResult回调里面进行获取，然后利用ValueCallback<Uri>或者ValueCallback<Uri[]>的onReceiveValue进行返回路径给网页。

注意的地方

1. cookie的调整

com.tencent.smtt.sdk.CookieManager和com.tencent.smtt.sdk.CookieSyncManager的相关接口的调用，在接入SDK后，需要放到创建X5的WebView之后（也就是X5内核加载完成）进行；否则，cookie的相关操作只能影响系统内核。