中国联通数字蜂窝移动通信网WAP业务CPSP业务开发规范.doc

中国联通公司发布2006-04-××实施2006-04-××发布中国联通数字蜂窝移动通信网WAP业务CP/SP业务开发规范（V1.0）CP/SP Service Development Specification of WAP Service on China Unicom Digital Cellular Mobile Communication Network（Version 1.0）QB/CU ×××2006中国联通公司企业标准目 次目 次I前 言III中国联通数字蜂窝移动通信网WAP业务CP/SP业务开发规范11 范围12 规范性引用文件13 定义与缩略语13.1 定义13.2 缩略语14 WAP1.2业务CP/SP业务开发方法14.1 CP/SP业务接入方式14.1.1 业务接入14.1.2 GPRS WAP下载类业务规范24.1.3 CDMA WAP下载类业务规范34.2 接口规范34.2.1 HTTP数据访问接口34.2.1.1 接口描述34.2.1.2 发起方34.2.1.3 接收方34.2.1.4 接口方式34.2.1.5 接口参数34.2.2 返回上级接口44.2.2.1 接口描述44.2.2.2 发起方44.2.2.3 接收方44.2.2.4 接口方式54.2.2.5 接口参数54.2.3 CP/SP业务定制/退定消息通知接口54.2.3.1 接口描述54.2.3.2 发起方54.2.3.3 接收方54.2.3.4 接口方式54.2.3.5 接口格式5 WAP PUSH接口（暂不提供）74.2.474.3 页面开发规范74.3.1 菜单使用规范74.3.1.1 菜单用途74.3.1.2 菜单使用规范74.3.2 免费试用链接规范114.3.3 返回链接规范124.3.4 页面技术指标134.3.5 文本显示规范134.3.6 用户输入规范144.3.7 格式化输入规范144.3.8 关键词语使用规范154.3.9 注册与认证164.3.10 图标与图形规范164.3.11 铃声、动漫规范164.3.12 业务放置位置164.3.12.1 页面设计基本原则174.3.12.2 页面设计细节174.3.13 CACHE规范194.3.14 手机适配19前 言本规范是中国联通数字蜂窝移动通信网WAP业务系列规范之一，该系列规范的预计名称及结构如下：中国联通数字蜂窝移动通信网WAP业务规范中国联通数字蜂窝移动通信网WAP业务设备规范中国联通数字蜂窝移动通信网WAP业务测试规范中国联通数字蜂窝移动通信网WAP业务CP/SP业务开发规范本规范将根据业务开展情况与市场发展需要适时进行修改。本标准主要起草单位：中国联通增值业务部，信息产业部电信传输研究所本标准主要起草人： 梁鹏、刘煜、崔媛媛、刘东明本标准的修改和解释权属中国联通公司。中国联通数字蜂窝移动通信网WAP业务CP/SP业务开发规范1 范围本标准规定了中国联通数字蜂窝移动通信网WAP业务开发中的页面开发要求、页面技术技术、接口要求。本标准适用中国联通各级机构和CP/SP（内容/服务提供商）通过中国联通数字蜂窝移动通信网WAP门户站点向用户提供各类WAP1.2服务。2 规范性引用文件下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。中国联通移动数据增值业务系统信息与接口编码规范CDMA 1X数据业务支撑技术规范CDMA 1X WAP业务规范3 定义与缩略语3.1 定义本规范使用下列定义：页面：每一次请求，所得到的显示内容。菜单：栏目列表。栏目：菜单中某一类服务的名称。栏目标题：显示内容的页面顶端显示的内容标题。菜单列表：指列表条目将包含下级列表。内容列表：内容列表不包含下级列表，下级将是内容实体。3.2 缩略语本规范使用下列缩略语：WAPWireless Appliecation Protocol无线应用协议MDNMobile Directory Number移动电话号码簿号码SOAPSimple Object Access Protocol简单对象访问协议PAPPush Access ProtocolPush访问协议4 WAP1.2业务CP/SP业务开发方法4.1 CP/SP业务接入方式在中国联通移动通信网络上提供WAP业务服务， CP/SP接入本平台需要向中国联通提交接入申请，CP/SP的应用服务器可以通过互联网或者直接通过局域网、以及VPN和专线方式与中国联通的WAP平台系统相连接。4.1.1 业务接入如果CP/SP的接入申请经过中国联通审核接入了WAP平台系统，就可以提交业务申请， 当CP/SP提供一个业务的时候，在提供该业务的资费策略和优惠信息的同时，由于WAP平台系统是基于URL的内容计费， 因此CP/SP在接入业务之前需要提供该业务如下参数：表1 业务接入参数参数名称参数举例用途描述业务入口URLhttp:/业务的入口URL。计费URL收费服务标识对应收费URL，如果用户访问此URL，需要收费。确认URL表示访问此URL时，系统会弹出计费信息供用户查看和选择。对于各个URL的规定如下：1. 对于相同的业务，各个URL都不能重复。2. 对于不同业务接入，各个URL都不能重复，也不能互相包含。3. 确认URL必须在入口URL之后，确认URL和计费URL不能重复。例如：财经新闻服务有目录索引文件 当用户进入计费URL时CP网关会自动判断用户是否订购了此SP的此种业务，如果订购了则让用户进行访问并按照订购策略对用户计费；如果用户没有订购此项业务则将用户请求转至订购页面，WAP平台系统会弹出所有用户可订购的产品供用户查看和选择，用户可以选择是采用按次还是包月的计费方式。定制之后用户才可以查看新闻内容。如果确认URL取为：中国联通WAP系统只处理80端口，CP申请接入的业务必须使用80端口。不允许出现业务内容对应的URL为其他端口的情况。4.1.2 GPRS WAP下载类业务规范在GPRS网络中，由于终端条件的限制，对于下载类业务只能采用标准的HTTP GET方式进行下载，没有办法判断此次下载内容是否成功传输到终端，对于下载计费内容，CP/SP应该在其下载URL中包含计费URL，当用户点击计费内容时业务系统即开始计费。同时，CP/SP在开展此类业务时应遵循以下规定：1、CP/SP需保证下载服务器及传输链路的稳定性，提高用户下载的成功率。2、CP/SP必须要根据用户终端对下载铃声图片进行适配。3、当用户点击图片名称后，应显示图片的缩略图，让用户初步预览图片，不允许直接下载图片到用户的手机上。仅当用户满意图片，点击“下载”链接后，才允许进行实际的图片下载并计费。4、在按次下载计费的情况下，用户点击预览页面中的“开始下载”链接，即计费。计费后的页面提供“开始接收”链接，用户点击“开始接收”后开始正式下载（“开始接收”的操作也可自动实现）。5、必须提供免费重新下载链接，可以让用户在下载失败后免费重新下载。4.1.3 CDMA WAP下载类业务规范对于下载类业务，CP/SP需要向中国联通申请该类服务，并提交下载内容服务器的主域名或IP地址给中国联通，由中国联通审核能否向CP/SP所提供的服务的主域或IP地址提供下载类服务权限，并在Openwave download fun server中进行相关控制配置。在填写Download的地址中的source时要后跟下载目标的实际URL。例如：<a href="uplink:download?source=http:/uniinfo.U有关Download Fun更多内容请参考Openwave Download Fun公开技术规范，或者访问：获取更多信息。4.2 接口规范4.2.1 HTTP数据访问接口4.2.1.1 接口描述实现对SP发送过来的HTTP响应包的接收，转发WAP网关请求的HTTP请求包给SP。本接口内容项主要描述WAP业务系统之间，需要通过HTTP包头传递的附加信息。如：用户标识等。该接口主要解释CP/SP在作业务接入后：（1）取得用户的手机号码（公开的手机号码、加密的手机号码）：加密的手机号码，与手机号码一一对应，由中国联通WAP业务平台向CP/SP Server（主域或IP地址）传送加密手机号码，CP/SP Server获取该加密手机号码的方法为：在每次用户发送的请求http header中取“deviceid”。公开的手机号码：中国联通WAP业务平台向CP/SP Server（主域或IP地址）传送公开的手机号码，CP/SP Server获取该公开手机号码的方法为：在每次用户发送的请求http header中取“x-up-calling-line-id”。（2）取得用户手机的User Agent: 无线数据网络上的应用种类很多，其中的一些应用需要特定的终端来支持，终端信息是对终端能力的描述，包括终端支持的业务类型、每一种业务的具体参数（例如屏幕的大小）等等。CP/SP直接在http header中取“user-agent”。4.2.1.2 发起方SP（对应答包而言）；WAP业务系统（对请求包而言）；4.2.1.3 接收方WAP业务系统（对应答包而言）；SP（对请求包而言）4.2.1.4 接口方式HTTP/1.1、HTTP/1.04.2.1.5 接口参数通讯采用HTTP协议，通过HTTP Header中传递信息。这些HTTP Header可以分为两类：第一类：标准的Http Header。user-agent: Nokia6600/1.0 (3.38.0) Symbian7.0s /*user-agent标识手机终端类型*/accept: application/vnd.wap.wmlc, application/vnd.wap.wmlscriptc, image/vnd.wap.wbmp, image/bmp, image/png, image/sis, audio/midi, audio/imelody, application/vnd.phonecom.mmc-wbxml, application/octet-stream, application/vnd.wap.sia, application/vnd.wap.sic, application/vnd.wap.slc, application/vnd.wap.connectivity-wbxml, application/vnd.wap.wbxml, image/bmp,image/vnd.wap.wbmp,application/vnd.phonecom.mmc-xml,text/x-wap.wml,text/vnd.wap.wml,text/x-hdml,text/vnd.wap.wmlscript,text/vnd.wap.si,text/vnd.wap.sl,text/vnd.wap.connectivity-xml, */*connection: closeaccept-charset: utf-8, UTF-8, *host: 211.157.1.197accept-language: en, zh-cnencoding-version: 1.3cache-control: max-age=259200via: 1.1 hswapshbg3:3128 (Squid/2.3.STABLE3), 1.0 hswapshbg3:81, 1.0 hswapjsdb:81第二类：自定义Header。x-up-devcap-max-pdu: 4096x-up-wappush-secure: :9003/papx-up-uplink: gatewaysh.uni-deviceid: 011207610E362D6DBAFF1646967/*deviceid：长度为27位，前3位为中国联通省分代码，后24位为加密的手机号*/x-up-bear-type：GPRS/CDMA/* x-up-bear-type：标示业务承载的网络类型，GPRS网用户填为GPRS，CDMA用户填CDMA*/x-up-fax-accepts: text/plain, application/postscript, application/msword, application/rtf, application/pdfx-up-wtls-info: offx-up-devcap-charset: utf-8x-up-wappush-unsecure: :9002/papx-up-fax-encodings: 7bit, 8bit, base64, quoted-printablex-up-subno: MMS-501454_gatewaysh.uni-x-forwarded-for: 10.75.10.199, 10.95.17.75, 10.95.17.132, 10.74.1.199/*x-forwarded-for：包含手机端IP*/x-up-fax-limit: 100000x-up-calling-line-id: 8613012345678/* x-up-calling-line-id：公开的手机号，加86 。/4.2.2 返回上级接口4.2.2.1 接口描述该参数决定CP/SP业务的一级页面返回其在具体的WAP Portal中的栏目的上级页面。中国联通VASP平台会自动向CP/SP Server传送参数，CP/SP的程序中应该记录并判断此参数。CP/SP需要建立PortalID和总部portal和地方Portal的对应关系表，同时由CP/SP维护PortalID和各Portal间的对应关系表。4.2.2.2 发起方CP/SP业务系统4.2.2.3 接收方WAP平台4.2.2.4 接口方式HTTP4.2.2.5 接口参数取得业务/栏目返回上级的PT参数：参数由两部分组成，以冒号“:”分隔，前一部分为PortalID，通过此ID决定CP/SP业务返回的首页和应该返回哪个Portal的页面；后面一部分为栏目ID，决定返回到哪个具体的栏目页面。通过PortalID找到返回的URL（Dir取值前面的URL部分），举例如PortalID=2：对应总部http:/wap.uni-因此，根据PortalID，就可以获得Portal的URL，而栏目ID则作为参数Dir的值；这时，CP/SP需要取PT参数中“冒号”后面的值作为Dir的值；GPRS网WAP Portal PT取值为800，CDMA网WAP Portal PT取值参见下表：名称URLPT值互动世界（北京大区）http:/wap.uni-2互动世界（上海大区）http:/wap.uni-3互动世界（广东大区）http:/wap.uni-4互动世界（重庆大区）http:/wap.uni-6互动世界（浙江大区）http:/wap.uni-9互动世界（山东大区）http:/wap.uni-8互动世界（江苏大区）http:/wap.uni-7互动世界2.0（北京大区）http:/wap.uni-12LBS门户（北京大区）http:/wap.uni-9例如：当CP/SP获得的参数为：PT=800: 10000000000011那么，则表示G网Portal，返回上一级的URL就是：http:/wap.uni- 10000000000011。4.2.3 CP/SP业务定制/退定消息通知接口4.2.3.1 接口描述WAP系统将用户定制/退定业务通知给CP。当 WAP手机用户通过中国联通综合增值业务管理平台上定制或者退定CP/SP的某一个业务时，中国联通综合增值业务管理平台将准实时（10分钟）通知CP/SP的应用服务器该用户的定制或者退定信息。其中中国联通综合增值业务管理平台需要负责提供CP/SP在平台中的代码，以及CP/SP的各业务代码；CP/SP需要提供执行该接口功能的URL。4.2.3.2 发起方总部WAP平台4.2.3.3 接收方CP/SP业务系统4.2.3.4 接口方式HTTP POST4.2.3.5 接口格式4.2.3.5.1 定制服务XML Format:request:<webmethod id=”service_order_to_cp”><cpcode value=”<xxx>”/><userid value=”<23424>”/><encryptflag value=”<y|n>”/><serviceid value=”<news>”/><!下面ProductID字段为新增，通知SP用户订购的具体产品 -><Productid value=”400123456789”/><ispack value=”<Y|N>”/><sub_type value=”<month|per_hit|day>”/><orderdate value=”2003-01-01 23:59:01” /></webmethod>response:<webmethod id=”service_order_to_cp”><result status=”<0|1>”/></webmethod>4.2.3.5.2 退定服务XML Format:request:<webmethod id=”service_disorder_to_cp”><cpcode value=”<xxx>”/><userid value=”<23424>”/><encryptflag value=”<y|n>”/><serviceid value=”<news>”/><!下面ProductID字段为新增，通知SP用户退订的具体产品 -><Productid value=”400123456789”/><ispack value=”<Y|N>”/><sub_type value=”<month|per_hit|day>”/><disorderdate value=”2003-01-01 23:59:01” /></webmethod>response:<webmethod id=”service_disorder_to_cp”><result status=”<0|1>”/></webmethod>说明：1 Cpcode value：表示CP/SP在中国联通VASP平台中的代码。2 Userid value：手机号码。3 Encryptflag value：手机号码是否加密。4 Serviceid value：表示CP/SP在中国联通VASP平台中的业务或优惠套餐代码。5 ProductID value：表示用户具体订购和退订的某一服务下的具体产品代码6 Ispack value：表示以上serviceid是否优惠套餐。7 Sub_type value：表示用户定制或者退定的是哪种计费方法，month表示包月计费，per_hit表示按次计费，day表示按栏目（包天计费）。8 Orderdate value：表示定制时间。9 Disorderdate value：表示退定时间。Result status：表示CP/SP应用服务器是否成功处理收到的信息，0表示成功，1表示失败，当失败的时候，中国联通VASP平台会在下次发送消息的时候从新发送该条信息。4.2.4 WAP PUSH接口（暂不提供）4.3 页面开发规范4.3.1 菜单使用规范4.3.1.1 菜单用途菜单的用途一般有：w 提供一个数据列表（如邮件地址）w 连接到一个新的页面（如进行选择）w 进行一项操作（如删除邮件）w 进行一个选择（如选择一个具体的日期）w 改变某个选项（如让用户更改设置）4.3.1.2 菜单使用规范菜单分为导航类菜单和服务类菜单。导航类菜单指导用户进入下一级目录，点击导航类菜单后不会出现具体的内容，而是后面跟下一级菜单。服务类菜单直接指向内容，点击服务类菜单后直接出现该菜单所指示的图片、铃声等内容。对导航类菜单和服务类菜单的要求如下：1 菜单项要一致左对齐排列；缺省情况下，菜单内每一个栏目占据一行，但在特殊情况下允许同一行中使用多个栏目；2 菜单中的各项要按照一定的逻辑顺序来排列，如按照类型、时间、字母顺序等。如果没有逻辑顺序，就按优先级排列，将最可能选择的排在最前面。3 在一个导航类菜单前必须加彩色图标。在服务类菜单前要加数字排序，两类菜单的定义如下图： 图1 导航类菜单：后跟下一级菜单 图2 服务类菜单：后跟实际内容4 服务类菜单中不要多于9个选项，当选项多于9个时，建立“下一页”作为第九个选项，如图2所示。具体要求如下：导航菜单项前的图标要求如下：尺寸：25x15 pixle文件类型：PNG大小：小于1K支持色彩：真彩色5 菜单标题字数尽量控制在一行显示，标题超出一行时，优先选择向左滚动显示，若终端无法实现滚动显示，则将超出内容另行显示；建议不要超过三行。6 缺省的情况下，菜单中的每一项占据一行，但是在特殊情况下， 允许在同一行中使用多个菜单项。通过在各个菜单项之间添加一个标点符号（例如，链接1，链接2）或其他文字，不同的链接就可被并排显示，但如果这些链接是被定义在一个<p mode=”nowrap”>块中，那么它们就不能被并排显示了，例如：<?xml version=”1.0” encoding=”GB2312” ?><wml><card id=”quote” title=”AA 股票”><onevent type=”onenterforward”><refresh> <setvar name=”price” value=”+2.875”/><setvar name=”icon” value=”uparrow2”/></refresh></onevent><do type=”options” lable=”Done”><exit><send value=”$stork”/><send value=”$(price-)”><send value=”$icon”/> </exit></do><p><br/><a href=”nothing.wml” title=”News”>$stock<img src=” localsrc=”$icon” alt=”/>+2.875</a><br/>现价：115.875<br/>最高价：116.875<br/>最低价：112.5<br/>成交：20405400<br/>10:14 3/1/2000<br/>其他股票信息：<a href=”nothing.wml”>BB</a>,<a href=”nothing.wml”>CC</a>,<a href=”nothing.wml”>DD</a><a href=”nothing.wml” title=”图表”>图标显示</a><a href=”nothing.wml” title=”加入”>加入到</a> </p></card></wml>在上面的例子中，逗号用来分割不同股票的查询连接，以便并排显示。7 如果需要在一个菜单项（或软按键）上执行多个操作，可以通过弹出式菜单实现，如图3所示。为了让多个操作在一个菜单项上执行，需要将select（选择）要素的type（类型）属性设置为list（列表）。例如，为了让用户在没有阅读电子邮件的情况下对其进行删除、转发或回复等处理，对每一个<option>指定value性，通过<do type=”option”>来实现：图3 弹出式菜单<?xml version=”1.0” encoding=”GB2312” ?><wml><card title=”收件箱” id=”inbox”><onevent type=”onenterforword”><refresh><setvar name=”imgA” value=”*”/><setvar name=”imgB” value=”*”/><setvar name=”imgC” value=”*”/><setvar name=”imgD” value=”*”/></refresh></onevent><do type=”accept” lable=”查询”><spawn href=”email/mail$(msg.noesc)”><catch/></spawn></do><do type=”options” lable=”删除”><go href=”file:c:/opwvdemo/notjing.wmlc”/></do><do type=”options” lable=”回信”><spawn href=”#reply$(msg.noesc)”><catch/></spawn></do><do type=”options” lable=”转发”><spawn href=”emailfwd.wmlc#fwd$( msg.noesc)”><catch/></spawn></do><do type=”options” lable=”保存”><spawn href=”saved.wmlc#saved$( msg)”/></do><do type=”options” lable=”转移到”><spawn href=”file:c:/opwvdemo/nothing.wmlc”/></do><do type=”options” lable=”邮件首页”><spawn href=”#home”/></do><do type=”options” lable=”新建信笺”><spawn href=”emailedit.wmlc”><catch/></spawn></do></do><p mode=”nowrap”><select type=”list” name=”msg”> <option value=”1”> <onevent type=”onpick”> <spawn href=”email.wmls”> <catch/> </spwan> </onevent>张三你想去看电影吗？</option><option value=”2”><onevent type=”onpick”><spawn href=”email2.wmlc”><catch/></spawn></onevent>李四会议时间改到3:30pm</option><option value=”3”><onevent type=”onpick”><spawn href=”email3.wmlc”><catch/></spawn></onevent>王五会议通知</option><option value=”4”><onevent type=”onpick”><spawn href=”email4.wmlc”><catch/></spawn></onevent>赵六给我回电话</option></select>参看：<select name=”fldr” type=”popup” value=”Inbox”><option value=”file:c:/opwvdemo/nothing.wmlc”>收件箱</option><option value=”#outbox”>发件箱</option><option value=”file:c:/opwvdemo/sent.wmlc”>发送</option><option value=”/nothing.wmlc”>模板</option></select></p><p align=”center”> <do type=”button” lable=”转移到”> <go href=”$(fldr:noesc)”/></do></p></card></wml>注意：同一个菜单项在不同的手机上显示并不一样，多数手机对菜单项会加入下划线，也有的手机会使用正方形与括号将选项包起来，因此，不要在显示文本的时候使用下划线等标志。4.3.2 免费试用链接规范免费试用链接的功能是，让用户在支付信息费前先对业务有个比较清楚的认识和了解，然后再根据自己的兴趣爱好来决定是否购买和使用。免费试用链接符合用户的购买习惯，能较大程度地保护用户的合法利益。免费试用栏目的具体要求：一、总体要求1、正式业务中必须在首页首位提供免费内容链接，并且统一标识为“免费试用”。2、正式业务中的免费内容中不可以提供对应的收费业务链接。二、各类型业务具体要求如下：1、浏览类业务要求此类资讯类业务要求必须在业务首页首位增设免费栏目，必须明显明示“免费体验”字样。栏目内信息不少于5条，更新频率为一周。若业务属图片浏览或下载类，在免费栏目中需提供图片不少于3张。2、下载类业务要求必须在业务首页首位增设免费栏目，必须明显明示“免费体验”字样，栏目内图片或铃声数量不小于3个。免费栏目内容更新频率保持在一月左右。3、交互类业务要求游戏、聊天等交互类业务应该提供免费内容供用户免费体验。所有免费体验信息必须明显标注。4.3.3 返回链接规范用户经常使用手机中的返回按键（通常就是删除按键）或者浏览器中的软按键来返回或退出，因此，返回连接对一个业务的成功是十分关键的，要倍加关注，对返回连接设计好的业务，将会显著地提高用户的使用次数。1在业务的起始页面的底部必须有“返回上级”及“返回首页”的连接。2在业务使用中的页面底部必须有“返回上级”及“返回首页”的连接；允许设立“返回栏目”的连接。 3除了在屏幕中显示“返回上级”及“返回首页”的标题外，同时也应利用软键功能实现该功能，左右软键设置如图4所示：4应利用软键功能实现“返回上页”，或者通过“C”键实现“返回上页”功能。图片下载铃声下载屏保动画音乐动画返回上级返回栏目返回首页确定 回首页图4 返回上级及左右键的设置注： 返回上级：指返回上一级页面返回栏目：指返回栏目列表返回首页：指返回用户登录的首页返回上页：指返回用户之前浏览的页面4当不能直接返回上一个页面时，将用户带到最方便使用业务的一层页面。返回连接并不总是实用的，在需要动态交互数据的业务中，当用户进行交易或者删除某些数据的时候，返回连接就不应该将该用户再带到对交易或者删除操作进行确认的页面中，而应直接返回到业务的起始页面，或将用户带到一个已经完成交易或删除操作的页面当中，可以使用一个<onevent type=”onenterbackward”>来避免用户连接到不应返回的页面中。5手机返回键（“c”键