广西无线城市平台应用接入方案融创

1、无线城市平台应用接入方案版本号：0.1 版本号： 1.0.0（报批稿）版本历史日期修订版本描述作者2011-05-9v0.1草稿广西无线城市平台接入规范关植天目录1范围22引用标准23参考规范24符号和缩略语25概述15.1无线城市平台结构15.2无线城市平台与应用系统关系15.3组网原则25.3.1平台在网络中位置25.3.2业务承载平台组网36应用接入方式36.1接入概述36.2接入方式46.2.1技术手段46.2.2页面链接方式46.2.3内容采编/爬虫方式56.2.4视频方式56.2.5mcmapi方式67典型业务流程说明77.1应用接入流程77.2应用注册和发布流程87.3应用发现和

2、服务流程98集团业务归类108.1应用方式缩写说明108.2集团50项应用接入说明108.3应用接入分工149mapp开发规范149.1无线城市平台传递给mapp参数说明149.2手机操作系统编码表159.3应用首页脚本约定169.4开发用相关文档说明1610无线城市平台与si应用系统业务接口描述1710.1无线城市平台提供给si应用系统的接口1710.1.1单点登录鉴权接口1711无线城市平台与si应用系统网管接口描述1911.1si应用系统状态监控接口19附录amapp程序样例191 范围本文档主要对si应用接入无线城市群平台提出了规定，包括应用接入方式，应用接入、上线和访问流程，应用与无

3、线城市平台之间接口及协议，应用开发时需要遵循的约定。本文档供运营商与si共同开发无线城市应用业务使用，适用于指导si应用系统与无线城市群平台接口的实现和si应用的接入管理。2 引用标准下列标准所包含的条文，通过在本标准中引用而成为本标准的条文。3 参考规范1中国移动无线城市平台总体技术要求，中国移动通讯集团公司2 mcm引擎需求规格说明，深圳市融创天下科技发展有限公司4 符号和缩略语mcm开放平台：核心构件包括mcm引擎和mcm服务器两部分，提供一套完整的、开放的移动云计算环境，可以适配多种终端平台，具有开放接口供第三方参与应用开发。mcm服务器：是移动应用开发的服务器侧平台，提供模版开发、逻

4、辑运算、应用api接口开放等功能。mcm引擎：引擎是mcm终端侧引擎，提供移动应用的运行环境、api适配等功能，可适配多种终端平台，主要包括windows、wm、linux、ios、bbos、brew等。移动应用：系统提供的一组功能名称。移动业务：为用户提供某种应用服务，用户可通过移动终端进行访问使用。它通常被设计为具有特定的功能，如提供天气、股票、拍卖等的信息。缩略语缩略语英文全名中文全名mcmmobile cloudy mid-wire移动的云计算中间件mcmsmcm servermcm开放服务器mcmemcm universal enginemcm手机终端通用引擎mappmcm appl

5、ication运行在mcms上的移动应用mcmapimcm api 一套编程接口，遵循该接口规范进行服务端页面编程即可开发出mapp。adcapplication data center应用数据中心siservice integrator系统集成商ecenterprise customer集团客户ssosingle sign on单点登录tokentoken用户单点登录令牌cpcontent provider内容提供商apapplication provider应用提供商5 概述5.1 无线城市平台结构无线城市群平台架构图无线城市群平台由核心管理域、能力支撑域、业务承载域组成。核心管理域包括：

6、管理子平台、展现子平台和接入子平台构成。能力支撑域包括：采编平台、流媒体平台、lbs基地、电子商务基地的手机支付能力、wap适配等组成，能力域通过接口的方式把能力开放给应用业务系统使用。业务承载域负责新开发业务部署和部署已有应用系统展现模版。5.2 无线城市平台与应用系统关系无线城市平台是一个应用聚合平台，为用户提供一站式服务。无线城市门户为应用提供营销展现渠道，实现无线城市用户在平台上能发现和使用业务。应用系统实现具体业务逻辑和业务展现，为用户提供所需服务。应用系统需要根据自身业务特征和用户使用习惯，选择在哪类无线城市门户（wap/web/客户端）进行发布，从而做好应用门户自身的适配展现工作

7、。5.3 组网原则5.3.1 平台在网络中位置无线城市群平台网络拓扑图无线城市平台无线城市平台按照统一规划的思路，是一个满足内容和应用聚合要求的业务运营管理和业务能力支撑的统一平台。它支持web/wap/内容/视频/client等5种接入方式的综合信息业务和行业应用,依据用户偏好提供个性化的移动互联网信息服务。第三方行业应用第三方合作伙伴或政府相关的行业应用服务，以web/wap site形式发布的服务，完成应用接入无线城市平台后，变为方便在手机上操作和使用的业务，如：水电查询、火车时刻表查询、航班查询、订票/订房等。adc/自有应用中国移动拥有的adc平台业务，或其他面向个人/行业的信息化应

8、用。企业自有应用对于企业的自有应用，无线城市平台支持ec的个性化集成配置。位置能力和无线城市平台对接，提供用户位置查询和地图服务接口。支付能力和无线城市平台对接，提供用户电子支付功能接口。视频能力由流媒体基地或本地视频监控平台提供的视频服务类应用。wapgw和无线城市的门户系统对接，提供用户通过cmwap接入的功能。并将无线城市的门户加入白名单，在前转到无线城市的请求中加入用户的号码、接入网络类型、手机ua等信息。iagw提供sms/mms/wappush等消息的转发和路由功能。bossboss为无线城市平台提供用户基础信息的查询接口；无线城市和boss间同步业务、话单信息。nmsnms提供对

9、无线城市平台及其业务的业务网管功能。5.3.2 业务承载平台组网省公司负责搭建公共类业务承载平台，各地市公司搭建本地市特色业务承载平台。组网图如下：业务承载平台软件清单列表：数据库、深圳融创公司mcm server 1.0.10以上版本6 应用接入方式6.1 接入概述接入无线城市的资源分为两类：一类是内容，另一类是应用。内容指的是非交互类的静态数据，如新闻资讯和视频文件之类，该类资源可以由cp通过使用帐号登录无线城市平台以采编的方式录入，从而实现在无线城市三类门户（wap门户、web门户、客户端门户）进行发布展现。应用指的是一组交互功能（如水电煤查询），应用系统本身可分为展现层、逻辑层和数据存

10、储层，应用在接入无线城市时必须已经由应用提供商开发完毕，然后由运营人员根据应用系统的展现层技术决定在无线城市哪类门户发布，下表说明了这两者的关系。 无线城市门户应用展现技术wap门户www门户mcm客户端门户wap 2.0展现（但效果不好）html/xhtml展现mcm展现应用接入无线城市并发布后，用户即可通过某类无线城市门户访问应用。6.2 接入方式6.2.1 技术手段无线城市平台目前提供四种技术手段来支持应用的接入，从而实现用户通过无线城市某种门户访问应用，这四种技术方式分别是：页面链接方式、内容采编/爬虫方式、视频方式和mcmapi方式（又称客户端方式）。下表是从接入耗时、接入成本和用户

11、体验效果三个纬度来评估四种接入方式。 接入方式衡量尺度链接方式采编/爬虫视频方式mcmapi方式时间周期短短短长成本低一般一般高用户体验效果一般好好好6.2.2 页面链接方式页面链接方式又分为：web链接和wap链接。该接入方式受限于应用系统的展现技术，如果应用系统使用的是web site方式发布的服务，即可使用web链接方式，且应用只能发布到无线城市www门户，这类应用的典型代表是互联网的水电煤查询和手机号归属地查询等应用。如果应用系统使用的是wap site方式发布的服务，即可使用wap链接方式，且应用只能发布到无线城市wap和客户端门户，如果该wap site支持wap 2.0即可发布到

12、无线城市www门户，但展现效果不理想。 下图为wap链接方式效果图6.2.3 内容采编/爬虫方式内容采编方式主要用于图文资讯类信息采集，网络爬虫方式主要用于采集web网站上指定频道的静态资讯，如爬取新浪门户的体育新闻频道的资讯。该接入方式要求编辑人员使用cp帐号登录无线城市平台的内容采编系统，使用系统提供的相应功能操作完成。采编/爬虫方式展现的效果图：6.2.4 视频方式视频业务又称流媒体业务，指的是终端播放器实时从流媒体服务器上获取流媒体数据，边下载边播放，流媒体内容不在终端设备上存储。如果同一内容需要多次重复播放，需要每次播放时从流媒体服务器上重新下载数据。根据流媒体内容的来源，流媒体业务

13、可分为点播和直播两种：流媒体点播内容提供者预先对一段多媒体内容进行编辑、压缩编码，形成指定格式的文件，然后上传到流媒体服务器上。用户根据需要选择流媒体服务器上的内容文件进行播放。该类业务在接入无线城市平台时，需要使用融创提供的转码服务器，将互联网的通用视频格式统一转换为平台支持的tivc格式，然后编辑人员使用cp帐号登录无线城市平台的内容采编系统使用系统提供的相应功能把视频文件上传到平台即可。流媒体直播终端播放器播放流媒体直播内容时，内容的播放时刻与内容源事件的发生时刻相同，即流媒体编码服务器对内容源进行实时地压缩编码，经由流媒体服务器发送到用户终端。从信号源上划分，直播业务又分为电视直播和视

14、频监控。电视直播业务在接入无线城市平台时，可以使用融创的流媒体平台接入。具体操作可参考cms 2.0操作手册。视频监控业务在接入无线城市平台时，先把所有的视频监控源接入省规划建设的视频监控平台，然后视频监控平台把监控资源以web/wap site或mcmapi方式发布服务，接着可遵循“页面链接方式”和“mcmapi方式”把业务接入无线城市平台。下图是监控类业务接入后用户使用的效果图：6.2.5 mcmapi方式应用系统通常都为用户提供web或wap展现使用服务。这样的业务虽然可以通过“页面链接方式”接入无线城市，但用户在无线城市客户端门户上体验效果不理想，这就要求对应用系统展现层进行补充，增加

15、mcmapi方式。下图是用mcmapi方式接入的两个应用（气象、航班）在无线城市客户端门户上的体验效果： 使用该方式接入的应用，应用拓展小组需要组织应用开发商si使用mcm api进行应用的展现界面开发，把开发好的mapp程序部署到业务承载平台的mcm服务器中并进行测试，最后遵循“应用上架流程”把应用发布到无线城市平台客户端门户。具体的mapp程序开发请参考第9章mapp开发规范。7 典型业务流程说明7.1 应用接入流程应用接入流程详细描述：为了更好完成应用接入无线城市平台这项工作，设定如下角色或小组负责不同的分工，他们分别是：应用接入发起方、应用拓展组、内容组、ap、应用测试组和运营组。1.

16、 应用接入发起方向无线城市应用拓展小组提出应用接入需求；2. 应用拓展小组评估和与资源掌控方谈判应用占用的资源是否可在无线城市平台上合法使用；3. 应用拓展小组根据应用接入需求选择应用的接入方式，然后提交给ap或内容配置组；4. 如果使用页面链接方式，且该web链接方式或wap链接方式的应用不存在，那么可提交给ap开发web方式发布的服务或wap方式发布的服务；如果采用内容采编/爬虫方式，那么可向内容配置组提出通过平台的内容采编系统功能实现内容的配置；如果采用视频方式，当属于流媒体点播时，可以通知内容配置组使用转码服务器先转码再通过内容采编系统功能实现视频点播接入，当属于视频监控时，即需要提交

17、给ap开发web或wap或mcmapi方式发布的服务；如果使用mcmapi方式，那么可提交给ap在无线城市平台测试环境开发mapp。应用开发和部署好后，提交给应用测试组进行功能测试。5. 收到测试通知后应用测试组在测试环境进行应用功能的详细测试，并输出测试报告。如果测试不通过即要求ap对应用进行修改直到测试通过。6. 测试通过后，平台通知应用审核人员对应用进行审核上线，从而完成应用在无线城市相应门户发布。然后平台通知应用拓展组应用接入结案。7.2 应用注册和发布流程应用注册和发布流程详细描述：1. 管理员在管理子系统在线录入应用信息；2. 业务管理员分配应用接入授权信息；3. 接入子平台完成接

18、入权限的开放；4. 应用测试组完成应用的接入测试和功能测试，并提交测试报告给管理员；5. 管理员完成应用的测试结果确认；6. 管理员确认无误后提交应用上线申请；7. 应用审核人员对应用的接入上线进行审核，对不符合条件的可予以驳回，对符合条件的应用确认上线；8. 通知第6步提交应用上线申请的管理员审核结果；9. 如果审核通过，管理子系统通知展现子系统进行应用上线；如果审核不通过，即需要修改应用后重新提交上线申请；10. 展现子系统更新栏目信息。7.3 应用发现和服务流程应用发现和服务流程详细描述：1. 用户登录：用户通过展现子系统进行登录（web/wap/客户端）。展现子系统发送用户登录信息至管

19、理子系统进行身份认证。2. 身份认证：管理子系统根据展现子系统发送的用户登录信息对用户进行身份认证。若认证失败，则返回认证失败信息至展现子系统。3. 用户个性化查询：管理子系统对用户身份认证成功后，自动进行用户个性化查询。并将个性化查询结果返回展现子系统。4. 个性化门户主页展现：展现子系统接收到管理子系统返回的用户个性化信息后，进行个性化匹配，为用户展示具有个性化特色的界面。5. 发现业务：用户在登录到无线城市系统后，通过栏目导航和应用查找的方式发现具体的应用业务，并点击应用进行访问。6. 使用业务：管理子系统根据展现子系统发送过来的应用标识获取应用的配置信息，并生成访问地址相关参数（包括平

20、台颁发的token令牌），然后把请求重定向到应用系统；7. 应用系统对用户进行身份验证，成功即向用户提供应用服务。8 集团业务归类8.1 应用方式缩写说明接入方式页面接入方式内容采编/爬虫方式视频方式mcmapi方式缩写abcd8.2 集团50项应用接入说明本章主要对移动集团规划的12类业务，50项重点应用进行接入梳理，给出建议的接入方式。这10类业务主要是：政务、公共事业、交通、医疗、教育、就业、金融、旅游、生活服务、消费购物、行业类、智能城市管理。类别应用名称基本功能介绍应用接入方式政务政府门户政务信息公开、公文公告、政策法规解读、工作动态等。a城市办事指南各政府单位办事指南，流程介绍，联

21、系方式等。a手机信访通过手机互动方式反馈群众信访意见和建议，加强互动。a便民问答在线问答形式提供便民服务。a政务办理/查询各级政府办事机构办事查询。a政府常用电话查询输入单位名称，查询电话a公共事业水费查询用户输入号码查询a电费查询用户输入号码查询a煤气费查询用户输入号码查询a公积金查询用户输入号码查询a社保查询用户输入号码查询a医保查询用户输入号码查询a个人所得税查询用户输入号码查询a护照办理办理流程介绍、表格下载等信息；部分流程网上电子化。a通行证办理办理流程介绍、表格下载等信息；部分流程网上电子化。a物价信息查询前日、当日各市场主要商品信息b发票查询输入号码，查询发票信息a交通交通视频主

22、要交通路口视频图像c实时路况主要交通路段实时路况信息，短/彩信方式c地图查询输入地名在地图上标示，短/彩信方式d违章查询输入车牌号，查询违章记录a驾驶员积分输入驾驶证号码，查询积分情况a火车查询输入火车车次，站名查询火车情况，时刻，票价等。a航班查询输入航班号，查询航班抵达情况等。a公交查询输入公交车次号码，起点/终点查询公交信息、换乘信息等。a客运查询输入起、终点查询客运信息，时刻，票价等。a停车场查询预约选择停车场，查询剩余停车位，并预约a车行无忧基于物联网和移动定位技术，结合gps卫星精确定位与基站定位技术的特点，为车主提供车辆防盗的服务。当用户车辆被盗时，用户手机会收到告警通知，并可以

23、通过车行无忧终端及时定位，协助警方找回车辆。d电子汽车票用户选择日期车次即可预订车票a医疗预约挂号选择日期、医院科室、大夫即可预约挂号a药品查询选择药名、种类、是否医保、剂型等查询药品信息a名医名院著名医院、著名医生情况介绍b教育手机图书馆输入书名、isbn、作者、出版社等查询图书信息。结合手机阅读。a成绩查询各类考试成绩查询、初、高、成人高考a学校信息各类学校信息b就业求职信息分类求职、招聘信息a金融手机银行整合各银行wap，客户端版本。a/d旅游旅游信息旅游资源、图片、功略、联系电话等b酒店查询预订酒店信息查询预订a城市热点城市“吃喝玩乐”热点地区攻略、联系方式b生活服务特色餐饮分类餐饮信

24、息，地点，菜系，特色菜，联系电话，点评。b天气查询输入地点查询天气预报a生活百科各类生活信息b手机电影票各大影院影视信息，预订二维码手机电影票。awlan热点查询输入地名，查询附近的wlan热点。d手机缴费银行卡/通信账户/手机钱包账户缴纳相关费用a掌上营业厅移动自有业务推荐/办理a社区信息客户加入某个社区，获取社区信息a妇婴保健妇婴保健类信息。按孕前/孕中/出生后进行运营，结合当前天气情况等。进行内容/圈子运营b惠民邮箱（扩展应用）医保、社保、公积金、水、电、煤气、有线电视费用的信息整合投递到客户139邮箱b房产信息房地产政策，楼市信息，交易信息等。b消费购物商家优惠各类优惠、折扣信息，短彩

25、信下发优惠卷。a团购信息团购信息，团购支付，短彩信下发确认信息等。a行业类企业之窗用于展示使用了我公司企业建站业务的集团客户信息（企业建站通过web、wap、短信等方式已为1400余家集团客户提供模块化自助建站服务）a校讯通用于加强学校和家长之间联系的校园信息化服务管理系统。它将手机短信、电脑和互联网结合，面向中小学生家长提供家校互动的专门服务,同时为学校提供高效实用的移动办公平台。 包含“数字校园”和“家长网校”应用。d农信通为广大农民朋友提供政策法规、新闻快讯、农业科技、市场供求、价格行情、农事气象等信息，满足农产品的产供销、农村政务的管理及农民关注的民生问题等信息化需求，让农民朋友们足不

26、出户就能知晓丰富的农业信息。d公交一卡通手机刷公交。d公交视频监控作为南宁平安城市“天网”工程主要组成部分，南宁市今年计划在500辆公交车安装电子视频监控c智能城市管理解决方案城管通针对特定行业用户开放的应用内容。d警务通d平安城市d8.3 应用接入分工 成员工作内容运营商平台提供商/开发商应用提供商案例页面链接协调应用提供商，提供web门户和wap门户网站地址，授权允许在无线城市接入使用通过采编平台把门户网站接入到无线城市平台，然后通过展现子平台统一发布无线城市客户端、无线城市wapweb门户网站提供门户网站地址无线政务，引入采编/爬虫无需投入内容编辑人员采集图文信息，然后通过展现子平台统一

27、发布无线城市客户端、无线城市wapweb门户网站无需投入内容编辑录入广西旅游新闻或爬虫新浪热点新闻视频方式协调视频资源掌控方（如电视台、道路监控视频），授权允许在无线城市平台播放该视频负责将视频转码，然后发布到无线城市平台，供客户端及门户网站播放无需投入电视直播、宝宝视频mcmapi方式洽谈应用接入，授权允许在无线城市平台接入该项业务组织使用mcm api进行应用的展现界面开发，把开发好的mapp程序部署到业务承载平台的mcm服务器中并进行测试，最后遵循“应用上架流程”把应用发布到无线城市平台提供业务逻辑、相关接口及数据库等相关资源供开发车辆违章查询，实现短信查询9 mapp开发规范9.1 无

28、线城市平台传递给mapp参数说明下表定义的参数是mapp程序可能需要用到的参数，当用户从无线城市mcm客户端访问mapp应用系统时，无线城市平台将把这些参数传给mapp应用系统。参数名参数说明是否可空参数取值_sys_screen.width手机屏幕宽（像素）否如：240_sys_screen.height手机屏幕高（像素）否如：320_screen_key理论适配屏幕宽x高，如一个240x290的非主流屏幕手机，该值是240x320,该参数主要用于服务器使用何种模版来适配展现否如: 240x320_sys_assignedplatform客户端平台信息是如：j2me,symbian 3.1_

29、sys_platformtype手机平台信息，如三星i458等是手机厂家定义的机型标识_sys_channel客户端后缀版本否如：440100_31_0_sys_clientversion客户端版本信息否如：11_240x320_440100_31_0city_code用户所在城市编码否遵循国家统计局公布的6位城市编码roamcityname用户所在城市名称否如：广州市sso_token用户成功登录平台后，由平台颁发的令牌。如果应用系统需要验证用户合法性，可以调用“单点登录鉴权接口”否如：909969819ad6b57e02631dfe330a69d8最长32位sso_return_url客户

30、端首页地址，应用可以使用该值做一个返回无线城市主页的功能按钮是如:wxfj.uisso_user_code平台用户标识是最长32位字符sso_background_var预留，用于标识应用的背景图是否应该使用无线城市门户指定的背景图是非空时表示应用应该使用无线城市门户指定的背景图客户端版本信息(_sys_clientversion取值)说明： 客户端类型取值请参考“手机操作系统编码表”9.2 手机操作系统编码表根据手机操作系统的不同，区分手机客户端类型；见下表：客户端类型类型子代码kjava00symbian 3rd11symbian 2rd12symbian 5th13symbian uiq

31、14windows mobile20oms 1.0 30oms 1.531oms 2.032android 1.140android 1.541android 1.642android 2.143android 2.244iphone50ipad60bb os 4.6.070bb os 5.0719.3 应用首页脚本约定 当用户从无线城市mcm客户端门户访问mapp应用时，mapp应用首页必须执行如下功能逻辑：把等待提示信息和无线城市门户窗体设置为隐含状态，脚本如下： function endload() wait_base.removeui();$parentuibase.setvisibl

32、e(false);currentuibase.setfocus(true); mapp应用必须实现返回无线城市门户功能，即必须实现“onkeyreleaseexit”事件处理，处理的功能逻辑如下：把无线城市门户窗体设置为显示状态，然后把mapp应用窗体占用的资源删除释放，脚本如下：onkeyreleaseexit=$parentuibase.setvisible(true);$parentuibase.setfocus(true);currentuibase.removeui();具体样例可参考附录a mapp程序样例。9.4 开发用相关文档说明类别文档mcm产品介绍产品介绍产品白皮书开发过程

33、介绍视频教程mcm设计规范ui设计规范切图规范视频教程mcm开发指南服务器部署方法（windows/linux）模拟器部署方法html培训for mcmscript培训for mcmmcm开发手册项目实战faq视频教程打包发布打包工具操作方法说明视频教程mcm升级流程引擎端服务器端开发者社区设计开发对开发者来说，上表较为重要的文档资源为：mcm开发手册，开发者需要学习该手册，以完成mapp程序的开发。以上文档可向融创无线城市项目接口人索取。10 无线城市平台与si应用系统业务接口描述10.1 无线城市平台提供给si应用系统的接口10.1.1 单点登录鉴权接口 实现要求对于无需鉴权的大众类应用业

34、务（如天气预报、12580公众类业务），应用系统无需实现该接口；仅在应用系统提供的服务是受保护的，需要对用户进行认证鉴权的，为了实现用户单点登录效果，提高用户体验效果，这时才要求应用系统实现该接口。 功能说明用户经过无线城市门户使用si应用业务之前，首先需要成功登录无线城市群平台，无线城市群平台的管理子系统为用户生成一个token（令牌）；同时用户可以使用其拥有的所有si应用，用户点击应用链接时，系统将用户token和fromsys传送到si应用系统，为实现单点登录，si应用系统需要请求无线城市平台对该token进行统一鉴权，fromsys用于标识请求来源于无线城市平台。无线城市平台在鉴权响应中将token对应的用户个人信息和权限信息（可能为空）返回到si应用系统。token和fromsys采用http post方式来传递，url中的参数名分别为：sso_token和fromsys，采用明文传送sso_token无