MMC开发规范.docVIP

目 次 前 言 II 1 范围 1 2 规范性引用文件 1 3 术语与缩略语 1 4 开发方法 1 4.1 发送多媒体消息的过程（下行业务） 1 4.1.1 初始化配置参数 1 4.1.2 创建发送线程 1 4.1.3 构造待发送消息 2 4.1.4 发送消息 3 4.2 接收多媒体消息的过程（上行业务） 3 4.2.1 方式1：普通应用程序中的用法 3 4.2.2 方式2：WEB应用程序中的用法 3 4.3 流程图 4 4.4 代码样例 5 5 细节点击 9 5.1 递送报告 9 5.2 上行业务类型的区分 9 5.3 发送消息时返回状态码的含义 10 5.3.1 HTTP层返回状态码 10 5.3.2 SOAP接口的错误状态码及状态文本 10 5.4 对SP的计费方式 12 5.5 如何实现群发 13 5.6 消息内容体中的ID 13 5.7 标题的编码方式 13 5.8 文本内容的编码方式 13 5.9 目前主要使用的消息内容体格式 13 5.10 填充消息内容体时的注意事项 14 5.11 使用SMIL格式传输消息时的注意事项 14 5.12 上行业务处理方式的比较 16 5.13 日志 16 5.14 配置文件 17 附　录　A 19 前 言 本规范规定了多媒体消息业务应用的开发方法，为SP开发多媒体消息业务增值应用并将自己的内容与服务接入MMSC提供开发依据。 本规范暂定为试行版本，将来可根据市场发展需要和测试情况适时进行修订。 本标准附录A为API开发文档。 本规范主要起草单位：中国联合通信有限公司增值业务部。 本规范的修改和解释权属中国联通公司。 中国联通数字蜂窝移动通信网多媒体消息业务开发规范 范围 本规范适用于SP开发多媒体消息业务应用并与MMSC进行对接，以保证各SP通过标准的MM7接口将自己的内容与服务接入MMSC。 规范性引用文件 下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。 《中国联通数字蜂窝移动通信网多媒体消息业务体制》 《中国联通数字蜂窝移动通信网多媒体消息业务规范》 《中国联通数字蜂窝移动通信网多媒体消息业务中心设备技术要求》 术语与缩略语 企业代码：网络中SP公司地址和身份的标识。 服务代码：服务代码是在点播类业务中，提供给用户点播的内容/应用服务提供商代码。 业务代码：业务代码表示业务类别，由内容/应用服务提供商自己制定。 下行业务：由SP主动发起的业务，例如SP到点业务。 上行业务：SP被动接收的业务，例如点到SP业务。 递送报告：指接收方（终端）对接收到的消息的处理方式的信息，MMSC在获取这个信息后会把这个信息发送给发送方（SP）。接收方对消息的处理可能是接收或者拒绝等方式。 对于企业代码、服务代码和业务代码的详细说明参见中国联通现行规定。 开发方法 在所有的使用SDK开发的应用程序中，都要使用下面的语句把SDK中对应的class引入： import com.cmcc.mm7.vasp.pdu.*; import com.cmcc.mm7.vasp.message.*; import com.cmcc.mm7.vasp.service.*; import com.cmcc.mm7.vasp.conf.*; import mon.*; 发送多媒体消息的过程（下行业务） 发送多媒体消息的过程就是使用SDK组织消息并通过SDK的自身通讯机制发送给MMSC的过程，主要步骤如下，具体范例见4.4节。 初始化配置参数 使用MM7Config类初始化配置参数，参数为配置文件mm7Config.xml的路径： MM7Config mm7Config = new MM7Config( d:\mm7Config.xml); 创建发送线程 创建发送线程使用的是MM7Sender类，其中已经封装了和MMSC连接的通讯机制，创建MM7Sender的一个实例即可。 MM7Sender sender = new MM7Sender(mm7Config); 构造待发送消息 创建待发送消息使用的是消息的实体类：MM7SubmitReq、MM7CancelReq和MM7ReplaceReq，主要设置的就是消息的标题、消息类型、是否需要递送报告、添加接收发地址、设置消息体内容等。下面以MM7SubmitReq为例，说明如何构造消息。 1、创建消息对象： MM7SubmitReq req = new MM7SubmitReq(); 2、设置消息各种属性： req.setVASPID(1111