中国联通CDMAWAP2.0业务开发规范

142/149中国联通CDMAWAP2.0业务开发规范（V3.0）中国联合通信有限公司2005年12月目录1 概述 11.1 文档内容 11.2 适用范围 11.3 解释权及修订权 11.4 术语和缩略语 21.5 参考文献 22 WAP2.0技术说明 33 业务管理规定 43.1 Wap2.0业务申报注意事项 43.2 Wap2.0业务测试前相关要求 43.3 Wap2.0下载业务计费Url的申报方法 53.4 计费和价格 63.4.1 费用结构与收费模式 63.4.2 收费规则 63.4.3 价格原则 73.4.4 优惠规则 74 业务开发规范 84.1 业务访问和定制/退定流程 84.1.1 业务访问流程 84.1.2 用户订购和使用业务的流程 94.1.3 用户退定业务流程 114.2 页面开发规范 124.2.1 页面设计基本原则 124.2.2 页面效果规范 124.2.3 背景音乐规范 144.2.4 图标与图形规范 154.2.5 CACHE规范 164.2.6 菜单规范 174.2.7 页面返回规范 174.2.8 文本显示规范 184.2.9 用户输入规范 204.2.10 格式化输入规范 204.2.11 浏览器性能参考 214.2.12 MHTML格式页面 214.2.13 终端适配 254.2.14 COOKIES规范 254.3 URL说明 264.4 业务返回规范 274.4.1 说明 274.4.2 适用范围 274.4.3 页面和软键(数字键)的返回规定 274.4.4 业务的“返回上级” 284.4.5 业务的“返回首页” 314.4.6 业务的返回“频道首页” 324.5 WapPush规范 334.5.1 说明 334.5.2 点对点WAPPUSH 334.5.3 CP服务器发起的WAPPUSH 434.5.4 注意事项 514.6 业务实现要求 524.6.1 对WAP1.2的兼容 524.6.2 浏览类业务 574.6.3 下载类业务 594.6.4 PUSH类业务 674.7 用户手机号码和手机型号获取说明 714.8 编码和代码 72概述中国联通CDMA“互动视界”业务自开展以来，用户数增长迅速，用户使用的各类业务越来越丰富，目前提供的各类业务均是按照WAP1.2标准向用户提供的服务。为了提供更好、功能更加强大的服务，中国联通建立了统一的WAP2.0门户站点，与WAP1.2门户站点相结合，对用户提供各类服务，为了保证统一WAP2.0业务，特制定了本业务规范。文档内容本规范内容包括WAP2.0业务的技术说明，业务访问流程，计费和价格原则以及各类业务规范，并给出了相应的基本原则与例子。同时对于WAP1.2业务的兼容性和延续性作了相关说明。适用范围本规范适用于中国联通各级机构和CP/SP（内容/服务提供商）通过中国联通CDMAWAP2.0门户站点向用户提供各类WAP2.0服务。解释权及修订权本规范由中国联通制定、审核并发布，起草单位为中国联通增值业务部。本规范将根据市场发展需要适时进行修改，其修改权和解释权属于中国联通增值业务部。术语和缩略语WAP:WirelessApplicationProtocolSP:ServiceProvider,服务提供商页面：每次请求，所得到的显示内容频道：根据业务内容分类划分的区域，频道下为栏目列表栏目：频道中的某一类服务，栏目下是业务列表栏目标题：显示内容的页面顶端显示的内容标题栏目名称：菜单栏目列表中指向内容链接或下一级菜单链接的栏目名XML：extensiblemarkuplanguage,扩展超文本标记语言,HTML的最新版本（v.4.1）是XHTML的基础。XHTMLMP:XHTMLmobileprofile,XHTML移动描述。源于XHTMLBasic并且从完整的XHTML1.1中增加了在移动浏览器中有用的元素和属性。WAPCSS：WAPcascadingstylesheets，是CSS的移动版本，他是CSS的一个子集，但不包括那些不适用于特别小的设备功能。CP/SP：内容提供商/服务提供商资费确认：用户确认收费规则，如包月、点击及收费金额资费确认资费确认计费：根据用户确认的收费策略，作计费处理，计算本次使用服务的费用参考文献《中国联通CDMAWAP业务规范》《中国联通CDMAWAP平台接口规范》《中国联通CDMAPUSH业务规范》WAP2.0技术说明与WAP1.2相比，WAP2.0主要采用的技术：XHTMLMP。采用XHTMLMP来扩展XHTML的基本用户简介，并能够按需要增加其他语言元素。TCP/IP传送协议移动简本。WAP2.0将推动业界为无线链路开发TCP移动简本，能与目前Internet上运行的通用TCP互操作。移动友好技术：包括XHTML的简本;层叠样式表（CSS）移动简本;用户个性喜好和设备能力介绍等。与WAP1.2相比，WAP2.0主要体现在：采用最新的Internet标准和协议，能优化网络带宽的利用以及基于数据包的全球无线网络的连接。能对已有的WAP内容、应用和业务提供可管理的向后兼容性。WAP2.0XHTMLMP，并支持WAP1.x内容的WML。这些标记语言在发挥其独特优点的同时，为移动设备提供合适的内容业务。支持对WML1.0的完全向后兼容。WML2.0在WML1.0增加了向后兼容的具体特性后对XHTMLMP的扩展，可实现从WML1.0到XHTMLMP的名称、属性的转换。支持的图片格式有：GIF，JPEG，PNG，BMP、WBMP等。按照WAP2.0标准化组织提出的标准开发规范进行页面开发，例如：支持XHTML的简本，层叠样式表（CSS）移动简本，多媒体信息服务（MMS），WAPPush等支持语言：支持内容标记语言、WWWConsortium（W3C）以XML（extensiblemarkuplanguage）为基础规定的兼容HTML的“XHTMLBasic”，和CSS（cascadingstylesheets）样式单。支持协议：因特网标准的TCP/IP。详细WAP2.0技术说明，请访问：/。业务管理规定Wap2.0业务申报注意事项SP提交的业务必须严格按照WAP业务开发规范和《页面开发规范》（4.2）进行开发，必须根据对页面（如，大小在20K以下）、图片（如，页面小图片不超过8个）、铃声（如，铃音必须有试听）、背景音（选择项，但如果采用，则背景音必须有开启关闭的快捷方式）、快捷键、返回、速度等要求严格执行。在SP已分配的测试区首位新增“WAP20业务区”，在业务接入前，均需将WAP2.0业务URL加入到测试区。控制每个SP业务的上线数量，原则上一个栏目一个SP只能上线一个业务（可包含两个（含两个）以下子业务），申报业务时注意内容整合。SP应严格按照联通WAP2.0频道规划中规定的数量进行申报。SP提交的WAP2.0业务名称必须积极健康，长度不超过四个汉字。要求每个业务必须提供“免费试用区”，因此，申报/调整业务的确认或计费Url不能包含或等于入口Url。对于提供给2.0手机使用的按次或包天下载业务，CP需单独提交业务资源所在路径的Url作为2.0按次或包天下载计费Url。具体填写位置详见工单。Wap2.0业务测试前相关要求必须严格按照《WAP20业务开发规范》和《WAP20页面开发规范》的要求进行业务开发，并且业务开发前根据《Wap2.0门户架构》的设置要求，考虑新业务锁定的目标人群，确定所属频道。在业务开发中必须考虑申报业务所在频道或栏目的容量，原则上一个栏目一个SP只能接入一个业务（可包含两个（含两个）以下子业务）。所以，在业务开发中一定要注意业务的整合和资源的合理使用。联通在业务审核时将不计算SP在某一栏目下已接入业务的数量，请SP自己做好业务数量的核对工作，以避免测试通过后业务无法上线。SP的业务在评审通过后，提交测试前必须增加业务内容数量、提高内容质量，否则将不予以测试。务必保证在提交测试前将业务的数量扩充到同类WAP1.2的上线业务的60％，上线后不低于80％。SP在提交业务申请前务必详细阅读《WAP2.0业务申报注意事项》(3.1)。SP新提交业务从uni-wise网站上进行申请，业务处不再接收申请。SP在提交申请通过后，应提供《WAP2.0业务申报表》，提供URL等相关信息。Wap2.0下载业务计费Url的申报方法WAP2.0下载类业务的计费URL下载业务的申报方法下载类业务，不管是包月、按次、按天计费，计费URL都必须是业务资源所在的路径。例如：某CP提供的“图片下载”业务，所有的图片都放在“/test/picture/”目录下，那么该业务的计费URL应该为“/test/”，也就是说，该业务中准备用来下载的资源必须处于计费URL的目录下为了不违反“不同业务计费URL不能重复或包含”的原则可得，对于下载类业务，不同业务的下载资源不能存放于同一路径，否则相关业务的计费URL就会存在重复或包含。计费和价格对于本章节内容，与WAP1.2业务规范一致。费用结构与收费模式中国联通WAP2.0业务的计费均由中国联通进行，费用包括基础通信费和信息服务费。基础通信费通信费解释：用户使用中国联通无线通信网络发生的费用，由中国联通制定收费标准，并由中国联通向用户收取。通信费解释信息服务费信息费解释：用户使用SP提供的应用服务而发生的费用，由提供服务的SP制定标准，并由中国联通代SP向用户收取。信息费解释收费规则中国联通WAP平台对于SP提供的WAP2.0业务，支持如下几种信息费计费方法：免费业务:指用户免费使用SP提供的该项业务收费:SP对于一个业务可以同时选择多个计费方式收费方式，如下：收费方式按点击计费：按点击计费是用户在使用某CP申请并提供的某项业务时，再申请的地址之下的页面中每点击一次该服务计一次费，如：点击一条新闻计0.1元。按天计费：按照天为单位进行收费，CP就某业务整体进行收费，用户在一天内使用该业务收取一次特定价格的费用，多次进出和重复使用不重复计费。用户当天不使用此业务，不收取费用。包月计费：包月计费是指一次性收取一定费用，在计费月中用户定制某包月服务时，系统一次性收取业务全月费用，用户本自然月内多次使用不重复计费，如果用户不退定，则在后续月初自动的一次性收取全月费用。价格原则中国联通WAP2.0业务的信息费由SP指定。但为了规范市场，保证SP公平竞争，SP制定信息服务费的价格应遵循信息服务费不能低于成本价的原则。优惠规则为了更好的推广业务，中国联通WAP平台对于SP提供的WAP2.0业务，支持如下几种信息费优惠方法：对每一个新的用户给予固定时间长度（可设定）的免费试用：在优惠开始和结束日期之内定制该业务，免费使用一段时间。免费试用时长由SP制定。对每一个新的用户给予固定时间次数（可设定）的免费试用：在优惠开始和结束日期之内定制该业务，免费使用设定的次数。免费试用次数由SP制定。在固定日期内对所有用户免费使用：SP需要制定免费开始日期和结束日期。在固定日期内对所有用户按折扣优惠：在优惠开始和结束日期之内，按照业务的原定价格的某一个百分比进行计费。SP需要制定免费开始日期和结束日期，以及百分比。设定的优惠价格（小于正常的收费价格）进行优惠。CP/SP可以申请优惠开始和结束日期，以及优惠价格在固定日期内对所有用户以特定优惠价格优惠：在优惠开始和结束日期之内，按照低于业务的原定价格的某一个特定优惠价格进行计费。SP需要制定免费开始日期和结束日期，以及优惠价格。优惠套餐优惠：指把某一个SP的几项业务捆绑在一起向用户销售的策略，用户定制优惠套餐后，在每月缴纳一定费用（如用户每月缴纳25元），就可以使用此SP的优惠套餐中的全部业务。业务开发规范业务访问和定制/退定流程对于本章节内容，与WAP1.2业务一致。业务访问流程WAP2.0业务的用户访问流程与WAP1.2业务访问流程类似，参见下图：用户使用移动终端一键上网请求访问WAP门户首页，WAP平台对用户请求处理后，返回WAP门户首页。在WAP门户中，存在链接指向SP服务器。用户点击WAP门户中的链接，请求访问SP服务器中的业务，该请求发送给WAP平台的计费处理系统。WAP平台对用户的请求进行认证和鉴权处理后，如果认证和鉴权通过，则WAP平台转发请求给SP服务器。SP服务器处理用户请求，并返回响应给WAP平台系统。WAP平台系统返回响应给用户，同时根据SP服务器响应结果对用户进行计费处理。说明：对用户的计费均由中国联通CDMAWAP平台处理。用户订购和使用业务的流程用户使用一个未定制业务的流程用户使用移动终端发送业务使用请求给WAP平台。WAP平台判断用户是否已经定制了此业务，如果未定制此业务，WAP平台弹出业务订购页面，并返回给到用户终端。用户选择业务收费规则，并确认订购。WAP平台成功处理用户定制请求后，把用户请求发送给SP服务器。SP服务器返回响应给WAP平台。WAP平台返回响应给用户终端。同时WAP平台将用户定制信息传送给SP业务服务器。用户使用一个已定制业务的流程用户使用移动终端发送业务使用请求。由WAP平台判断用户是否已经定制了此业务。WAP平台验证用户已经定制的业务，则将请求转发给SP业务服务器。SP服务器端返回请求给WAP平台。WAP平台返回请求给用户终端。用户退定业务流程用户使用移动终端或者登录中国联通统一WEB界面，对已定制的业务进行退定操作。WAP平台成功处理业务退定操作后，将用户退定业务信息传送到SP业务服务器。页面开发规范页面设计基本原则由于手机终端具有屏幕狭小、输入受限等特点，同时移动互联网速度较慢，因此CP/SP业务设计本着引导与方便用户使用原则而开展。CP/SP所开发业务既要较快让用户进入与使用，又要方便用户出来使用其它栏目或者CP/SP业务。用户进入后无法通过链接返回首页的业务视为重大错误。浏览类与信息类业务要求各CP/SP要有功能与风格基本一致的界面。页面效果规范页面的效果应把握“提高访问速度的前提下，提高页面浏览流量、提高页面视觉冲击效果”的原则：单页面图片与文字总和的整体容量应控制在20k以下，普通页面的全部展现时间应保证小于4s，多图形页面的全部展现时间应保证小于6s（包括页面内置对象）。对于业务入口页面，在保证速度的前提下，应尽可能做得丰富一些，增强用户的视觉感受；对于第二级和第三级及其以下的页面，可以稍微简化页面的效果，但是不允许出现纯文本的页面。对于使用图片的页面，应该设置与图片主色调相近的背景色，在用户触发页面的下载后，应保证用户通过迅速见到出现的背景色而能感受到下载已经进行，绝对不能在下载进行中向用户展现白屏。如果使用表格的嵌套，嵌套的层数应该少于2层。CSS应该定义到每一个文件，不能单独做成一个文件，应使用页面内包含。对于背景的图片，建议使用小图片的平铺方式，可以大大提高下载速度，平铺应该优先考虑双模手机170cm像素的屏宽。否则将会出现明显的接缝痕迹，示例如下:未考虑双模手机平铺效果：建议平铺效果：HtmlBody下的子TAG中的内容应尽量少，尽量少定义全局，应分散到多个子TAG中，TAG禁止相互嵌套，代码示例:<P><tablewidth="100%"border="0"cellspacing="0"cellpadding="0"><tr><td> </td></tr><tr><td> </td></tr></table>方孤苦伶仃接口管理发动机可法律界公开勒索奋斗</P>应该为：<P><tablewidth="100%"border="0"cellspacing="0"cellpadding="0"><tr><td> </td></tr><tr><td> </td></tr></table></P><P>方孤苦伶仃接口管理发动机可法律界公开勒索奋斗</P>页面中所有显示图片应加Alt，在图片未完全下载前，能够用文字给用户以图片展示内容的说明。示例代码如下：<html><head><metahttp-equiv="Content-Type"content="text/html;charset=gb2312"><title></title></head><body><imgsrc=”a。gif”alt=”xxxx业务”></body></html>背景音乐规范背景音乐使用MIDI格式。为了满足用户在不同场景中的需要，页面中应该设置明显的可以开启或关闭背景音的操作方式。背景音乐的请求代码应该放在图片的请求代码的后面，以保证下载速度和用户感受，示例代码如下：推荐的写法：<html><head><metahttp-equiv="Content-Type"content="text/html;charset=gb2312"><title></title></head><body>fkdgjkldgjklfjdksgjkdlgjklfdjgkldjf<bgsoundsrc="xx。mid"></body></html>不推荐的写法：<html><head><metahttp-equiv="Content-Type"content="text/html;charset=gb2312"><title></title></head><bodybgsoundsrc="xx。mid">fkdgjkldgjklfjdksgjkdlgjklfdjgkldjf</body></html>图标与图形规范为了保证页面的整体下载时间，建议单页面图片的容量应该控制在15k以内。图片下载必须提供图片预览功能，预览时显示文字应为“生成预览中…”，预览图片应为80x80像素，大小应控制在6K以内，以保证预览生成的速度在3秒以内。正式下载的图片应尽量保证容量较大，图像清晰。建议下载图片大小在25K左右，预览页面效果如图：圣诞老人1256字节下载圣诞老人1256字节下载返回上级*联通首页#生成预览中…圣诞老人1256字节下载返回上级*联通首页#WAP浏览器对于不同格式的图片解码速度是不同的，根据测试值得出（OPENWAVE浏览器），解码速度BMP<PNG<JPEG<GIF，建议CP/SP在保证图片质量的基础上，最好选择GIF和PNG格式的图片，并且应经过PHOTOSHOP压缩。由于使用小图标会增加Http请求的个数从而影响页面的整体下载速度，所以不推荐在栏目列表中使用较多的小图标，建议使用特殊符号或者数字符号代替小图标，可以很大程度上提高浏览速度；如果必须使用，则每页使用小图标的个数不应超过8个，且单个图标大小应在500byte以内。CACHE规范为加快用户浏览页面显示速度，业务入口页面，以及公共性和架构类的页面应使用CACHE，其他页面不应使用CACHE。不要将时效性很强的内容（如新闻、股票信息等）留在CACHE中。天气信息、交通信息等特定内容在CACHE中的有效时间为6小时。对动态信息要强制更新。菜单规范菜单项按业务的重要性的顺序来排列，用户最可能选择的业务排在前面。菜单项应遵循的排列格式：在保证美观的基础上，如果菜单一列显示，文本部分左对齐，图片菜单部分中间对齐；如果分列显示，文本部分左对齐，图片菜单项要尽量与屏幕宽度相同，如果不能相同，则要保证中间对齐。菜单项应尽量避免使用小图标。。建议使用数字快捷键作为菜单选择手段，但是菜单选项应该使用明显的标识提示用户使用数字快捷键，菜单选项多于9个时，定义“0”键表示进入下一页，定义“*”键表示返回上级；定义“#”键表示返回首页。对于不支持字符触发的终端，“返回上级”和“联通首页”应采用小图标和文字链接，可以通过方向键选择。菜单尽量不要小图标（Icon）和数字快捷键同时使用，因为这样，对于大部分终端，会造成菜单文字的换行，影响界面的美观。如果需要在一个菜单项上执行多个操作，可以通过弹出式菜单实现。页面返回规范用户经常使用手机中的返回按键（通常就是删除按键）返回或退出，因此，返回连接对一个业务的成功是十分关键的，要倍加关注，对返回连接设计好的业务，将会显著地提高用户的使用次数。在所有业务的页面底部必须有一个“联通首页#”和“返回上级*”的链接(注意必须在链接的文字后提供“#”和“*”作为明显的标识提示用户)；“返回首页”的链接为：，页面效果如图：（（个人图片)（图片下载）（铃声下载）（屏保动画）（音乐动画）(背景图片)返回上级*联通首页#返回上级：指返回SP的应用菜单联通首页：指返回互动视界的首页如果上一个页面是重定向页面，则“返回上级”应跳过重定向页面。为了便于用户的使用，在有些情况下，允许返回上级功能不直接返回上一个页面，而是将用户带到最方便使用业务的页面。例：用户在使用铃声搜索或者单词翻译的业务时，当输入的要搜索的铃声或者翻译的单词，然后进入确认页面，点击确认后，当没有找到时出现的提示页面中的返回，不是返回到确认页面，而是返回到重新输入页面；文本显示规范一个CARD中显示500-600个字符，即300汉字以内。当需要显示的内容超过范围时，在底部提供一个“下一页”连接，但在每个栏目下，传送给用户的内容最好不要超过3页。将超出一行的内容分行显示，但主菜单及子栏目标题则应尽量将文字压缩为一行。如：“少女系列三十一”此标题字符过长，可将其压缩为“少女系列31”。所有文本左对齐。每段文字的首字需要保证对应的文字缩进。浏览图片和新闻等内容时，应提供明示下一主题或内容的连接说明，用于用户直接转到下一个主题或内容，比如“下一张”、“下一条”等，而不要仅仅显示“下一页”，以免造成用户的混淆。所有提示性文字应使用统一的简体中文，避免出现英文与中文混合的内容，如“Loading…请稍后”，应为“正在下载中…请稍后”。菜单中的各项要按照一定的逻辑顺序来排列，如按照类型、时间、字母顺序等。如果没有逻辑顺序，就按优先级排列，将最可能选择的排在最前面，将最新更新的部分放在最前面，并加入“NEW”字样。新闻类栏目要在新闻标题的后面显示新闻发布的日期及出处。如图：中国队大胜香港队……中国队大胜香港队……。(2004。11。18，摘自XX时报)央视招标突破50亿……。(2004。11。18，摘自XX晚报报)北京警方成功破获多起抢劫案……。(2004.11.18，摘自XX时报)下一页返回上级*联通首页#当用户阅读文本时，应能主动预读取下一页文本到手机的CACHE中，加快用户阅读的切换速度。比如：<head><linkhref=”page2。wml”rel=”next”/></head><cardid=”page1”><dotype=”accept”lable=”Page2”><gohref=”page2。wml”/></do><p>Page1of2<br/>…。</p></card>上面的代码展示了如何利用预取功能对一个卡片组中的下一个卡片进行访问。用户输入规范尽量减少用户的文本输入。当已激活输入区域时，只需要有一个确认连接，不需要提供其他功能。为每一个输入项尽可能直观的提示与描述，但不要多于10个汉字。对每一个输入项，将输入的内容限制在254个字符之内。应通过设定输入框的内容类型，避免用户增加切换输入法的操作。对用户输入的密码，不要用*进行掩盖，在手机上明文显示即可。使用MAXLENGTH参数来限制用户输入密码的长度，避免用户出错。格式化输入规范格式化输入主要包括输入日期、信用卡号码等具有固定格式的内容。对所有格式化输入都必须表明输入格式，如输入如期时可以表示为：MM/YYYY见下例：对输入的类型进行强制匹配，该输入数字的地方，不能输入字母。可以通过MAXLENGTH参数限制输入的字符数。对确定的内容进行预制，如输入日期时可以表示为20xx，只让用户输入后两位数字就可以。对可确定用户输入的文字功能实现自动切换，如需用户输入密码时，应自动切换为“数字功能”，要求用户输入Email地址时，应自动切换为“英文”等。浏览器性能参考目前浏览器并发请求能力无法启用，浏览器一次只能发送1个请求，因此建议CP/SP建议控制页面中Httplink数目。页面中httplink请求的顺序是按照编写的顺序产生的，建议CP/SP对于较大的对象应尽量放在后面。页面编码应采用utf-8，可减少proxy或终端的转化。MHTML格式页面概述鉴于4.2.11章节中提到的手机浏览器单连接同步发送请求的特性，减少同一页面中请求数量可以有效的加快页面翻转速度。MHTML格式页面恰恰可以满足如上需求。目前Openwave6.X版本的浏览器已经被普遍的应用在Wap2.0终端上，该版本手机浏览器可以支持Multipart/relatedMIMEType。由于MHTML格式页面对于“多图”页面能够显著提供页面翻转速度，因此，对于由页面下载速度缓慢而严重影响用户感知、用户体验的页面，我们建议采用MHTML格式页面进行打包，将多个请求转换为一个请求，缩短由于手机浏览器的局限而导致页面翻转较长的耗时。实现原理网页打包技术是一种基于HTTP的传输扩展协议，可以参考互联网标准协议RFC2557《MIMEEncapsulationofAggregateDocuments,suchasHTML(MHTML)》，通过在传输过程中实现页面和页面内嵌对象的整合编码技术，实现一次连接可以传输完整页面及页面内嵌对象的技术标准。本协议是对RFC2557在WAP传输上的修正，针对无线网络的特性，去掉了冗余数据，结合CDMA1x的高速数据通道实现无缝高效传输。传统的WAP页面传输过程：向服务器发送请求，请求页面文件(WML或XHTML)。显示初步页面。浏览器针对页面进行分析，得到页面内嵌对象（如图片，铃声）的URL。继续发送对页面内嵌对象请求。显示完整页面。服务器手机

页面元素文件服务器手机页面元素文件XHTML文件多次请求/应答一次请求/应答WML/XHTML格式页面传输示意图服务器手机打包技术页面传输过程：服务器手机向服务器发送页面请求，传输整个MHTML页面文件。对打包文件解码，显示完整页面。手机服务器MHTML文件手机服务器MHTML文件一次请求/应答MHTML技术传输示意图简单实现过程将网页转成Multipart格式使用IE打开某业务入口页面。在菜单中选择另存为。在对话框内选择保存类型为[WEB档案，单一文件]。选择编码为UTF-8,文件名为test.mht，确定保存。在菜单中选择另存为。在对话框内选择保存类型为[网页，html格式]。文件名为test.html，确定保存。使用文本编辑器打开test.mht。去掉前的16行（前16行为IE自行添加的冗余信息）。增加以下内容：<%@<%@pagecontentType="multipart/related;type=\"text/html\";boundary=\"=_NextPart_000_0003_01C54672.B1702520\""%>=_NextPart_000_0003_01C54672.B1702520Content-Type:text/html;charset="utf-8"Content-Transfer-Encoding:quoted-printableContent-Location:page将页面元素转成Base64格式接前一章节：查找图片文件的URL位置。修改为本地路径。去掉最后一行的标识=_NextPart_000_0000_01C54B57.43303D40-（对于不同情况，黄色背景部分可能略有不同）。在文件尾部加上以下内容（假设该测试页面只内嵌了2个对象）：=_NextPart_000_0003_01C54672.B1702520=_NextPart_000_0003_01C54672.B1702520Content-Type:image/gifContent-Transfer-Encoding:base64Content-Location:a.gif=_NextPart_000_0003_01C54672.B1702520Content-Type:image/gifContent-Transfer-Encoding:base64Content-Location:b.gif=_NextPart_000_0003_01C54672.B1702520--在test.files文件夹中找出图片文件并使用BASE64进行编码，获得纯文本字符串，或参照以下步骤使用outlook对图片进行编码。打开outlook,新建一个邮件在附件中选择以上的图片文件发送邮件在邮件发送箱中找到该邮件查看邮件属性里的详细信息选择编号好的图片文件内容整合为MHTML文件在test.mht中粘贴对内嵌对象进行BASE64编码后的纯文本字符串。如，=_NextPart_000_0003_01C54672.B1702520=_NextPart_000_0003_01C54672.B1702520Content-Type:image/gifContent-Transfer-Encoding:base64Content-Location:a.gif此处粘贴a.gif进行BASE64编码后的纯文本字符串=_NextPart_000_0003_01C54672.B1702520Content-Type:image/gifContent-Transfer-Encoding:base64Content-Location:b.gif此处粘贴b.gif进行BASE64编码后的纯文本字符串=_NextPart_000_0003_01C54672.B1702520--将test.mht另存为test.jsp。部署到应用服务器。进行测试。应用范围如章节要求，对于由页面下载速度缓慢而严重影响用户感知、用户体验的页面，我们建议采用MHTML格式页面进行打包。以下举例说明建议采用MHTML格式进行开发的现网业务页面（灰色涂抹部分为尚未下载完成的图片说明，顾及影响，此处以灰色进行涂抹）。以上页面效果严重影响用户感知、用户体验，因此，对于此类业务页面，我们建议以MHTML格式进行开发。终端适配由于终端支持的选择性的，相同设计的页面在不同的终端上有着不同的表现形式，因此，请CP/SP在开发时注意通过终端适配，识别不同的终端并根据其不同的能力属性来推送适配的页面。由于终端CPU性能的影响，一些终端在解码时CPU资源占用严重，影响浏览速度，这类终端不适合图片内容较多的页面的展现，CP/SP应单独对这类终端进行适配。COOKIES规范鉴于终端浏览器可以设置不支持Cookie，因此，对于需要保存会话关系的WAP2.0应用程序，应通过URL重写（URLRewriting）的方式来保存会话关系，即将用户的会话信息保存在URL中，当用户点击链接时送回服务器端来保持用户的会话关系。URL说明三个URL解释三个URL解释对于本章节内容，与WAP1.2业务一致。SP在中国联通WAP门户中提供一个WAP2.0业务时，需遵循中国联通WAP平台基于URL计费（信息费）的原则，对于接入的任何收费业务需要提供如下几类URL：参数名称参数举例用途描述入口URL/wap/index.jsp业务的入口URL，唯一的一个计费URL/wap/content/fee1//wap/content/fee2/如果用户访问的URL包含此URL，WAP平台进行计费处理。可以为多个。确认URL/wap/content1//wap/content2/如果用户访问的URL包含此URL，WAP平台判断如果用户未定制此业务，则会弹出收费信息供用户选择和定制。可以为多个。说明：对同一业务的计费URL、确认URL不能存在包含关系或重复对于同一个业务入口URL只能有一个，但计费URL或确认URL，均可以为多个。对不同的业务，一个业务的入口、计费或确认URL不允许与另外一个业务的入口、计费或确认URL相同；也不允许出现包含的情况。由于手机支持的URL长度有限，而且不同的机型支持的长度也不一致，为了能够使各种机型均能够正常使用WAP业务，要求接入的业务内容的URL长度不能够超过128个字符，并不允许出现中文字符。由于中国联通CDMAWAP系统只处理80端口，所以下载、浏览等各类业务的接入必须使用80端口，且不要显式的在URL中指出“:80”，只需采用默认的80端口即可。不允许出现业务内容对应的URL为其他端口的情况。业务返回规范说明为了统一中国联通WAP业务风格，保证WAP业务的可用性和易用性，现对有关页面的返回上级和返回首页制定本规范。对通过中国联通WAP门户网站提供连接或者由中国联通审核通过的接入CP/SP所提供的的代计费功能的WAP业务均要求遵循本规范中的相关原则与规定。中国联通将对本规范进一步的修改与完善，同时也欢迎广大合作伙伴就WAP业务规范给中国联通提供建议与意见。中国联通保留本规范的最终解释权。适用范围本规范适用于中国联通CDMAWAP全网业务。页面和软键(数字键)的返回规定在一级栏目页面（或者是业务的起始页面）必须有一个“返回首页”的链接；同时，WAP1.2业务页面的右软键被定义为“回首页”的链接。在二级栏目以下的页面（或者是业务使用中的页面）必须同时有“返回上级”和“返回首页”的链接；同时，WAP1.2业务的页面右软键被定义为“回首页”的链接；当页面的指示光标没有指向一个链接的时候，浏览器的左软键定义为“返回”，链接至上级页面；同时，WAP1.2业务的页面右软键被定义为“回首页”的链接；为了便于用户的使用，在有些情况下，允许返回上级功能不直接返回上一个页面，而是将用户带到最方便使用业务的页面；例：用户在使用铃声搜索或者单词翻译的业务时，当输入的要搜索的铃声或者翻译的单词，然后进入确认页面，点击确认后，当没有找到时出现的提示页面中的返回，不是返回到确认页面，而是返回到重新输入页面；需特别注意的关于软键的规定：基于WAP1.2开发的业务必须支持以上定义的左、右软键功能。对基于WAP2.0开发的业务，可以不支持软键功能，但是，假如某个业务选择使用软键功能，那么就必须遵循以上定义的整套软键规范；特别地，对于WAP2.0业务，CP必须在业务的每一个页面上使用数字键（AccessKey）完成返回的功能，统一规范为：“*”键表示返回上级；“#”键表示返回首页。业务的“返回上级”全网业务的“返回上级”全网业务的返回上级可以分为以下两种情况：从CP业务的底层页面返回到CP业务的上一级页面；从CP业务的入口页面或者需要返回到WAP门户对应栏目的页面返回到WAP栏目，做到“从哪里来回哪里去”。第一种情况的返回上级是由CP开发人员根据业务本身的流程，设定返回上级应当返回的最佳页面。第二种情况必须按照以下的说明，完成相关URL的设定。当平台操作员通过平台Portal管理功能将CP的业务入口加入平台某个栏目时，平台会自动向CP业务的入口URL传送参数“PT”，该参数由两部分组成，以冒号“：”分隔，前一部分为PortalID，通过此ID来判断用户是来自于哪一个WAP门户，根据此ID决定CP业务返回首页应当返回哪个门户的页面；后面一部分为栏目ID，决定返回到哪个具体的栏目页面。总部WAP门户栏目的URL由两部分组成：门户URL和栏目ID。门户URL可以根据PortalID对应表查得。栏目ID则是作为“Dir”参数的参数值传递给门户平台的。对于本身不带参数的入口URL，例如：/cy/HWKT.jsp当用户点击该栏目的业务链接时，该业务的CP服务器获得的对应请求URL为：/cy/HWKT.jsp?PT=2:11375。对于已经带参数业务入口URL，则会自动加“&PT=2:11375”，例如：/picDown/picjsp/PicPreviewImg.jsp?BT=PD&Dir=1075&PARA=2&PIID=14&ATP=2&CID=200307291001120&PT=2:11375CP根据获得的PT参数就能够动态写出正确的返回上级URL。CP应该利用编程语言的某种方式（传递参数、session值、存入数据表等）保证入口URL获得的参数能够跟随用户的访问，这样当用户在业务中访问了若干个页面后，当需要利用业务入口页面的返回上级功能时，依然能够获得正确的PortalID与栏目ID。例：幻彩图片栏目中图片下载类业务“哈哇酷图”的入口URL被写为：/cy/HWKT.jsp?PT=2:11375。根据PT参数，CP开发人员可以知道，2为PortalID，代表用户的访问来自于总部WAP1.2门户（北京），其URL为：/hswap/index.jsp；11375为栏目ID，代表用户是从幻彩图片栏目进入的。那么，返回上一级的URL就是：/hswap/index.jsp?Dir=11375。该URL即代表总部WAP门户（北京）中的幻彩图片栏目。另外，目前用户进入到一个具体的业务的途径目前有两种方式：通过互动视界分类栏目的链接进入；通过用户个人定制页的定制的业务链接进入；用户定制业务后，从“使用服务”链接直接进入业务。针对这几种进入业务方式，应当建立不同的处理机制。针对1的情况，用户在访问业务的首页面的时候，会将相应的PT参数传递给业务入口页面。CP取到参数后，该参数应当跟随用户的访问。当用户从业务的底层页面返回到业务入口页面的时候，在入口页面上显示“返回上级”，该返回上级应当正确生成返回业务所属的栏目的链接。针对2和3的情况，用户在访问业务的入口页面的时候，WAP平台系统并没有将相应的PT参数传递给业务首页面，CP无法在用户访问业务首页面的时候取到PT参数。在此情况下，CP应选择以下两种方式中的任意一种进行处理：(1)仍然显示返回上级，但是返回上级的链接写为：/特别地，对于WAP2.0业务，返回上级的链接写为：/这样用户点击后依然返回到个人定制页面，实现“从哪里来回哪里去”。(2)隐藏返回上级链接，只保留返回首页的链接，根据平台系统的设置，用户也可以返回到个人定制页面。总部WAP门户的首页和PORTALID节点PORTALIDPORTAL首页北京1.22/hswap/index.jsp上海1.23广东1.24重庆1.26江苏1.27/index.aspx山东1.28浙江1.29北京2.012/hswap/index.jsp上海2.032广东2.042重庆2.062江苏2.072/index.aspx山东2.082浙江2.092三期全网Wap2.0统一Portal12/hswap/index.jsp或/hswap/index.jsp【注】“三期全网Wap2.0统一Portal”即当前运行于北京Wap2.0Portal，随着“四期工程”的实施，该Portal将被“四期工程”北京Wap2.0Portal取代。因此，上表中“北京2.0”与“三期全网Wap2.0统一Portal”采用同一PortalID并不冲突。下同。业务的“返回首页”访问总部Portal业务中的“返回首页”用户访问总部portal业务，当点击“返回首页”时，将返回到“互动视界”的首页。首页地址为：/个人首页业务中的“返回首页”如果用户存在已定业务，则返回个人首页，否则返回首页。【注意】本章节内容仅适用在Wap2.0Portal接入的业务。业务的返回“频道首页”对于从Portal栏目点击进入业务的情况，总部Portal会给业务入口页面传送PT参数。如前文所讲，PT参数分为两部分，第一部分为PortalID，第二部分为栏目ID。如：PT=N:23722。CP/SP需取出PT参数的第二部分，即，栏目ID，作为参数按如下“PortalID与Url对应表”拼接作为返回频道首页链接。节点PortalID链接北京2.012/hswap/chnIndex.jsp上海2.032广东2.042重庆2.062江苏2.072/chnIndex.aspx山东2.082浙江2.092三期工程全网2.0统一Portal12/hswap/chnIndex.jsp对于北京、上海、广东、重庆大区或三期工程全网2.0统一Portal（即，PortalID为22、32、42、62或10-14时），拼接后得到如下Url：/hswap/chnIndex.jsp?Dir=23722对于江苏、山东、浙江大区（即，Portal为72、82或92时），拼接后得到如下Url：/chnIndex.aspx?Dir=23722其中，23722为CP/SP从PT参数中取出的栏目ID。【注意】1）本章节内容仅适用在Wap2.0Portal接入的业务。当CP无法获取PT参数时，应隐藏此链接。如，通过CP业务间链接进入其他业务的情况和通过个人首页进入业务的情况。WapPush规范说明本文定义和规定了中国联通CDMAWAP业务网综合管理平台PUSH接口规范，CP/SP的PUSH业务页面开发参照本规范。为了加强对PUSH接口的监控，杜绝未经授权的私自群发，中国联通增值业务部特整理修订了该规范。并将“点对点WAPPUSH”、“CP服务器发起的PUSH”分为两个独立的接口分别提供服务。该规范对应的PUSH接口正式运行后，所有提供WAPPUSH的业务将统一切换至该版本接口运行。与原PUSH接口的不同之处将在以下章节详细说明。点对点WAPPUSH概述点对点WAPPUSH增加真实主叫注册和验证流程。要求CP必须修改“发送给好友”链接，在URL中加入验证页面URL，以确保PUSH接口可以记录手机用户对PUSH业务的真实请求，并在CP调用PUSH接口时对相应手机用户是否真实请求发送该业务的PUSH进行验证。时序图：流程描述：手机终端请求CP业务页面（此处省略平台转发HTTP请求的描述）。由于CP业务页面中“发送给好友”链接新增了指向平台的URL，因此用户点击“发送给好友”链接后，会直接请求平台的该页面。即，点对点PUSH权限分配页面。平台记录相关真实主叫对PUSH的请求信息。平台将用户重定向至CP的PUSH信息录入页面。即，“发送给好友”链接中除新增的指向平台的URL外，剩余部分的URL。CP在5分钟内调用点对点PUSH接口，并在接口中填写真实的PUSH主叫、CP代码、业务代码等信息。平台根据先前记录的点对点PUSH真实主叫信息对CP在点对点PUSH接口中填写的信息进行验证。如果验证通过，则转发PUSH信息至手机终端。如果不通过，则在接口中返回相应错误应答。【注意】步骤1～4为新增流程。CP务必按照规范支持新增流程，否则点对点PUSH的鉴权将会失败。页面开发规范点对点PUSHURL描述该URL存在于CP向用户展现的提供PUSH服务的页面。即，“发送给好友”的URL指向。用户通过点击该链接触发PUSH，该URL链接至总部PUSH接口的权限分配程序，权限分配完毕由该页面自动将用户重定向至CP的PUSH信息录入页面。该URL由两部分组成：前缀为总部PUSH接口的权限分配程序的URL，后接CP的PUSH信息录入页面的URL，CP的URL不再需要以http://开头，举例说明如下：“发送给好友”URL格式：公网：2/reg/reg//push/input.jsp内网：94/reg/reg//push/input.jsp其中，2/reg/reg/和94/reg/reg/为总部PUSH接口的权限分配程序的URL，/push/input.jsp为CP端提供用户录入PUSH信息页面的URL。【注意】为保证网络通畅，建议使用权限分配页面的内网地址。接口开发规范接口描述CP/SPServer调用WAP增值业务管理平台点对点WAPPUSH的Webservice的接口，实现点对点WAPPUSH功能。CP/SP如果在业务中调用WAP增值业务管理平台中的Push功能，CP/SP需要提出书面申请，申请通过后，才可以正常调用WAPPush的接口。对于点对点WAPPUSH，CP/SP需修改“发送给好友”链接的URL，用于在每次调用点对点WAPPUSH接口前申请WAPPUSH权限。具体请参考“CP页面开发规范”章节。发起方系统总部CP/SP业务系统接收方系统中国联通WAP增值业务管理平台接口协议SOAP/HTTP。访问控制机制只有通过认证的IP地址才能调用该接口，只有申请权限成功的时候才能成功发送点对点WAPPUSH。调用函数pushMSGPTP(StringcpCode,StringserviceID,StringfromUserMobile,StringtoUserMobile,StringalertTitle,StringalertURL)接口形式参数说明cpCode字符型说明：SP的企业代码，为中国联通增值业务部分配。serviceID字符型说明：SP调用PUSH接口的业务代码，为中国联通增值业务部分配。fromUserMobile字符型说明：主叫号码，发送push的手机号码，以133开头的11位数、或以86开头的13位数或加密手机号码，只有一个号码。如果中国联通总部CP未获得总部WAP平台传送的手机号码，需向中国联通申请。如果中国联通总部CP获得的为公开的主叫号码（X-up-calling-line-id），可以直接使用此主叫号码。toUserMobile字符型说明：被叫号码，接收push的手机号码，以133开头的11位数或以86开头的13位数。如果是多个手机号码，号码间用“,”逗号分割。该字段允许的手机号码个数请参考“4注意事项”章节，或依联通总部增值业务部最新规定为准。alertTitle字符型说明：用户在发送push的时候输入的文字信息，不允许超过50个中文字符长度，由于大部分手机型号只支持UTF-8码，所以统一为UTF-8码。alertURL字符型说明：需要push给被叫方的url。如果url中带有参数，要求使用”&”作为连接符。返回值如果发给1个手机号码则返回：手机号码:状态码:状态信息如果发给多个手机号码则返回：手机号码:状态码:状态信息||..||手机号码:状态码:状态信息手机号码：以133开头的11位数或以86开头的13位数。状态码的详细说明如下：状态码说明-300其他错误-200usernotsupportWAPornotaccesstheRoutedwapportalbefore!（漫游发送）-100usernotsupportWAPornotaccesstheRoutedwapportalbefore!（本地发送）-500pointtopointvalidatefail!（点对点PUSH请求鉴权失败）-600toomanyreceivemobile!（被叫用户过多）-700isnotordertheservice!（未定制该业务）1000OK1001AcceptedforProcessing2000BadRequest2001Forbidden2002AddressError2003AddressNotFound2004PushIDNotFound2005CapabilitiesMismatch2006RequiredCapabilitiesNotSupported2007DuplicatePushID3000InternalServerError3001NotImplemented3002VersionNotSupported3003NotPossible3004CapabilityMatchingNotSupported3005MultipleAddressesNotSupported3006TransformationFailure3007SpecifiedDeliveryMethodNotPossible3008CapabilitiesNotAvailable3009RequiredNetworkNotAvailable3010RequiredBearerNotAvailable4000ServiceFailure4001ServiceUnavailable5xxxMobileClientAborted除-100、-200、-300、-500、-600、-700为WAP增值业务平台系统返回，其他返回值均为PUSH网关返回的错误码。其中只有1000和1001是正确发送的情况。service地址webservice地址：公网：2/pushhq/services/PushService私网：94/pushhq/services/PushServicewsdl文件地址：公网：2/pushhq/services/PushService?wsdl私网：94/pushhq/services/PushService?wsdl

<?xmlversion="1.0"encoding="UTF-8"?><wsdl:definitionstargetNamespace="2/pushhq/services/PushService"xmlns:wsdl="/wsdl/"xmlns:xsd="/2001/XMLSchema"xmlns:wsdlsoap="/wsdl/soap/"xmlns:intf="2/pushhq/services/PushService"xmlns:impl="2/pushhq/services/PushService-impl"xmlns:SOAP-ENC="/soap/encoding/"xmlns="/wsdl/"><wsdl:messagename="pushMSGSVRResponse"><wsdl:partname="return"type="xsd:string"/></wsdl:message><wsdl:messagename="pushMSGPTPRequest"><wsdl:partname="cpCode"type="xsd:string"/><wsdl:partname="serviceID"type="xsd:string"/><wsdl:partname="fromUserMobile"type="xsd:string"/><wsdl:partname="toUserMobile"type="xsd:string"/><wsdl:partname="alertTitle"type="xsd:string"/><wsdl:partname="alertURL"type="xsd:string"/></wsdl:message><wsdl:messagename="pushMSGSVRRequest"><wsdl:partname="cpCode"type="xsd:string"/><wsdl:partname="serviceID"type="xsd:string"/><wsdl:partname="fromUserMobile"type="xsd:string"/><wsdl:partname="toUserMobile"type="xsd:string"/><wsdl:partname="alertTitle"type="xsd:string"/><wsdl:partname="alertURL"type="xsd:string"/></wsdl:message><wsdl:messagename="pushMSGPTPResponse"><wsdl:partname="return"type="xsd:string"/></wsdl:message><wsdl:portTypename="PushHQ2CP"><wsdl:operationname="pushMSGPTP"parameterOrder="cpCodeserviceIDfromUserMobiletoUserMobilealertTitlealertURL"><wsdl:inputmessage="intf:pushMSGPTPRequest"/><wsdl:outputmessage="intf:pushMSGPTPResponse"/></wsdl:operation><wsdl:operationname="pushMSGSVR"parameterOrder="cpCodeserviceIDfromUserMobiletoUserMobilealertTitlealertURL"><wsdl:inputmessage="intf:pushMSGSVRRequest"/><wsdl:outputmessage="intf:pushMSGSVRResponse"/></wsdl:operation></wsdl:portType><wsdl:bindingname="PushServiceSoapBinding"type="intf:PushHQ2CP"><wsdlsoap:bindingstyle="rpc"transport="/soap/http"/><wsdl:operationname="pushMSGPTP"><wsdlsoap:operationsoapAction=""/><wsdl:input><wsdlsoap:bodyuse="encoded"encodingStyle="/soap/encoding/"namespace="2/pushhq/services/PushService"/></wsdl:input><wsdl:output><wsdlsoap:bodyuse="encoded"encodingStyle="/soap/encoding/"namespace="2/pushhq/services/PushService"/></wsdl:output></wsdl:operation><wsdl:operationname="pushMSGSVR"><wsdlsoap:operationsoapAction=""/><wsdl:input><wsdlsoap:bodyuse="encoded"encodingStyle="/soap/encoding/"namespace="2/pushhq/services/PushService"/></wsdl:input><wsdl:output><wsdlsoap:bodyuse="encoded"encodingStyle="/soap/encoding/"namespace="2/pushhq/services/PushService"/></wsdl:output></wsdl:operation></wsdl:binding><wsdl:servicename="PushHQ2CPService"><wsdl:portname="PushService"binding="intf:PushServiceSoapBinding"><wsdlsoap:addresslocation="2/pushhq/services/PushService"/></wsdl:port></wsdl:service></wsdl:definitions>WSDL文档:WebService描述语言（WebServicesDescriptinLanguage，WSDL）文档，用于描述该Webservice所提供的服务的结构（包括方法名称，参数类型，返回类型）