博文
中国移动MM7 API用户手册(七)(2006-06-20 09:22:00)
摘要：4.4 VASP接收状态报告（上行业务）
当VASP在发送MM7SubmitReq给MMSC时设置需要发送状态报告的请求为true时，MMSC在收到MM7SubmitReq后，会发送状态报告给VASP，此时VASP可以进行接收。接收方式和接收传送消息一样，也有两种方式：
4.4.1方式1：普通应用程序中的用法
public class MyReceiver extends MM7Receiver
{
public MM7DeliveryReportReq deliveryReportReq;
//Main方法
public static void main(String[]args)
{
//初始化VASP
MM7Config mm7Config = new MM7Config(“./config/mm7Config.xml”);
//设置ConnConfig.xml文件的路径
mm7Config.setConnConfigName(“../config/ConnConfig.xml”); //必备
//构造MyReceiver
MyReciever receiver = new MyReceiver();
receiver.setConfig(mm7Config); //必备
//启动接收器
receiver.start();
}
public MM7VASPRes doDeliveryReport(MM7DeliveryReportReq request)
{
/*接收从MMSC发过来的状态报告，以便得到一些有用信息，如MMSC的标识符等*/
deliver......
中国移动MM7 API用户手册(六)(2006-06-20 09:21:00)
摘要：4.3 VASP接收传送消息以及发送提交消息实例
举一个实例说明VASP构建MM7SubmitReq，发送给MMSC，并得到返回消息，通过StatusCode判断，本次发送是否成功，若成功，得到MessageID，以便以后希望取消或替换该消息时用。
public class MyReceiver extends MM7Receiver
{
//定义一个MM7DeliverReq，以便得到MMSC发过来的Deliver消息。（必备）
public static MM7DeliverReq deliverReq = new MM7DeliverReq();
//Main方法
public static void main(String[]args)
{
//初始化VASP
MM7Config mm7Config = new MM7Config(“../config/mm7Config.xml”);
//设置ConnConfig.xml文件的路径
mm7Config.setConnConfigName(“../config/ConnConfig.xml”); //必备
//构造MyReceiver
MyReciever receiver = new MyReceiver();
receiver.setConfig(mm7Config); //必备
//创建MM7消息发送接口
MM7Sender mm7Sender = new MM7Sender(mm7Config);
//启动接收器
receiver.start();
//接收MM7DeliverReq完毕，开始构造MM7SubmitReq
//有两种可能，一种是MM7SubmitReq完全由SP构造，另一种是SP用接收到的
//MM7DeliverReq的部分内容进行填充。
MM7SubmitReq submitReq = n......
中国移动MM7 API用户手册(五)(2006-06-20 09:20:00)
摘要：4.1.2 方式2：Web应用程序中的用法
public class MyReceiver extends MM7RecieveServlet
{
public MM7VASPRes doDeliver(MM7DeliverReq request)
{
System.out.println(“收到手机”+request.getSender()
+“提交的消息，标题为：”+request.getSubject());
System.out.println("MMSC的标识符为："+request. GetMMSRelayServerID()) ;
//SP需要进行一些处理，例如构建MM7DeliverRes消息，设置ServiceCode或StatusCode
MM7DeliverRes mm7DeliverRes = new MM7DeliverRes();
mm7DeliverRes.setServiceCode("服务代码"); //设置ServiceCode，可选
mm7DeliverRes.setStatusCode(MMConstants.RequestStatus.SUCCESS) ;/*设置请求完成状
态，必备，以便表明SP已经接收到传送消息。一般设1000。*/
mm7DeliverRes.setStatusText("所用状态文本说明"); /*设置所用状态的文本说明，
应限定请求状态，可选*/
//返回给MM7 API，以便API将MM7DeliverRes返回给MMSC。
return(MM7VASPRes)mm7DeliverRes;
}
}
4.2发送多媒体消息的过程（下行业务）
发送多媒体消息的过程就是使用MM7 API组织消息，并通过MM7Sender发送给MMSC的过程。主要步骤如下：
4.2.1准备......
中国移动MM7 API用户手册(四)(2006-06-20 09:18:00)
摘要：2.7递送报告
报告是接收方（终端）对接收到消息的处理方式信息。递送报告指MMSC在获取这个报告后把这个信息发送给发送方（SP）。接收方对消息的处理可能是接收或者拒绝等。处理流程如下：
l SP发送消息（通过MMSC）给终端，并且要求递送报告；
l 终端接收到消息后做相应处理（接收或拒绝）；
l MMSC把终端对消息的处理信息（递送报告）发送给SP。
3.安装方法
这里主要介绍一下如何将MM7 API运用到VASP自己开发的程序中以及在配置文件中需要注意修改的地方。
3.1 MM7 API的使用
在VASP用Java开发自己程序时，只要将中国移动集团公司提供的mm7api.jar和lib下的所有的Jar文件加入到classpath中即可。
3.2配置文件的设置
配置文件mm7Config.xml需要根据SP情况进行修改。
<?xml version="1.0"?>
<vasp:MM7Config xmlns:vasp="http://mms.chinamobile.com/mm7ConfigSchema">
<AuthenticationMode>1</AuthenticationMode>
<UserName>zxme</UserName>
<Password>zxme</Password>
<MaxMessageSize>100000000</MaxMes......
中国移动MM7 API用户手册(三)(2006-06-20 09:17:00)
摘要：2.3.2下行业务的业务代码规范
下行业务的业务代码为六位，其构成如下：
第1位：功能标识位，目前有如下两种选择：
l 1，代表一般下行业务
l 7，代表用于“先机时代”项目中手机内置并参与渠道分成的业务
l 6，代表用于集团客户应用的业务（免费）
其他数字目前保留。
第2位：彩信业务一级分类，具体如下面表格：
第3位：彩信业务二级分类，具体如下面表格：
一级分类及标识代码
二级分类及标识代码
新闻天气（1）
天气预报（1）
热点快讯（2）
社会新闻（3）
体育新闻（4）
娱乐新闻（5）
财经新闻（6）
综合新闻（0）
游戏娱乐（2）
聊天交友（1）
笑话幽默（2）
彩信游戏（3）
影音视线（4）
互动有奖（5）
五花八门（0）
时尚生活（3）
时尚有约（1）
车迷世界（2）
文化教育（3）
情感画廊（4）
爱情家庭（5）
两性健康（6）
证券财经（7）
位置服务（8）
五花八门（0）
卡通动漫（4）
欧美（1）
日本（2）
韩国（3）
港台（4）
本地原创（5）
五花八门（......
中国移动MM7 API用户手册(二)(2006-06-20 09:12:00)
摘要：1.概述
该文档说明了SP如何使用中国移动集团公司的MM7 API程序与彩信中心进行对接，实现MM7接口的通讯，开发增值业务应用。
该MM7 API是使用纯Java开发的，使用的JDK的版本为JDK1.4.0。所以使用该API进行开发时，要求使用的JDK版本必须是JDK1.4.0以上版本。该API所使用的通讯承载协议是HTTP/1.1。
缩略词：
MM： Multimedia Message （多媒体消息）
MMS： Multimedia Message Service（多媒体消息服务）
MMSC： Multimedia Message Service Center（多媒体消息服务中心）
VAS： Value Added Service（增值业务）
SP： Service Provider（业务提供商）
HTTP： Hypertext Transfer Protocol（超文本传输协议）
2.概念
2.1企业代码
企业代码是企业身份的标识，网络中地址翻译、计费、结算等均以企业代码为依据。企业代码的数据需要在MMSC和BOSS系统中进行配置。企业代码以数字表示，共6位，从“8XY000”至“8XY999”，其中“XY”为各移动分公司代码。
彩信全网业务的SP企业代码为8XY001－8XY999。（目前短信全网业务的企业代码为9XY001－9XY500，WAP全网业务的企业代码为9XY501－9XY999。）彩信地方业务的SP企业代码由各地方移动公司按照业务许可的顺序依次分配制定，“XY”具体分配情况见相关表格。
2.2服务代码
服务代码是：用户使用彩信的发送、上传等上行类业务时，需要输入的接收方号码；或SP在根据用户的点播请求在向用户发送、下载等下行类业务时，用户终端中显示的发送方的号码。服务代码的数据需要在MMSC上进行配置，用于路由的查找和状态报告的返回。服务代码以数字表示。
全国业务的服务代码长度统一为4位，即“1000”－“9999”；本地业务服务代码长......
中国移动MM7 API用户手册(一)(2006-06-20 09:07:00)
摘要：目 录
1.概述... 5
2.概念... 5
2.1企业代码... 5
2.2服务代码... 6
2.3业务代码... 6
2.3.1上行业务的业务代码规范... 6
2.3.2下行业务的业务代码规范... 8
2.4操作指令码... 10
2.5下行业务... 11
2.6上行业务... 11
2.7递送报告... 11
3.安装方法... 11
3.1 MM7 API的使用... 11
3.2配置文件的设置... 11
4.开发方法... 13
4.1 VASP接收传送请求（上行业务）... 13
4.1.1 方式1：普通应用程序中的用法... 13
4.1.2 方式2：Web应用程序中的用法... 14
4.2发送多媒体消息的过程（下行业务）... 15
4.2.1准备... 15
4.2.2创建待发送消息... 16
4.2.2.1 创建提交增值业务的多媒体消息（MM7SubmitReq）.. 16
4.2.2.2 创建取消多媒体消息（MM7CancelReq）.. 18
4.2.2.3 创建替换多媒体消息（MM7ReplaceReq）.. 18
4.2.3 创建消息内容体... 19
4.2.4 发送多媒体消息... 20
4.2.5发送MM7SubmitReq消息到移动终端实例... 20
4.3 VASP接收传送消息以及发送提交消息实例... 21
4.4 VASP接收状态报告（上行业务）... 24
4.4.1方式1：普通应用程序中的用法... 24
4.4.2方式2：Web应用程序中的用法... 25
4.5 VASP接收读后回复报告（上行业务）... 26
4.5.1方式1：普通应用程序中的用法... 26
4.5.2方式2：Web应用程序中的用法... 27
4.6 发送取消消息（下行业务）... 27
4.7 发送替换消息（下行业务）... 28
5.开发过程中需用的一些Status解释... 29
5.1 关于VASP接收到消息后设置返回响应（Res）的状态码及状态报告的解释... 29
5.2 关于VASP收到DeliverReq中MMStatus的解释... 30
5.3 关于VA......
中国联通wap规范（二）(2006-06-19 16:45:00)
摘要：1.4.2 返回连接规范
用户经常使用手机中的返回按键（通常就是删除按键）或者浏览器中的软按键来返回
或退出，因此，返回连接对一个业务的成功是十分关键的，要倍加关注，对返回连接设计
好的业务，将会显著地提高用户的使用次数。
1. 在业务的起始页面的底部必须有一个“返回江南秀”、“返回首页”的连接，地
址分别为：
http://211.90.224.195/hswap/index.aspx?NUMCUIGUID=22
http://http://wap.uni-info.com.cn
2. 在业务内部的页面底部必须有“返回上级”和“返回江南秀”的链接，可让用户
返回浙江本地栏目的连接。
3．除了在屏幕中显示“返回上级”及“返回首页”的标题外，同时也应利用软键
功能实现该功能，左右软键设置如下：
关于”返回上级”和”返回首页”的具体开发规范, 请查阅”联通WAP业务开发接口规范”.
4．当不能直接返回上一个页面时，将用户带到最方便使用业务的一层页面。返回连
接并不总是实用的，例如，当用户进行交易或者删除某些数据的时候，返回连接就不应该
将该用户再带到对交易或者删除操作进行确认的页面中，而应直接返回到业务的起始页
面，或将用户带到一个已经完成交易或删除操作的页面当中，可以使用一个<onevent
type=”onenterbackward”>来避免用户连接到不应返回的页面中。
3.当手机返回键的操作被替换时，如果在该页面上没有出现其他“确认“操作，务必
使用同样的操作替换“确认”软按键（左软按键）
如果对ACCEPT 软按键没有定义任何操作，那么该软按键就会被缺省定为一个带有“返
回”标签的返回操作，但如果手机上的返回按键的功能已经被修改，则左软按键上的返回
操作就会不同于手机上的返回键上的操作，这可能让用户感到很困惑，因此务必请将与手
（个人图片）
（图片下载）
（铃声下载）
(返回上级)
（返回首页）
确定 回首页
中国联通WAP 页面规范
中国联通浙江分公司增值业务部 10/15 Ver 1.0
机上的返回键对应的操作重新定义到左软按键上，比如：
<do ty......
中国联通wap规范（一）(2006-06-19 16:44:00)
摘要：1.1 目标
中国联通为了统一WAP业务风格，保证WAP业务的可用性，特制定了本WAP业务页面
规范，以规范中国联通的WAP业务页面风格。
本规范首先简述了WAP业务可用性的相关概念与原则，并对WAP业务中的菜单使用、
页面连接方式、文本显示、选择列表等多方面给出了相应的基本原则与例子。对通过中国
联通WAP门户网站提供连接或者遵循中国联通提供的代计费功能的WAP业务均要求严格
遵循本规范中的相关原则与规定。
1.2 业务可用性
可用性是业务提供的价值与用户使用业务时所需付出代价的相对大小，所谓业务提供
的价值，主要体现在业务能提供给用户所需要的信息，业务能为用户解决实际问题以及业
务的易用性等方面，使用业务的代价包括学习使用业务时付出的代价、用户使用业务过程
中付出的代价（比如通信费用、信息费用、点击次数，输入等）。
可用性强的业务，其最根本的特点是业务给用户带来的价值大于用户在使用业务时所
付出的代价，因此，在设计WAP业务时，应该注意到：
可用性非常关键；
手机上网主要用于获取信息而不是浏览；
手机与PC在使用上有显著差别，不能将开发WEB应用的理念照搬到WAP业务开发
中来；
用户是要为使用WAP业务付出时间上或金钱上的代价，因此，所设计的WAP业务
要尽降低用户在使用过程中付出的代价。
大多数用户并不喜欢复杂的WAP业务。
由此可见，当开发高可用性业务的时候必须首先明确：
面向什么样的用户群；
业务给用户解决什么问题；
如何以最高的效率解决这些问题。
1.3 联通WAP业务页面风格原则
基于提高WAP业务可用性的指导思想, 联通WAP业务的页面风格应遵循几个关键性
原则：
让用户尽快地得到需要的信息, 业务界面的学习门槛低;
将业务限制在基本的功能之内；
使开发出来的WAP业务简单易用；
业务应该具有一致的使用风格......
IVR流程开发规范(2006-06-19 16:36:00)
摘要：一． 主流程及配置文件的命名规则
1． 文件名为接入号：接入号.txt、接入号.bin
2． 如果一个业务有多个可执行流程，则命名为：
接入号-0.txt、接入号-1.txt；接入号-0.bin、接入号-1.bin
3． 相应的配置文件为：接入号.ini（在SCU\ini\下）
二． 流程中需要在配置文件中配置的内容
1． 所有语音播放路径，包括系统提示音以及根据《语音文件命名和目录规则》形成的各种语音文件的路径。
2． _SPID
3． 系统外呼流程号对应的字冠
4． 配置文件示例：12586XY(12590XYAB).ini
三． 强制使用的宏定义（常量），要求全部大写，多个英文单词之间用下划线隔开
1． 定时器时长：_TIMER
2． 子函数返回值
SUCCESS 0
EXECPTION 1
…
3． DataAccess超时时长：DATAACCESS_TIMEOUT
4． RecordVoice时长：REC_TIME
5． 取按键超时、出错，检查按键非法时的允许循环最大次数：ERR_NUMBER
四． 流程中的子函数及状态名称遵循......