产品云mas-2019-10-3117 9

1、 云 MAS 平台 SDK.MMS 1.0（JAVA 版）用户手册作者： 中国移动通信政企客户分公司 完成日期： 2014-9-15签 收 人： 签收日期： 1云 MAS 平台 SDK.MMS 开发说明1.1简介mascloud.sdk.mms-0.0.1-SNAPSHOT.jar1.2背景系统名称：云 MAS 平台项目开发者： 中国移动通信集团政企客户分公司1.3环境服务器具有直连访问互联网的能力。2数据结构说明2.1.1 彩信实时报告数据结构 类型：Map 用途：用于内部，跟踪彩信提交给 MAS 系统，MAS 处理后返回的响应。 （说明：指 API 提交给云 MAS 的报告，报告由云 MA

2、S 收到 API 提交请求后发出） 2.1.2 彩信状态报告数据结构 类型：MM7DeliverReq 用途：保存状态报告接口函数返回的内容，由网关服务器主动推送给 VASP 的状态报告。（说明：云 MAS 提交给行业网关，行业网关返回的报告，云 MAS 透传给 API） 字段名 数据类型 说明 MMSRelayServerID String 彩信网关服务器 ID 字段名 数据类型 说明 RET_CODE String 提交报告代码 RET_MSG String 提交报告描述 2.1.3 彩信提交报告数据结构类型：MM7RSRes 用途：保存发送服务提交给网关，网关返回给发送服务的响应。（说明

3、：网关发送短，彩信成功或者失败的状态返回给发送服务） 3 功能介绍及使用3.1.1 实例化客户端功能简介 SDK 客户端的构造方式,实例化客户端MmsClient 类后即可通过该实例调用彩信发送等函数. 字段名 数据类型 说明 StatusCode String 状态号码 StatusCodeExist boolean 是否存在状态报告 StatusText String 状态文本 StatusTextExist boolean 是否存在状态文本 StatusDetail String 状态详细 StatusDetailExist boolean 是否存在状态详细 MessageID Stri

4、ng 状态报告描述 Recipient String 接收人（手机号码） Sender String 发送方（SP 服务代码） TimeStamp Date 接收时间 MMStatus Byte 状态 StatusText String 状态文本 实例化函数 final MmsClient mmsBuilder = MMSBuilder.get类型： 静态函数（获取 mmsBuilder 单例） 代码演示 tance(); boolean islogin = mmsBuilder.login(3/app/sdk/log 123,信息测试 3);/ Mas 网站登

5、录鉴权 if(!println(登录鉴权失败！); return; dk1,3.1.2 彩信发送功能介绍 彩信发送函数,调用该函数会即时的下发彩信，支持无模板立即发送，无模板定 时发送，有模板立即发送，有模板定时发送，支持 smil 文件发送。1. 构造无模板立即发送mm7 Public Map createMM7 (String subject,String mobiles,String signa) 2. 构造无模板定时发送mm7 Public Map createMM7 (String subject,String mobiles,String signa，Date timer) 3.

6、构造有模板立即发送mm7 Public Map createMM7 (String subject,String mobiles,String signa,String tempId) 4. 构造有模板定时发送mm7 Public Map createMM7 (String subject,String mobiles,String signa,Date timer,String tempId) 5. 发送smil文件 public Map sendSmil(String subject, String to, String signa, String smilLocation) 参数详解参数

7、名称 说明 subject 彩信主题 to 数组形式，多个手机号码发送 signa 网关签名编码，必填，签名编码由企业在中国移 动集团开通帐号分配。 timer 定时发送时间 指定时间格式为 YYYY-MM-DD HH24:MM:SS tempId 模板编号(由 EC 提供模板 ID 世界唯一编码) smilLocation ZIP 包路径 代码演示立即发送，无模板MM7 mm7 = mmsBuilder.createMM7(立即发送，无模板, new Strin uXT4cWKQ); bytebytebytebytetext = null;/文字的字节数组image

8、 videoaudio=null;/图片的字节数组null;/视频的字节数组 null;/音频的彩信测试字节数组/添加彩信帧（10秒），参数为每个帧在手机终端的运行时间 /添加文字，参数为文字字节数组mm7.addFrame(10).addText(text).addImage(image); /新增一帧（20秒），设置视频，参数为视频的字节数组 mm7.addFrame(20).addVideo(video); 执行彩信发送，实时返回RET_CODE,RET_MSG MmsMessager mmsMessager = (MmsMessager)mm7; Map status = mmsBui

9、lder.getMasClient().send(MasClient.MMS_TOPIC, mmsMessager,MasClient.MMS_RE_TOPIC); System.out.println(RET_CODE:+status.get(RET_CODE).toString()+RET_MSG:+status.get(RET_MSG).toString(); 定时发送，无模板MM7 mm7 = mmsBuilder.createMM7(立即发送，无模板, new Strin uXT4cWKQ); bytebytebyteimagevideo audio=nul

10、l;/图片的字节流null;/视频的字节流 null;/音频的彩信测试字节流mm7.addFrame(10).addText(我用SDK发送了图片和视频).addImage(new MM7Sample().getResources(resource/thirdImage.gif); mm7.addFrame(10).addVideo(new MM7Sample().getResources(resource/mov_bbb.3gp); 执 行 彩 信 发 送 ， 返 回 RET_CODE,RET_MSG MmsMessager mmsMessager = (MmsMessager)mm7; M

11、ap status = mmsBuilder.getMasClient().send(MasClient.MMS_TOPIC, mmsMessager,MasClient.MMS_RE_TOPIC); 立即发送，有模板MM7 mm7 = mmsBuilder.createMM7(我用SDK发送模板彩信, new StrinuXT4cWKQ, 30f531a3-7aab-4fde-a44d-29e2f4e02129); 定时发送，有模板 MM7 mm7 = mmsBuilder.createMM7(20180925-SDK 定 时 发 送 有 模 板 , new Str

12、inuXT4cWKQ,sdf.parse(2014-09-2813:30:30),30f531a3-7aab-4fde-a44d-29e2f4e02129);发送 smil 文件String smillocation = E:smilsmil.zip;/zip 包路径 Map status = mmsBuilder.sendSmil(sdk发送彩信测试, new Strin18271400641, uXT4cWKQ,smillocation); System.out.println(RET_CODE:+status.get(RET_CODE)

13、+RET_MSG:+status.get(RET_MSG); 注意： 1.MM7 为构造彩信的对象，mm7 中可以添加多媒体元素，但是视频不能和图片共存， 也不能和音频共存，否则会报异常 当选择使用模板发送的时候，不能再为 mm7 添加多媒体，否则报异常 调用send 方法返回的status 为Map 类型对象，是发送 mm7 返回的实时的提交报告。Smil 文件中 src 对应的文件命令不要包含中文字符，否则解析失败Zip 包中的文件，要与 smil 文件中 src 对应的文件要一一对应 调用接口前，最好对所有变量做非空验证 .3.1.3 获取提交报告,状态报告,上行彩信 实时

14、报告：当 Map status =mmsBuilder.sendSmil(String subject, String to,Stringsigna, String smilLocation);提交报告：当彩信经过发送服务提交给网关，网关返回提交报告 List statussumit = mmsBuilder.getSubmitReport();状态报告：网关发送短，彩信成功或者失败的状态返回给发送服务List statusReports = mmsClient.getReport();获取状态报告后根据状态报告文本查询 MM7 彩信发送状态码（附录） 上行彩信：List deliver =

15、mmsClient.getMO();3.1.4 状态报告返回码SDK 给 MAS 提交，MAS 返回的报告:返回值 描述 MM1001 彩信主题为空 MM1002 彩信内容为空 MM1003 定时发送时间不能小于当前时间 MM1004 手机号码不合法 MM1005 手机号码位于黑 MM1006 存在重复的手机号码 MM1007 最多不能超过 200000 号码发送 MM1008 手机号码不是字符串数组 MM1009 网关签名为空 MM1010 通道不可用，或者签名错误 MM1011 无异网通道,不支持异网发送 MAS 提交网关，返回提交报告: 状态码（RET_CODE） 状态文本(RET_MS

16、G) 1000 成功; 1001 部分成功; 2000 客户机错误; 2001 操作受限; 2002 地址错误; 2003 找不到地址; 2004 多媒体内容被拒绝; 2005 找不到消息 ID; 2006 找不到链接 ID; 2007 消息格式破坏; 3000 服务器错误; 3001 不可接受; 3002 消息被拒绝; 3003 不支持多个地址; MM1012 彩信模板 ID 错误或者不存在 MM1013 您使用的模板未通过审核！ MM1014 成功提交至彩信发送内存队列 MM1015 JMS 链接异常 MM1016 EC 侧可能已经删除该彩信，发送失败 MM1017 解析 ZIP 包失败

17、MM1018 手机号码存在空字符串 MM1019 彩信过大，需限制在 90k 以内 MM1020 smil 文件路径在 ZIP 包中找不到对应的文件 -100 系统错误 -101 超时发送失败 -102 接受失败 -103 没有返回正确的消息 -104 SOCKET 不通 -105 待发送的消息为空 -106 发送消息不正确 -107 接收消息为空 -108 Bad Request； -109 XML 解析错误 -110 Server Could not fulfill the request -113 消息内容的尺寸超出允许发送的大小 网关 MMSC 返回 VASP 的状态报告:4.1 常见问题1. 一个 SDK 账号可以