网页调用 iOS/Android 客户端

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

<a href="newsapp://"> 打开网易新闻客户端</a>

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

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

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

具体逻辑如下：

<iframe class="openApp hide" src="about:blank"></iframe>
<script>
	function openClient(el, downloadUrl){
		var iframe = arguments.callee.iframe;
		
		if(!iframe){
			iframe = document.querySelector('.openApp')
			arguments.callee.iframe = iframe;
		}
		var startTime = +new Date();
		iframe.src = el.getAttribute('data-scheme');
		
		// 如果已知安装的了，则无须跳转下载页
		setTimeout(function() { // 如果不能打开客户端，跳到下载页面
	        if (Date.now() - startTime < 500) // 通过判断触发的时间与执行settimeout的时间差值是否小于设置的定时时间加上一个浮动值（一般设为100）。
	        	window.location.href = downloadUrl;
	    }, 400);
	}
	openClient = openClient.delegate(null, 'http://g.3gtv.net');
</script>

稍有点不足的就是，iOS 上面，如果没安装客户端，那么这段自定义的 URL Scheme（如 newsapp://） 就被视为"无效的链接“，弹对话框出来！（貌似 腾讯视频可以解决该问题哦，点击这里看页面——无奈的就是代码经过混淆的，不易察觉） 更新代码后，没有发现这个问题了。如果还是会这样的话，可以尝试用 script tag 发起请求，看能不能规避这个弹出框。

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

后记，还是兼容性问题：

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

<%@tag pageEncoding="UTF-8" import="com.ajaxjs.bigfoot.*" %>
<%@ attribute name="download_url" required="true" description="应用的下载页面，for Android used"%> 
<%@ attribute name="app_store_id" required="true" description="苹果商店的之 id，当前为 iphone 版，有 ipad 版吗？"%> 
<%@ attribute name="URI_Scheme_iOS" required="true" description="iOS 的 URI_Scheme"%> 
<%@ attribute name="URI_Scheme_Android" required="true" description="安卓的 URI_Scheme"%>
<!-- 按钮 单击事件 -->
<!-- <a class="openBtn">打开客户端</a> -->

<iframe id="ifr" style="display: none;border:0;" src="javascript:void(0)"></iframe>
<script>
	;(function(window, doc){
		
		/**
		 * 读取 search 和 hash 的参数
		 */
	    function localParam(search, hash){
	        search	= search	|| window.location.search;
	        hash	= hash		|| window.location.hash;
	        
	        var fn = function(str, reg){
	            if(str){
	                var data = {};
	                str.replace(reg,function( $0, $1, $2, $3 ){
	                    data[ $1 ] = $3;
	                });
	                return data;
	            }
	        }
	        
	        return {
	        	search: fn(search,	new RegExp( "([^?=&]+)(=([^&]*))?", "g" ))||{},
	        	hash:   fn(hash,	new RegExp( "([^#=&]+)(=([^&]*))?", "g" ))||{}
	        };
	    }
		
	    // 应用注册的URI Scheme 
	    // 当发现没有安装应用的时候，跳转到 WAP 的下载页面
	    
	    window.scrollTo(0,1);
	    var params = localParam(),
	        isIDevice = (/iphone|ipod/gi).test(navigator.platform),
	        isIDeviceIpad = (/ipad/gi).test(navigator.platform),
	        isAndroid = (/Android/gi).test(navigator.userAgent),
	        isWeixin = (/MicroMessenger/ig).test(navigator.userAgent),
	        isappinstalled = params.search['isappinstalled'],
	        appinstall = params.search['appinstall'],
	        wxLink = 'weixinfallback.html',
	        iDownload = 'itms-apps://itunes.apple.com/cn/app/<%=app_store_id%>?mt=8',
	        openAppLink = params.hash['url'] || params.search['url'],
	        iframe = document.getElementById('ifr');
	        
	    if( (isIDevice || isIDeviceIpad) && !isAndroid){
// 	    	openAppLink = openAppLink || 'smcyuetv://';
	    	openAppLink = openAppLink || '<%=URI_Scheme_iOS%>';
	    }else if(isAndroid){
// 	    	openAppLink = openAppLink || 'yuetv://';
	    	openAppLink = openAppLink || '<%=URI_Scheme_Android%>';
	    }
		
	    if(isappinstalled!==undefined){
			wxLink += '?isappinstalled='+isappinstalled+'&openurl='+openAppLink;
		}else if(appinstall!==undefined){
			wxLink += '?appinstall='+appinstall+'&openurl='+openAppLink;
		}else{
			wxLink += '?openurl='+openAppLink;
		}
		
		if(isIDeviceIpad){
	        //iDownload = 'itms-apps://itunes.apple.com/cn/app/id425349261?mt=8';
	    }	
	    function download(){
	        // if(isAndroid){
	            // window.location = 'http://3g.163.com/m/android/software/2vbrks.html';
	        // }else{
	            window.location ='<%=download_url%>';
	        // }
	    }
	    /*
	     * iOS点击打开:
		1.如果是微信就去引导图页面
		2.如果不是微信就走安装就打开不安装就去app store
		3.如果微信用户按引导图从浏览器打开就能走通第2条
		
		android点击打开:
		1.如果是微信就在打开的时候同时跳转到有图的引导页
		2.如果不是微信就同时跳转到公公共下载页
		3.如果微信用户按引导图从浏览器打开就能走通第2条
	     */
	    function open(){
	    	if(isWeixin){
	    		window.location = wxLink;
	    	}else if((isIDevice || isIDeviceIpad) && !isAndroid){
	            window.location = openAppLink;
	            setTimeout(function(){
	            	window.location = iDownload;
	            }, 50);
	    	}else{
	    		iframe.src = openAppLink;
	            download();
	    	}
	    }
	    
	    document.querySelector(".openBtn").addEventListener("click", open, false);
	    
	    // 自动打开
	    var autoopen = params.search['autoopen'] || params.hash['autoopen'];
	    autoopen == 1 && open();
	})(window,document);
</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