关于接入腾讯X5内核的一些坑（不断更新）

2017-04-09 本文已影响5213人 kongzue

前言

根据之前开发的案例来看，原生WebView确实存在着很多的不完善以及一些令人头疼的问题，在WebView一大堆坑的面前腾讯X5内核不失为一种相当好的解决问题，但是X5真的如此完美了么？非也，那么关于X5接入会遇到那些坑，又是如何一一解决呢，本文将带给你一些答案。

事先声明，本文基于2017年4月9日能够获取的腾讯X5内核的最新版本（可到 https://pan.baidu.com/s/1skSVkWd 下载）：
Android SDK（完整版）
大小：294KB
版本：v3.1.0.1034
更新日期：2017-03-01
提供解决方案。

问题1，选择图片问题

首先，对于WebView选择图片的问题请参考上一篇《Android WebView选择图片的问题》http://www.jianshu.com/p/d31936511359 在此不再过多表述。

问题2，视频横屏全屏的问题

接入X5内核后一个很重要的就是网页视频的播放问题了，按照腾讯官方的X5内核接入是没有问题的，视频也能播放，但想要全屏播放是不行的，在这块就存在腾讯留下的一些坑了，你可能在腾讯X5官网的疑难解答中会看到这样的接入方法：

视频全屏播放形态、初始播放形态、小窗播放该如何设置？
看如下示例代码：
Bundle data = new Bundle();
data.putBoolean("standardFullScreen", false);
//true表示标准全屏，false表示X5全屏；不设置默认false，
data.putBoolean("supportLiteWnd", false);
//false：关闭小窗；true：开启小窗；不设置默认true，
data.putInt("DefaultVideoScreen", 2);
//1：以页面内开始播放，2：以全屏开始播放；不设置默认：1
mWebView.getX5WebViewExtension().invokeMiscMethod("setVideoParams", data);

1) standardFullScreen 全屏设置
设置为true时，我们会回调WebChromeClient的onShowCustomView方法，由开发者自己实现全屏展示；
设置为false时，由我们实现全屏展示，我们实现全屏展示需要满足下面两个条件：
a. 我们 Webview初始化的Context必须是Activity类型的Context
b. 我们 Webview 所在的Activity要声明这个属性
android:configChanges="orientation|screenSize|keyboardHidden"
如果不满足这两个条件，standardFullScreen 自动置为 true

2) supportLiteWnd 小窗播放设置
前提standardFullScreen=false，这个条件才生效
设置为 true， 开启小窗功能
设置为 false，不使用小窗功能

3) DefaultVideoScreen 初始播放形态设置
a、以页面内形态开始播放
b、以全屏形态开始播放

原文链接：http://x5.tencent.com/tbs/technical.html#/detail/sdk/1/a1f54118-e2b7-43df-8189-8824e4ce5970

按照其文中的设置，你会发现一个相当大的坑，WebView界面出现崩溃，崩溃原因是空指针异常，文中提到的方法“mWebView.getX5WebViewExtension().invokeMiscMethod”为空（null），这是怎么回事呢？
进过一番调查，我们发现在X5内核的WebView的加载方法时出现了意外，但此错误并没有使软件崩溃，直到我们进入WebView所在的界面，调用invokeMiscMethod方法时才出现了崩溃，即X5内核的WebView初始化失败。问题出在哪里呢？我们完全是按照官方接入文档来进行接入的呀。

在X5的官方论坛发现一篇类似问题，也发现了类似的问题出现：http://bbs.mb.qq.com/thread-1450686-1-1.html

但同时，在X5内核官网的一片疑难解答引起了我的注意：《64位手机无法加载x5》
是否是因为64位的CPU不兼容导致加载失败呢？尝试按照文中提供的解决方法对工程进行设置（下文提到的so包可到 https://pan.baidu.com/s/1boYNzAZ 下载）：

x5内核暂时不提供64位的so文件,在64位手机上需要让AP以32位模式运行。具体操作如下（文中的so包可到 https://pan.baidu.com/s/1nvx54UX 下载）：
1.如果使用是Eclipse则需要将所有的.so文件都放置在so加载目录：lib/armeabi文件夹下(没有该目录则新建一个，AP中没有使用到.so文件则需要拷贝任意一个32位的so文件到该目录下,如果没有合适的so可以到官网http://x5.tencent.com/tbs/sdk.html下载官网“SDK接入示例“,拷贝对应目录下的liblbs.so文件)，lib文件夹下不要有其他以”armeabi“开头的文件夹。
2.如果使用的是 Android studio则需要进行两项配置，
(1)打开对应module中的build.gradle文件,在文件的android{}中的defaultConfig{}里(如果没有defaultConfig{}则手动添加)添加如下配置: ndk{abiFilters "armeabi", "armeabi-v7a", "x86", "mips"}，如果配置后编译报错，那么需要在gradle.properties文件中加上Android.useDeprecatedNdk=true；
(2)找出build.gradle中配置的so加载目录:jniLibs.srcDir:customerDir,如果没有该项配置则so加载目录默认为：src/main/jniLibs，需要将.so文件都放置在so加载目录的armeabi文件夹下(没有该目录则新建一个，AP中没有使用到.so文件则需要拷贝任意一个32位的so文件到该目录下，如果没有合适的so可以到官网http://x5.tencent.com/tbs/sdk.html下载官网“SDK接入示例“,拷贝对应目录下的liblbs.so文件)，so加载目录下不要有其他以”armeabi“开头的文件夹。

原文链接：http://x5.tencent.com/tbs/technical.html#/detail/sdk/1/34cf1488-7dc2-41ca-a77f-0014112bcab7
按照文中的方案进行修改，完成配置后编译运行，网页中的视频终于可以正常全屏横屏了，大功告成。

关于接入腾讯X5内核的一些坑（不断更新）

前言

问题1，选择图片问题

问题2，视频横屏全屏的问题

更多问题

猜你喜欢

热点阅读