网页调用 iOS/Android 客户端

来源:互联网 发布:mac ssh命令 端口 编辑:程序博客网 时间:2024/06/05 03:01

无论 iOS 还是 Android 都不约而同地支持 URI Scheme(扫盲帖)来作为页面与客户端的通讯协议。这里的 URI Scheme 前缀不是一般的 http://,而是由客户端开发者定义的,一般在写程序的时候就会设置的了。然后剩下的部分就像普通的 URL 地址一样,需要大家来约定 URI Scheme 具体如何,例如参数是什么等等,好比网易新闻客户端的是以 newsapp:// 为前缀:

[html] view plain copy
 在CODE上查看代码片派生到我的代码片
  1. <a href="newsapp://"> 打开网易新闻客户端</a>  

如此便可以从网页打开客户端了。这只是最简单的 Scheme 部分,除此之外,应该还有更多的参数,一般要约定好,让网页开发者和客户端开发者两者之间可以相互调用。

这种情况,当然是假设用户已经安装了客户端,进而才会自动打开。那么,问题就来了,没有安装怎么办?以及最关键的一点——如何判断客户端是否已经安装呢?如果没有安装的话,我们可以提示提示用户去下载(跳到相应的下载页面)这个比较简单;但是,如何判断客户端是否已经安装呢?遗憾的是,浏览器并没有一个方法可以告诉你哪个客户端安装了,哪个没有安装!因此,如果按照上述 a 链接直接跳转而用户又没有安装客户端的话,浏览者看到的是一张空白的页面,——用户体验很差哦~于是我们一般采用“障眼法”,也就是把“隐藏”的 iframe 派上场,用 iframe.src 指向 URI Scheme 地址就可以了,既可以尝试打开客户端,又可以停留在当前页面上。

不过,我们也可以不停留也页面上——因为我们总是鼓励使用客户端的,所以这时候可跳转到下载客户端的页面。这是在没有安装的情况下的做法。如果客户端已经安装了,那就可以不跳转。

具体逻辑如下:

[html] view plain copy
  1. <iframe class="openApp hide" src="about:blank"></iframe>  
  2. <script>  
  3.     function openClient(el, downloadUrl){  
  4.         var iframe = arguments.callee.iframe;  
  5.           
  6.         if(!iframe){  
  7.             iframe = document.querySelector('.openApp')  
  8.             arguments.callee.iframe = iframe;  
  9.         }  
  10.         var startTime = +new Date();  
  11.         iframe.src = el.getAttribute('data-scheme');  
  12.           
  13.         // 如果已知安装的了,则无须跳转下载页  
  14.         setTimeout(function() { // 如果不能打开客户端,跳到下载页面  
  15.             if (Date.now() - startTime < 500) // 通过判断触发的时间与执行settimeout的时间差值是否小于设置的定时时间加上一个浮动值(一般设为100)。  
  16.                 window.location.href = downloadUrl;  
  17.         }, 400);  
  18.     }  
  19.     openClient = openClient.delegate(null, 'http://g.3gtv.net');  
  20. </script>  
稍有点不足的就是,iOS 上面,如果没安装客户端,那么这段自定义的 URL Scheme(如 newsapp://) 就被视为"无效的链接“,弹对话框出来!(貌似 腾讯视频可以解决该问题哦,点击这里看页面——无奈的就是代码经过混淆的,不易察觉) 更新代码后,没有发现这个问题了。如果还是会这样的话,可以尝试用 script tag 发起请求,看能不能规避这个弹出框。

最后我们遇到一个下载页面的问题,由于微信内部浏览器限制的原因,不允许下载 apk 文件或者访问 app store,除非腾讯旗下的“应用宝”才可以。我们对腾讯这一封闭的做法十分不齿,却又无可奈何。于是只能默默地“归化”应用宝。好了,用就用呗——本来跳到下载页面是没有问题的。但令人觉得蛋疼的是,应用宝页面居然自己又会调起客户端(如果安装过的话)!这样势必就是“二次打开”客户端!要规避这个问题,一、不直接跳掉应用宝下载页面;二、改 UI,提供两个按钮,一是打开客户端的,另外一个是下载。

后记,还是兼容性问题:

  • 发现三星 note3 系统浏览器竟然不能 iframe 调起!
  • QQ 浏览器杯具了,竟然对 URI Scheme 一点都不支持!如下图所示,对此,优酷的做法是干脆把 打开客户端 的按钮隐藏掉。



[html] view plain copy
 在CODE上查看代码片派生到我的代码片
  1. <%@tag pageEncoding="UTF-8" import="com.ajaxjs.bigfoot.*" %>  
  2. <%@ attribute name="download_url" required="true" description="应用的下载页面,for Android used"%>   
  3. <%@ attribute name="app_store_id" required="true" description="苹果商店的之 id,当前为 iphone 版,有 ipad 版吗?"%>   
  4. <%@ attribute name="URI_Scheme_iOS" required="true" description="iOS 的 URI_Scheme"%>   
  5. <%@ attribute name="URI_Scheme_Android" required="true" description="安卓的 URI_Scheme"%>  
  6. <!-- 按钮 单击事件 -->  
  7. <!-- <a class="openBtn">打开客户端</a> -->  
  8.   
  9. <iframe id="ifr" style="display: none;border:0;" src="javascript:void(0)"></iframe>  
  10. <script>  
  11.     ;(function(window, doc){  
  12.           
  13.         /**  
  14.          * 读取 search 和 hash 的参数  
  15.          */  
  16.         function localParam(search, hash){  
  17.             search  = search    || window.location.search;  
  18.             hash    = hash      || window.location.hash;  
  19.               
  20.             var fn = function(str, reg){  
  21.                 if(str){  
  22.                     var data = {};  
  23.                     str.replace(reg,function( $0, $1, $2, $3 ){  
  24.                         data[ $1 ] = $3;  
  25.                     });  
  26.                     return data;  
  27.                 }  
  28.             }  
  29.               
  30.             return {  
  31.                 search: fn(search,  new RegExp( "([^?=&]+)(=([^&]*))?", "g" ))||{},  
  32.                 hash:   fn(hash,    new RegExp( "([^#=&]+)(=([^&]*))?", "g" ))||{}  
  33.             };  
  34.         }  
  35.           
  36.         // 应用注册的URI Scheme   
  37.         // 当发现没有安装应用的时候,跳转到 WAP 的下载页面  
  38.           
  39.         window.scrollTo(0,1);  
  40.         var params = localParam(),  
  41.             isIDevice = (/iphone|ipod/gi).test(navigator.platform),  
  42.             isIDeviceIpad = (/ipad/gi).test(navigator.platform),  
  43.             isAndroid = (/Android/gi).test(navigator.userAgent),  
  44.             isWeixin = (/MicroMessenger/ig).test(navigator.userAgent),  
  45.             isappinstalled = params.search['isappinstalled'],  
  46.             appinstall = params.search['appinstall'],  
  47.             wxLink = 'weixinfallback.html',  
  48.             iDownload = 'itms-apps://itunes.apple.com/cn/app/<%=app_store_id%>?mt=8',  
  49.             openAppLink = params.hash['url'] || params.search['url'],  
  50.             iframe = document.getElementById('ifr');  
  51.               
  52.         if( (isIDevice || isIDeviceIpad) && !isAndroid){  
  53. //          openAppLink = openAppLink || 'smcyuetv://';  
  54.             openAppLink = openAppLink || '<%=URI_Scheme_iOS%>';  
  55.         }else if(isAndroid){  
  56. //          openAppLink = openAppLink || 'yuetv://';  
  57.             openAppLink = openAppLink || '<%=URI_Scheme_Android%>';  
  58.         }  
  59.           
  60.         if(isappinstalled!==undefined){  
  61.             wxLink += '?isappinstalled='+isappinstalled+'&openurl='+openAppLink;  
  62.         }else if(appinstall!==undefined){  
  63.             wxLink += '?appinstall='+appinstall+'&openurl='+openAppLink;  
  64.         }else{  
  65.             wxLink += '?openurl='+openAppLink;  
  66.         }  
  67.           
  68.         if(isIDeviceIpad){  
  69.             //iDownload = 'itms-apps://itunes.apple.com/cn/app/id425349261?mt=8';  
  70.         }     
  71.         function download(){  
  72.             // if(isAndroid){  
  73.                 // window.location = 'http://3g.163.com/m/android/software/2vbrks.html';  
  74.             // }else{  
  75.                 window.location ='<%=download_url%>';  
  76.             // }  
  77.         }  
  78.         /*  
  79.          * iOS点击打开:  
  80.         1.如果是微信就去引导图页面  
  81.         2.如果不是微信就走安装就打开不安装就去app store  
  82.         3.如果微信用户按引导图从浏览器打开就能走通第2条  
  83.           
  84.         android点击打开:  
  85.         1.如果是微信就在打开的时候同时跳转到有图的引导页  
  86.         2.如果不是微信就同时跳转到公公共下载页  
  87.         3.如果微信用户按引导图从浏览器打开就能走通第2条  
  88.          */  
  89.         function open(){  
  90.             if(isWeixin){  
  91.                 window.location = wxLink;  
  92.             }else if((isIDevice || isIDeviceIpad) && !isAndroid){  
  93.                 window.location = openAppLink;  
  94.                 setTimeout(function(){  
  95.                     window.location = iDownload;  
  96.                 }, 50);  
  97.             }else{  
  98.                 iframe.src = openAppLink;  
  99.                 download();  
  100.             }  
  101.         }  
  102.           
  103.         document.querySelector(".openBtn").addEventListener("click", open, false);  
  104.           
  105.         // 自动打开  
  106.         var autoopen = params.search['autoopen'] || params.hash['autoopen'];  
  107.         autoopen == 1 && open();  
  108.     })(window,document);  
  109. </script>  
其实,只要是在页面,就应该可以通过 URI Scheme 调用客户端。那么,在 WebApp / Hyper App 也能如是作法吧!

另外,我这里只是着重讨论的网页的部分。调用客户端还是比较简单的,如果需要调用客户端里面的某个一个模块呢?客户端可不想网页那样,天生就是有 URL 定位,传个地址或参数就可以了。这里涉及的客户端原生程序的部分比较多,就是说,如果直接跳到某个模块里面去,——这涉及到客户端模块是否已经合理解耦了,以及所依赖的上下文参数等等诸多问题,——需要和客户端开发者好好商量才行。

参考:

  • 《在mobile safari中巧妙实现检测应用安装就打开,否则进App Store下载》
  • http://yansong.me/2013/10/24/open-native-app-in-browser.html
  • Intent scheme URL attack
0 0