最近在做项目时遇到一个需求:需要像支付宝一样,在h5中判断是否已经安装某个app并自动打开它。那么这个功能应该如何实现呢?一起来看一看
说明:
正如大家所知道的一样,H5页面时需要搭载在web浏览器中才能运行的。但并不是所有的浏览器都能做到这个功能,因为浏览器种类太多,很多浏览器的内核都被各开发修改过。所以最保险的还是使用手机自带的浏览器来打开H5页面
原理解析
前端H5检测是否安装应用,来进行不同的判断(下载或直接跳转到app中),其原理很简单:创建一个iframe去打开uri。如果打开app成功网页进入后台,再切换回来时间会超过2.5s。利用时间去检测。下面来看具体实现过程:
过程中可能遇到的问题
什么是uri,获取uri需要哪些帮助?
安卓系统中应用切换到后台, 计时器仍会不断运行,有什么解决方法?
微信中不支持第三方uri,下载应用。怎么解决来完成跳转到自身app?
下面就来一起看一下吧。
uri的获取
这里的uri,指得就是通过 Url scheme 来实现的H5与安卓、苹果应用之间的跳转链接。
我们需要找客户端(app开发)的同事,来获取如下格式的链接。
xx://'跳转页面'/'携带参数'
这里给大家简单解释下url scheme。
url 就是我们平常理解的链接。
scheme 是指url链接中的最初位置,就是上边链接中 ‘xx’的位置。
更多详细的介绍可以看这里:url scheme使用详解
使用这个链接我们可以跳转到 应用中的某个页面,并可以携带一定的参数。这个是我们实现H5浏览器如何检查手机中是否安装某个APP并打开这个功能的前提哦。
具体实现
第一步:通过iframe打开App
用于Android平台各个app厂商间的差异很大,比如Chrome从25及以后就不再支持通过js触发(非用户点击),所以这里使用iframe src地址等来触发scheme。
// 在iframe 中打开APP
var ifr = document.createElement('iframe');
ifr.src = openUrl;
ifr.style.display = 'none';
第二步: 判断是否安装某应用
实现原理:若通过url scheme 打开app成功,那么当前h5会进入后台,通过计时器会有明显延迟。利用时间来判断这个条件来判定是否安装了指定的app
//检查app是否打开
function checkOpen(cb){
var _clickTime = +(new Date());
function check(elsTime) {
if ( elsTime > 3000 || document.hidden || document.webkitHidden) {
cb(1);
} else {
cb(0);
}
}
//启动间隔20ms运行的定时器,并检测累计消耗时间是否超过3000ms,超过则结束
var _count = 0, intHandle;
intHandle = setInterval(function(){
_count++;
var elsTime = +(new Date()) - _clickTime;
if (_count>=100 || elsTime > 3000 ) {
clearInterval(intHandle);
check(elsTime);
}
}, 20);
}
TiPS:
由于安卓手机页面进入后台后,定时器setTimeout仍会不断运行,所以这里使用setInterval,较小间隔时间重复多次。来根据累计时间判断。
cb为回调函数,根据返回0 or 1来判断是否安装。
document.hidden对大于4.4webview支持很好,为页面可见性api。
第三步:微信中实现打开or下载应用效果
这里使用微链接来实现的
if (callback) {
//客户端检测微信直接跳应用宝链接
var browser = BrowserInfo();
//使用微链接
var encodeUri = encodeURIComponent('你的uri');
if (browser.isWeixin) {
window.location.href = '你的微链url&android_schema='+encodeUri;
}else{
checkOpen(function(opened){
callback && callback(opened);
});
}
}
注意点:
微链接是应用宝提供的,可以在后台获取。
使用微链接必须做encodeURIComponent转义。
链接地址在微链接后拼接一个android_schema参数加你的uri。
完整代码
export const openApp = function(openUrl, callback) {
//检查app是否打开
function checkOpen(cb){
var _clickTime = +(new Date());
function check(elsTime) {
if ( elsTime > 3000 || document.hidden || document.webkitHidden) {
cb(1);
} else {
cb(0);
}
}
//启动间隔20ms运行的定时器,并检测累计消耗时间是否超过3000ms,超过则结束
var _count = 0, intHandle;
intHandle = setInterval(function(){
_count++;
var elsTime = +(new Date()) - _clickTime;
if (_count>=100 || elsTime > 3000 ) {
clearInterval(intHandle);
check(elsTime);
}
}, 20);
}
//在iframe 中打开APP
var ifr = document.createElement('iframe');
ifr.src = openUrl;
ifr.style.display = 'none';
if (callback) {
//客户端检测微信直接跳应用宝链接
var browser = BrowserInfo();
//使用微链接
var encodeUri = encodeURIComponent(openUrl);
if (browser.isWeixin) {
window.location.href = '你的微链url&android_schema='+encodeUri;
}else{
checkOpen(function(opened){
callback && callback(opened);
});
}
}
document.body.appendChild(ifr);
setTimeout(function() {
document.body.removeChild(ifr);
}, 2000);
}
其他
函数中调用的BrowserInfo是一个简单的客户端检测。具体如下:
/**
* 客户端检测
*/
export const BrowserInfo = function() {
var json = {
userAgent: navigator.userAgent.toLowerCase(),
isAndroid: Boolean(navigator.userAgent.match(/android/ig)),
isIphone: Boolean(navigator.userAgent.match(/iphone|ipod/ig)),
isIpad: Boolean(navigator.userAgent.match(/ipad/ig)),
isWeixin: Boolean(navigator.userAgent.match(/MicroMessenger/ig)),
}
return json;
}
回调函数的使用
页面中可以通过传递回调函数,来获取返回值;并通过是否传这个参数来做进入页面检测。