手机开放平台-资源包API_V1.0.docVIP

Api定义 银联商务有限公司 2015年4月 本文档中的所有内容为银联商务有限公司的机密和专属所有。未经的明确书面许可，任何人不得。 版本控制信息 版本 日期 拟稿和修改 说明 V1.0 2015/04/03 修改：唐为祥 初稿 目 录 第1章 接口定义 - 4 - 1.1 接口描述 - 4 - 1.2 JS与客户端通信方式介绍 - 4 - 1.2.1 JS调用客户端 - 4 - 1.2.2 客户端事件通知JS - 4 - 1.3 JS调用客户端请求 - 5 - 1.3.1 API中PARAM.INFO.TYPE定义表 - 6 - 1.4 页面生命周期事件 - 8 - 1.4.1 流程图 - 8 - 1.4.2 流程解释 - 8 - 1.4.3 全局Context定义 - 9 - 得到定位信息 - 9 - 得到当前登录用户信息 - 10 - 得到当前客户端信息 - 11 - 接口定义 接口描述 本接口用于动态加载的页面调用系统级的API和客户端对加载的页面事件通知时使用。 JS与客户端通信方式介绍 JS调用客户端 JS调用客户端分为两种方式：一种是同步方式，另一种是异步方式。具体某个接口是使用同步还是使用异步，由接口文档约定。不管是同步调用还是异步调用，在html页面中都是以使用打开弹出框的形式调用API：prompt(jsonRequest, umsApi);所有参数均需要使用Base64转码后传入，所有回调的参数也以Base64转码。 1）JS同步调用客户端API：android客户端是通过重新实现下面代码来截获JS请求： public class MyChromeClient extends WebChromeClient { @Override public boolean onJsPrompt(WebView view, String origin, String jsonData, String jsonHeader, JsPromptResult result) { result.confirm(jsonRespons);//同步调用返回 } } 2）JS异步调用客户端API：android客户端截获JS请求的方式和同步调用方式一样。客户端返回调用结果是通过webview.loadurl(javascript:UmsApi.onCallback(jsonData));的方式返回给JS。JS脚本实现UmsApi.onCallback方法由框架统一实行。 客户端事件通知JS 客户端调用JS主要通过事件通知的方式进行。JS通过注册事件的方式设置某个事件的监听处理函数。客户端通过调用 loadUrl( javascript: UmsApi.fireDocumentEvent(eventName,jsonData););其中eventName表示事件名称，jsonData为事件参数。事件名称和事件参数都用Base64转码。 JS调用客户端请求 1、所有参数均需要使用Base64转码后传入，所有回调的参数也以Base64转码； 2、API接口调用均为资源包中的JS调用手机客户端提供的接口； 3、请求参数是一个普通的json字符串。 4、请求的报文头格式如下： 请求报文 jsonRequest 功能描述 和客户端进行交互后得到所需信息 参数 jsonRequest 描述 进行base64转码的一个json字符串，是要发送的报文数据 格式 { info:{ type:1011, requestId:ABCDE-FGHIGH-EFSE }, data:{} } 参数解释 info.type为某一个具体交互的操作类型，该操作类型为数字类型，标识是打电话、弹出对话框等操作。 info.requestId是一个uuid，是一个唯一标识。 data为具体的业务报文。 请求处理结果 同步调用 result.confirm(jsonRespons); 2、异步调用 UmsApi.onCallback (jsonRespons) info.type为某一个 info.requestId为请求时的唯一标识。 jsonRespons为返回的业务报文，经过base64转码的json字符串。 说明 jsonRespons 描述 进行base64转码的一个json字符串，是要响应的报文数据 格式 { info:{ type:1011, requestId:ABCDE-FGHIGH-EFSE }, data:{} } 参数解释 info.type为某一个具体交互的