美文网首页X5WebViewwebView专题内容第三方扩展
关于接入腾讯X5内核的一些坑(不断更新)

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

作者: kongzue | 来源:发表于2017-04-09 17:38 被阅读5213次

    前言

    根据之前开发的案例来看,原生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内核中更多的坑以及解决方案,让我们共同进步,创作更好用的程序。

    相关文章

      网友评论

      • 雪穗_:第一次打开视频的时候会默认横屏显示,请问要怎么设置默认竖屏呢?
      • 墨鬁:启动App 的时候加载X5 初始化, webView 会白屏如何解决? 有解决经验吗?
        kongzue:@墨鬁 那应该就不会白屏了啊
        墨鬁:@kongzue 大神, 我在 Application 里面就初始化了 , 似乎不能更提前了吧 ...... 启动一个 service 来在后台初始化?
        kongzue:@墨鬁 提前初始化,我记得官方文档里有
      • AMrx:我在pad里面加载pc版的网页,pc版的网页右上角会有个全屏按钮,点击全屏按钮,整个屏幕都会白屏,我一开始以为是他们网页的问题,后来 用原生的webview加载网页就不会出现这样的问题。博主知道怎么处理吗?
      • abccd1e95976:使用x5感觉比原生的webview加载网页更慢了,官方demo加载感觉也慢,提速30%怎么设置的
      • 糖三奘:请问如何接入播放音频的功能,目前用的是腾讯X5内核的loadUrl(url);这种方式,以网页的形式来播放,点进去需要等n秒才出加载完毕,开始播音。有没更好的办法能
      • f7054bd1668e:最近发现X5在vivoX20手机上无法播放视频,其他品牌甚至VIVO的其他机型没有发现这个BUG,有谁知道怎么办
      • 东东wyd:请问你有遇到,用X5内核加载H5网页视频,网页中的视频会一下缓冲到最后一秒,必须要手势去拖进度条,才能正常播放?
      • 爱吃板栗的小女孩:你好,集成后,左上角有粉色的浮动字,当前包名,机型等,这个怎么去掉?谢谢
        nubio:在Utile的X5Webview中drawChild那里
      • HapiAnt:x5支持https和http的混用么?配置是普通webview一只么?
      • 87fe414e0f58:X5内核初始化需要放进线程吗?我见官方Demo在主线程,我第一次打开APP会黑屏一会,纯WebView的APP
        kongzue:@梦醒_1b43 不需要,官方建议在application中进行初始化,进行了就不会黑了
      • 5a7a80406c4b:X5 和webview刷新有冲突怎么解决i
        kongzue:@PleaseDontCry 什么冲突
      • 373a5055aef2:如何隐藏视频分享功能呢?
      • 荆著:那个64位改32位的,libs文件下有其他以”armeabi“开头的文件夹怎么整?
        kongzue:@代码界的泥石流 看清楚腾讯官方文档怎么说的再说我是不是答非所问
        代码界的泥石流:@kongzue 答非所谓 兄弟
        kongzue:参考下这个:https://x5.tencent.com/tbs/technical.html#/detail/sdk/1/34cf1488-7dc2-41ca-a77f-0014112bcab7
      • 帅小然:x5设置手势放大缩小好像无效🙁
        kongzue:是的,但实际上我们在实际生产中更多的使用场景是为了展示移动版的H5页面而不是去展示PC比例的页面

      本文标题:关于接入腾讯X5内核的一些坑(不断更新)

      本文链接:https://www.haomeiwen.com/subject/upgdattx.html