MAS2.0JAVAAPI接口插件开发手册.

《MAS2.0JAVAAPI接口插件开发手册.》由会员分享，可在线阅读，更多相关《MAS2.0JAVAAPI接口插件开发手册.（38页珍藏版）》请在装配图网上搜索。

1、中国移动通信CHINA MOBILE中国移动代理服务器 MAS V2.0 JAVA API接口开发手册中国移动代理服务器 MAS V2.0JAVA API接口插件开发手册 Bs嘉讯软件 Jasnsonsoft深圳市嘉讯软件有限公司2008年9月目录1. 引言41.1. 编写目的41.2. 背景说明41.3. 相关术语与缩略语解释 42. API结构说明43. 运行环境54. 开发步骤54.1. 在Mas服务器新建一个企业应用 54.2. 启动企业应用64.3. 开发时需要引入的包 64.4. 接口开发及使用举例 64.4.1. APIClient 工厂类-ApiClientFactory 类7

2、4.4.1.1. 创建短信 API 客户端-createSmsApiClient 方法74.4.2. 短信接口 74.4.2.1. 短信API客户端主要操作类 -SmsApiClient类74.4.2.1.1. 设置自动重连服务器 -setTimingConnect方法 74.4.2.1.2. 设置自动重连服务器相隔时间 -setConnectTime方法74.4.2.1.3. 设置与服务连接超时时长-setConnectTimeout方法84.4.2.1.4. 设置发送超时时长 -setSe ndTimeout方法84.4.2.1.5. 启动 API-start 方法84.4.2.1.6.

3、获得网关连接状态 -getConnStatusIAGW方法84.4.2.1.7. 取消短信发送-canelSms方法 84.4.2.1.8. 获得短信队列中未发送的条数 -getStat方法84.4.2.1.9. 获得扩展服务代码长度 -getXCodeLength方法 84.4.2.1.10. 计算短信条数和字数 -getSmsCount方法 84.4.2.1.11. 获得预览的短信内容-getSmsContentPreview方法错误！未定 义书签。4.4.2.1.12. 短信 API 退出-loginOut 方法84.4.2.1.13. 获得 MAS短信提交的限制数量 -getDestA

4、ddrsLimit方法.94.4.2.1.14. 发送短信-sendSms 方法94.4.2.2. 短信回调对象处理类 -SmsApiClientHandler 类104.4.2.2.1. 发送响应通知-notifySmsSendResponse方法错误！未定义书签。4.4.2.2.2. 状态报告通知-notifySmsDeliveryStatus 方法104.4.2.2.3. MO 短信通知-notifySmsReception 方法104.4.2.2.4. 通知取消成功的手机号码-notifyCanelSmsList方法114.4.2.3. 短信开发客户端代码举例 114.4.3. 彩信接

5、口 144.4.3.1. 彩信API客户端主要操作类 -MmsApiClient类144.4.3.1.1. 设置是否自动重连到服务器 -setTimingConnect方法 144.4.3.1.2. 设置自动重连服务器相隔时间 -setConnectTime方法14嘉讯软件21. 设置与服务连接超时时长-setConnectTimeout方法144.4.3.14设置发送超时时长 -setSe ndTimeout方法141. 启动 API -start 方法 142. 彩信 API 退出-log in Out 方法143. 获得网关连接状态 -getConnStatusIAGW方法144. 获得

6、 MAS彩信提交的限制数量 -getDestAddrsLimit方法.155. 发送彩信-sendMms 方法156. 获取该次发送还未提交到彩信网关的数量-getStat方法.157. 取消彩信发送-canelMms方法 164.4.3.2. 彩信服务回调对象进行处理类-MmsApiClientHandler类164.4.3.2.1. 发送响应通知-notifyMmsSendResponse 方法164.4.3.2.2. 状态报告通知-notifyMmsDeliveryStatus 方法 164.4.3.2.3. MO 彩信通知-notifyMmsReception 方法174.4.3.2.

7、4. 通知取消成功的手机号码-notifyCanelMmsMobile方法错误！未定义书签。4.4.3.3. 彩信多媒体消息内容格式定义说明 174.4.3.3.1. 彩信多媒体内容类型 174.4.3.3.2. 彩信多媒体内容加密 174.4.3.3.3. 彩信多媒体内容编码 174.4.3.3.4. 彩信多媒体内容支持附件的类型 184.4.3.3.5. 彩信多媒体消息内容示例 184.4.3.3.6. 彩信多媒体消息具体加密前后内容示例 184.4.3.4. 彩信开发客户端代码举例 204.4.4. API异常错误对应常量 225. 接口描述235.1. 短信接口描述235.1.1. 接

8、口说明235.1.2. 流程说明 235.1.3. 主要类说明245.2. 彩信接口描述245.2.1. 接口说明245.2.2. 流程说明 245.2.3. 主要类说明256. API短信DEMO 使用说明 254.4. 使用说明 254.5. 主要命令说明257. 注意事项278. 参考文档27嘉讯软件3深圳市嘉讯软件有限公司中国移动通信CHINA MOBILE中国移动代理服务器 MAS V2.0 JAVA API接口开发手册4.4.2. 引言4.4.2.1.2. 编写目的本手册详细描述了中国移动代理服务器（MAS）短信、彩信 API的开发步骤以及注意事项。其阅读对象为需要 MAS开发、工

9、程支持人员、集成开发人员、SI厂商开发人员、企业客户IT开发人员。4.4.2.1.2. 背景说明近年来移动业务高速发展，MAS业务也开展的如火如荼，但同时许多集团客户有许多自己的IT系统，他们如何把自己的 IT系统也“移动”化起来呢？ MAS做为移动代理服务 器，提供了许多手段来供企业IT系统接入（如 WS接口、DB接口、WAP适配），但此次API又为这许多手段之外再增加了一种方式，并且这种方式更为高效、更稳定、扩展性更强。本手册适用于产品 “中国移动代理服务器 MAS ” V2.0版本。只描述了以JAVA语言客 户端来接入MAS的内容，其它语言开发客户端可以参考本手册。4.4.2.1.2.

10、相关术语与缩略语解释缩写词英文解析中文解析MASMobile Age nt Server移动代理服务器HTTPHypertext Tran sfer Protocol超文本传输协议HTTPSSecure HTTP加密的HTTP协议SOAPSimple Object Access Protocol简单对象访问协议UCAUni fied Communi cati on Age nt统一通信代理4.4.3. API结构说明企业侧企业应用ApiClienlSocketMAS2. 0Api AdapterServer.:嘉讯软件5深圳市嘉讯软件有限公司企业应用通过 APIClient来与MAS通信，底层

11、采用 Socket，这样可以保证高性能与稳定性。API方式通信适配插件接口封装了以下移动通信能力：中国移动通信CHINA MOBILE中国移动代理服务器 MAS V2.0 JAVA API接口开发手册. ：嘉讯软件深圳市嘉讯软件有限公司短信彩信此外，还提供基座与企业应用之间的插件管理功能接口。MAS服务器应提供配置工具，指定对于某个集团客户应用系统或应用插件，通过API方式通信适配插件或数据库方式通信适配插件接入MAS服务器。这是当应用作为插件的身份来接入MAS时才考滤的开发环境。当应用不作为插件而做为集团客户应用的身份来接入时不需关注，只需通过标准的API接口即可。4.4.4. 运行环境MA

12、S2.0基座运行环境MAS服务平台环境JDK1.5及以上4.4.5. 开发步骤4.4.2.1.5. 在Mas服务器新建一个企业应用运行MAS2服务器，登录到系统管理- “插件管理”中新建一个企业应用在开发完成后准备调试前，先运行MAS2.0服务器，然后在插件管理里新建一个应用或插件。嘉讯软件5注意：新建时通信接口方式”选择 API42启动企业应用厂SSIis-iiso轨阿亘用怅EJflrmatiFlHilr 号：123爭乎:BZ3毎債子号：無舌舌rAFTMEUSCnXSKEmAfl血診丰：K】L53】就定n孑号:m否正1fig否rWUSTRTQ片脅乎i DIFA1UW拥I子号：11正韋图4-2

13、插件管理页面要新建的插件 API接口可用，需要点击“开关”列的运行按钮。否则在使用API接口通信时可能会报 POL0906错误。当然要确保 API接口能正常使用，还需要管理平台相应的 业务能力。43开发时需要引入的包客户端开发时，要引入mas-api.3.x.jar包。4.4.3.2.1. 接口开发及使用举例中国移动通信CHINA MOBILE中国移动代理服务器 MAS V2.0 JAVA API接口开发手册441.APIClient 工厂类-ApiClientFactory类描述：APIClient工厂类，用来创建短信 APIClient与彩信APIClient。4.4.1.1. 创建短信

14、API 客户端-createSmsApiClient 方法功能：创建短信 API客户端，一个 SmsApiClient绑定了一个 Socket连接。参 数描述备注smsHa ndler短信服务回调接口，如状态报告通知、M0短信接收、发送响应等masIPMAS服务器IP地址masApiPortMAS服务器API适配监听端口MAS默认一般是61616， 具体可在MAS上修改apiIDAPI的标识，新建API时指定的见图4-1passwordAPI登录的密码，新建 API时指定见图4-14.4.1.2.创建彩信 API 客户端-createMmsApiClient 方法功能：创建彩信 API客户端，

15、一个 MmsApiClient绑定了一个 Socket连接。参 数类型描述备注mmsHa ndlerMmsApiClie ntHa ndler彩信服务回调接口，如状态报告通 知、M0彩信接收等masIPStri ngEMA服务器IP地址masApiPortintEMA服务器彩信 API适配监听端 口EMA默认一 般是61617， 具体可在EMA上修改apiIDStri ngAPI的标识，新建 API时指定的见图4-1passwordStri ngAPI登录的密码，新建API时指定见图4-14.4.3.3.1. 短信接口4.4.2.1. 短信API客户端主要操作类-SmsApiClient类短信

16、 API客户端主要操作接口，通过ApiClientFactory 类来创建期实例，一个SmsApiClient对象代表了与服务器连接，在正常与服务器通信时需要先调其start方法来初始化。4.4.3.3.6. 设置自动重连服务器-setAutoConnect方法功能：设置是否自动重连到服务器。4.4.3.3.7. 设置自动重连服务器相隔时间-setReCo nn ect In terval方法功能：设置自动重连服务器相隔时间（单位：秒），默认为30秒442.13设置与服务连接超时时长-setConnectTimeout方法功能：设置与服务连接超时时长，单位：millisecond，需要在调用s

17、tart方法前设置方可生效。5.2.1. 设置发送超时时长-setSendTimeout方法功能：设置发送超时时长，单位：millisecond，需要在调用start方法前设置方可生效。5.2.2. 启动 API-start 方法功能：启动API，该方法会自动连接到 MAS服务器并进行登录。所有的发送、接收等操作 都需要在start成功后方可使用。5.2.3. 获得网关连接状态-getConnStatusIAGW方法功能：获得网关连接状态。5.2.4. 取消短信发送-canelSms方法功能：取消短信发送。5.2.5. 获得短信队列中未发送的条数-getStat方法功能：获得短信队列中未发送的

18、条数。5.2.6. 获得扩展服务代码长度-getXCodeLength方法功能：获得扩展服务代码（插件短信扩展号码+流水号）长度。5.2.7. 计算短信条数和字数-getSmsCount方法功能：计算短信条数和字数。5.2.8. 短信 API 退出-loginOut 方法功能：短信API退出。嘉讯软件深圳市嘉讯软件有限公司中国移动通信CHINA MOBILE中国移动代理服务器 MAS V2.0 JAVA API接口开发手册442.1.12. 获得MAS信提交的限制数量-getDestAddrsLimit 方法功能：获得mas当前短信提交的限制数量。442.1.13.发送短信-sen dSms方

19、 法功能：发送短信。SmsSe ndRequest对象参数说明如下:字 段类型描述备注appIDStri ng插件IDAPI插件标识IDdestAddrsList目的地址，即手机号码集合一次发送的最大长度，具 体可通过getDestAddrsLimit 方法获 得xCodeStri ng短信子码+流水号messageStri ng短信内容msgFormatMsgFmt短信内容编码格式ASCII : ASCII 字符。UCS2G : USC2 格式的 UniCode 字符。B18030 : GB18030 格式的 中文字符。GB2312 : GB2312 格式的 中文字符。Bi nary :二进

20、制短信，用 十六进制字符串。typeSmsType短信类型Normal:普通短信Instant:免提短信Long ：长短信Structured :二进制短信WapPush： WapPush 短信priorityint短信优先级。大于 0的正 整数，数字越小优先级越 高。targetURLStri ng推送URL发送Wappush短信时有 效，其它类型短信时忽略isNeedReportboolea n是否需要状态报告validTimeint短信存活期，单位秒开始时间以MAS收到API提交时间为准， validTime默认为0时，存 活期为24小时。lin kedIDStri ng保留字段返回值S

21、msSe ndResp onse本次发送响应其SmsSendResponse参数说明如下字 段 | 类型描 述备 注嘉讯软件 JAsvonaort15深圳市嘉讯软件有限公司requestIDStri ng提交到MAS服务平台标识对应 submitIDcodeStri ng错误编码descStri ng错误描述4422短信回调对象处理类-SmsApiClientHandler 类描述：由企业应用来实现， 该接口类主要是对短信服务的一些回调对象进行处理，如接收状态报告、mo短信等。44221.状态报告通知-notifySmsDeliveryStatus方法功能：状态报告通知。如果在发送时指定不要状

22、态报告将不会调用到此方法字段类型描述备注submitIDStri ng提交到MAS服务平台标识se ndSms方法返回的值delivery InfoReport状态报告对象其Report参数说明如下:字段类型描述备注addressStri ng提交的手机号码sen dTimelong提交到网关的时间detailResultStri ng规范状态报告描述可以忽略此项timelong状态报告收到时间sen dResultint提交到网关的返回响应的结 果此值为0,表示正确提交 到网关smsTypeint短信类型statStri ng提交网关成功后，网关返回的 状态报告的状态码sendResult为

23、0时此值有 效，stat 为 “DELIVRD ”， 表示手机正确收到短信， 其它表示发送失败，具体 描述看errDescmsgIDStri ng短消息ID可不用关心errDescStri ng错误描述注：一条状态报告成功与否有以下几种情况6.1.2. sendResult如果为0，则看stat, stat为“ DELIVRD ”则表示发送成功，stat为其它则 表示发送失败，errDesc为错误描述6.1.3. sendResult不为0，则表示发送失败，不用看 stat,直接看errDesc错误描述44222.MO信通知-notifySmsReception 方法功能：MO短信通知。其sm

24、s参数说明如下字 段类型描述备注destIDStri ngMO流水号一般跟发送时的xCode对 应mobileStri ng上行的手机号码contentErrCode短信内容.:嘉讯软件中国移动通信CHINA MOBILE中国移动代理服务器 MAS V2.0 JAVA API接口开发手册msgFormatMsgFmt短信内容编码ASCII : ASCII 字符。UCS2G : USC2 格式的 UniCode 字符。B18030 : GB18030 格式的 中文字符。GB2312 : GB2312 格式的 中文字符。Bi nary :二进制短信，用十六进制字符串。msgIDStri ng消息I

25、D44223.通知取消成功的手机号码-notifyCanelSmsList方法功能：通知取消成功的手机号码，其参数说明如下字段类型描述备注submitIDStri ng提交到MAS服务平台标识can elMobileListList取消成功的手机号码集合4423短信开发客户端代码举例由图4-1所示，新建了 API插件，API插件标识为“API插件”，API插件密码“123123”， 下面代码演示 API客户端发送短信及相关方法。. ：嘉讯软件深圳市嘉讯软件有限公司中国移动通信CHINA MOBILE中国移动代理服务器 MAS V2.0 JAVA API接口开发手册#i-H深圳市嘉讯软件有限公司

26、/设置是否自动重连到服务器(可以不需要设置)smsApiClie nt .setAutoC onn ect (true );/设置自动重连服务器相隔时间(单位：秒),默认为30秒(可以不需要设置)smsApiClie nt.setReCo nn ect In terval (60);/设置与服务连接超时时长，单位： millisecond(可以不需要设置)smsApiClie nt.setCo nn ectTimeout(100000);/设置发送超时时长，单位： millisecond(可以不需要设置)smsApiClient.setSendTimeout( 1000000 );/获得短信群

27、发提交的数量限制int ret = smsApiClie nt.getDestAddrsLimit();/ 获取网关连接状态 (Connect:连接正常，Disconnect:断连，NotConnect:没有连接,Other:其他)Conn ectStatus conn ectStatus= smsApiClie nt.getC onn StatuslAGW();if (!C onn ectStatus.C onn ect.equals(c onn ectStatus)System. out .println(网关未连接)；return ;/计算短信条数和字数SmsCou nt smsCou

28、nt= smsApiClie nt.getSmsCou nt(c ontent, MsgFmt.GB2312,SmsType.Normal);/获得扩展服务代码(插件短信扩展号码 +流水号)长度int xcodeLe ngth= smsApiClie nt.getXCodeLe ngth()/发送短信/ = = = = = =构造发送短信对象开始，下面代码演示发送短信对象几个比较主要的属性值，其它的属性可以不设置，如果要设置可以参考sendSms方法中SmsSendRequest参数=SmsSe ndRequest smsSe ndRequest =new SmsSe ndRequest();

29、List list =new ArrayList();/每次群发数量不能超过最大限制数for (int i = 0; i ret; i+)long address = mobile + i;list.add(Stri ng.valueOf(address);嘉讯软件12smsSe ndRequest.destAddrs = list;/短信存活期，单位秒/短信扩展码/短信内容smsSe ndRequest.validTime = 10000;smsSe ndRequest.xCode = xCode;/短信编码类型smsSe ndRequest.message = content;smsSe

30、ndRequest.msgFormat =MsgFmt.GB2312;smsSe ndRequest.isNeedReport = true;/ 短信是否需要状态报告smsSendRequest.priority= 1; /短信网关优先级，短信优先级大于0的整数0为最高优先级,数字越大级别越低/ Normal:普通短信，lnstant:免提短信，Long ：长短信 Structured:二进制短信，WapPush： / WapPush 短信smsSendRequest.type = SmsType.Normal ;smsSe ndRequest.appID = appID;/ = = = =

31、= =构造发送短信对象结束= = = = = = =SmsSendResponse smsSendResponse= smsApiClient.sendSms(smsSendRequest);System. out .println(提交成功，requestID : + smsSendResponse.requestlD);catch(Excepti on e)System. out .println(API 短信客户端调用失败:+ e.getMessage();return ;如提交成功会收到requestID，如有网络连接、密码错误等问题，则会抛相应的异常，相关异常信息请参考444 API

32、异常错误对应常量。SmsApiClientHandler接口类主要是对短信服务的一些回调对象进行处理，如接收状态报告、 MO短信等，下面是对该类中一些回调方法的代码举例。短信服务的一些回调方法调用代码example/*接收状态报告状态报告对象* param deliveryI nfo*/Report report)+ : SmsReport0.se ndResult);public void notifySmsDeliveryStatus(String submitID， System. out .println (接收到状态报告 + report.lengthsubmitID: + subm

33、itID + sen dResul= + report/*接收MO短信param messagereturn*/public void no tifySmsRecepti on( Sms sms)中国移动通信CHINA MOBILE中国移动代理服务器 MAS V2.0 JAVA API接口开发手册System. out .println （收到一条 MO, destld : + sms. destID +；内容：+message . content +手机号码：+ sms. mobile）;彩信接口彩信API客户端主要操作类-MmsApiClient类彩信 API客户端主要操作接口，通过Api

34、ClientFactory 类来创建期实例，一个MmsApiClient对象代表了与服务器连接，在正常与服务器通信时需要先调其start方法来初始化。设置是否自动重连到服务器-setAutoConnect方法功能：设置是否自动重连到服务器。设置自动重连服务器相隔时间-setReCo nn ect In terval方法功能：设置自动重连服务器相隔时间（单位：秒），默认为30秒。设置与服务连接超时时长-setConnectTimeout方法功能：设置与服务连接超时时长，单位：millisecond，需要在调用start方法前设置方可生效。设置发送超时时长-setSendTimeout方法功能：设

35、置发送超时时长，单位：millisecond，需要在调用start方法前设置方可生效。启动彩信 API -start 方法功能：启动API，该方法会自动连接到 MAS服务器并进行登录。所有的发送、接收等操作 都需要在start成功后方可使用。彩信 API 退出-loginOut 方法功能：彩信API退出。获得网关连接状态-getConnStatusIAGW方法功能：获得网关连接状态。嘉讯软件443.18获得MAS彩信提交的限制数量-getDestAddrsLimit 方法功能：获得mas当前彩信提交的限制数量。4.4.3.1.9.发送彩信-se ndMm方法功能：发送彩信。其 MmsSendR

36、equest参数说明如下字 段类型描述备注appIDStri ng插件IDAPI插件标识IDdestAddrsStri ng目的地址，即手机号码集 合,多个手机号码之间用 英文“，”号隔开一次发送的最大长度， 具 体可通过getDestAddrsLimit 方 法 获得xCodeStri ng彩信子码+流水号subjectStri ng彩信主题contentStri ng彩信内容mime文件格式，采用BASE64 加密。priorityMessagePriority彩信网关发送优先级Default LowNormalHighlevelintMAS发送彩信优先级。 大于等于0的正整数。数 字越小

37、优先级越高，0为 最高优先级，依次减小。isNeedReportboolea n是否需要状态报告validTimeint彩信存活期，单位秒开始时间以 MAS收到 API提交时间为准， validTime默认为0时， 存活期为24小时。返回值MmsSe ndResp onse本次发送响应其MmsSendResponse 参数说明如下字段类型描述备注requestIDStri ng提交到MAS服务平台标识对应 submitIDcodeStri ng错误编码descStri ng错误描述4.4.3.1.10.获取该次发送还未提交到彩信网关的数量-getStat方法功能：提交到MAS服务平台标识（su

38、bmitID）来获取该次发送还未提交到彩信网关的数量。字段类型描述备注submitIStri ng提交到MAS服务平台标对应 MmsSendResponse中的 requestID. ：嘉讯软件深圳市嘉讯软件有限公司中国移动通信CHINA MOBILE中国移动代理服务器 MAS V2.0 JAVA API接口开发手册D识返回值int获得该submitID提交到MAS的彩信，但还未提 交到网关的数量大批量发送时用于查看当前的进度取消彩信发送-canelMms方法功能：根据发送标识取消彩信发送，已提交到网关的不能取消。字 段类型描述备注submitIDStri ng提交到MAS服务 平台标识对应M

39、msSe ndRespo nse中的requestID返回值List取消成功的手机 号码4432彩信服务回调对象进行处理类-MmsApiClientHandler类由企业应用来实现，该接口类主要是对彩信服务的一些回调对象进行处理，如接收状态报告、mo彩信等。发送响应通知-notifyMmsSendResponse方法功能：发送响应通知。其mmsSe ndRespo nse说明如下字段类型描述备注requestIDStri ng发送请求标识sendMms方法返回的值submitIDStri ng提交到MAS服务平台标识可以对应后续收到的状 态报告errCodeErrCode错误代码，为null表

40、示发送成 功嘉讯软件44322.状态报告通知-notifyMmsDeliveryStatus方法功能：状态报告通知。如果在发送时指定不要状态报告将不会调用到此方法字 段类型描述备注submitIDStri ng提交到EMA服务平台 标识对应 MmsSendResponse中的requestIDreportListReport状态报告对象字 段类型描述备注errDescStri ng错误描述当提交失败时，参数有效submitResultint提交结果成功为1，失败为0delStatusDeliveryStatus发送状态DeliveredToNetwork, Delivery Un certai

41、 n,DeliveryImpossible,其Report参数说明如下:16深圳市嘉讯软件有限公司黑翳豔中国移动代理服务器MAS V2。JAVA API接口开发手册MessageWaiti ng,DeliveredToTermi nal,DeliveryNotificati onN otSupportedaddressStri ng消息接收地址sen dTimeStri ng提交到网关的时间recDelTimeDate收到状态报告时间44323.MO彩信通知-notifyMmsReception 方法功能：M0彩信通知。字 段类型描述备注messageMmsMessageRefere nee彩

42、信对象contentStri ng消息内容其MmsMessageReferenee参数说明如下字 段类型描述备注messagelDStri ng彩信ID，如接收彩信为 纯文本则此参数无效messageServiceActivati onNu mberStri ng目的地址sen derAddressStri ng发送方地址subjectStri ng彩信的标题messageStri ng右接收彩信为纯文本， 则此参数为消息体内 容，当此参数存在时， messagelD 参数无效。dateTimeDate消息接收时间xCodeStri ng扩展号码mmsMessageMmsMessage彩信附件

43、对象4433彩信多媒体消息内容格式定义说明彩信多媒体内容类型mas提供的各种彩信发送接口，彩信内容(con te nt) 项均是字符串类型。443.32彩信多媒体内容加密彩信多媒体消内容必须经是过BASE64加密的字符串44333.彩信多媒体内容编码彩信多媒体消内容文本附件内容必须采用utf-8编码.:嘉讯软件23深圳市嘉讯软件有限公司中国移动通信CHINA MOBILE中国移动代理服务器 MAS V2.0 JAVA API接口开发手册443.34 彩信多媒体内容支持附件的类型text/plai n,text/xml,applicati on/smil,audio/amr, audio/mid

44、i, text/i-melody,text/e-melody,image/gif, image/jpeg, image/v nd.wap.wbm, image/p ng44335.彩信多媒体消息内容示例以下为加密前内容示例，通过mas发送彩信必须将此内容采用BASE64加密后发送：-SubPart_7452684322002_77645Conten t-Type:applicati on /smilConten t-Tra nsfer-E ncod in g:8bitConten t-ID:20080815103000023.smilConten t-Locatio n:20080815103

45、000023.smil smil附件内容”-SubPart_7452684322002_77645Conten t-Type:image/gifConten t-Tra nsfer-E ncod in g:8bitConten t-ID:20080815102800026.gifConten t-Locatio n:20080815102800026.gifgif附件内容,-SubPart_7452684322002_77645Con te nt-Type:text/plai n;charset=UTF-8Conten t-Tra nsfer-E ncod in g:8bitConten t-

46、ID:200808151030000231.txtConten t-Locati on:200808151030000231.txt文本附件内容”-SubPart_7452684322002_77645-NextPart_0_2817_24856 示例内容说明，内容中可以存在多个附件，每个附件前必须“ -SubPart_7452684322002_77645”开始，最后一个附件后加-SubPart_7452684322002_77645-NextPart_0_2817_24856 附件内容属性说明Content-Type附件类型Content-Transfer-Encoding附件编码位数，默

47、认采用8位编码Conten t-ID附件名称Content-Location 附件名称彩信多媒体消息具体加密前后内容示例加密前:.:嘉讯软件25深圳市嘉讯软件有限公司中国移动通信CHINA MOBILE中国移动代理服务器 MAS V2.0 JAVA API接口开发手册深圳市嘉讯软件有限公司-SubPart_7452684322002_77645Conten t-Type:applicati on /smilConten t-Tra nsfer-E ncod in g:8bitConten t-ID:20080815114700048.smilCo nte nt-Locatio n:200808

48、15114700048.smil-SubPart_7452684322002_77645Con te nt-Type:text/plai n;charset=UTF-8Conten t-Tra nsfer-E ncod in g:8bitConten t-ID:200808151147000481.txtCo nte nt-Locatio n:200808151147000481.txtHELLO MMS!-SubPart_7452684322002_77645-NextPart_0_2817_24856 加密后：LS1TdWJQYXJ0Xzc0NTI20DQzMjlwMDJfNzc2NDUN

49、CkNvb nRIb nQtVHIwZTphcHBsaWNh dGlvbi9zbWlsDQpDb250ZW50LVRyYW5zZmVyLUVuY29kaW5 nOjhiaXQNCkNvb nRIb nQtS UQ6MjAwODA4MTUxMTQ3MDAwNDguc21pbA0KQ29udGVudC1Mb2NhdGlvbjoyMDA4M DgxNTExNDcwMDA0OC5zbWlsDQoNCjxzbWlsPjxoZWFkPjxtZXRhlG5hbWU9l nRpdGxIliB jb250ZW50PSIiLz48bGF5b3V0Pjxyb290LWxheW91dCB3aWR0aD0iMTAwJS

50、IgaGVpZ2h0PSI xMDAIIiAgLz48cm Vn aW9ulGlkPSJ0eHRfdG9wliB3aWR0aD0iMTAwJSIgaGVpZ2h0PSIxNiUi IGxlZ nQ9ljAilHRvcD0iMCIgZml0PSJzY3JvbGwiLz48cm Vn aW9uIGIkPSJ0eHRfY nV 0dG9uli B3aWR0aD0iMTAwJSIgaGVpZ2h0PSIxNiUilGxlZ nQ9ljAilHRvcD0iODQIIiBmaXQ9l nNjcm9s bClvPjxyZWdpb24gaWQ9lmltZ190b3AilHdpZHRoPSIxMDAIIiBoZ

51、WI naHQ9ljg0JSIgbGVmd D0iMCIgdG9wPSIwIiBmaXQ9ImZpbGwiLz48cmVnaW9uIGIkPSJpbWdfY nV 0dG9uliB3aWR0 aD0iMTAwJSIgaGVpZ2h0PSI4NCUilGxlZ nQ9ljAilHRvcD0iMTYIIiBmaXQ9lmZpbGwiLz48c mVn aW9ulGlkPSJhbGwilHdpZHRoPSIxMDAIIiBoZWI naHQ9ljEwMCUilGxlZ nQ9ljAilHRvc D0iMCIgZml0PSJmaWxsliAvPjwvbGF5b3V0PjwvaGVhZD48Ym9keT

52、48cGFylGR1cj0iMTAw MDBtcyl+PHRIeHQgc3JjPSIyMDA4MDgxNTExNDcwMDA0ODEudHh0liByZWdpb249lmFs嘉讯软件19bClgLz48L3Bhcj48L2JvZHk+PC9zbWlsPg0KDQoNCi0tU3ViUGFydF83NDUyNjg0MzlyMDA yXzc3NjQ1DQpDb250ZW50LVR5cGU6dGV4dC9wbGFpbjtjaGFyc2V0PVVURi04DQpDb250 ZW50LVRyYW5zZmVyLUVuY29kaW5 nOjhiaXQNCkNvb nRIb nQtSUQ6MjAwODA4MT

53、UxM TQ3MDAwNDgxL nR4dA0KQ29udGVudC1Mb2NhdGlvbjoyMDA4MDgxNTExNDcwMDA0O DEudHh0DQoNCkhFTExPIE1NUyENCg0KDQotLVN1YIBhc nRfNzQ1MjY4NDMyMjAwMI83 NzY0NS0tDQotLS0tTmV4dFBhc nRfMF8y0DE3Xzl00DU2LS0NCg=4434彩信开发客户端代码举例由图4-1所示，新建了 API插件，API插件标识为“API插件” ,API插件密码“ 123123 ” 下面代码演示API客户端发送彩信及相关方法。彩信开发客户端相关方法调用代码exam

54、pleMmsApiClie nt mmsApiClie nt =null ;String appID=API 插件;/API 插件标识 IDStri ng appPwd=123123; /API 插件密码long mobile = 13800000000l;String xcode= 222 ; / 彩信扩展码String version=” 3.0 ”;int masApiPort =61617;Stri ng masIP=192.168.0.238;/MmsApiClie ntHa ndlerlmpl是自己实现的MmsApiClie ntHa ndler mmsHa ndler =new

55、MmsApiClie ntHa ndlerlmpl();trymmsApiClie nt = new MmsApiClie ntlmpl(apilD, appPwd, versi on, masIP, masApiPort, mmsHa ndler);/设置是否自动重连到服务器(可以不需要设置)mmsApiClie nt.setTimi ngConn ect(true );/设置自动重连服务器相隔时间(单位：秒),默认为30秒(可以不需要设置)mmsApiClie nt.setC onn ectTime(60);/设置与服务连接超时时长，单位： millisecond(可以不需要设置)mmsA

56、piClie nt.setCo nn ectTimeout(100000);/设置发送超时时长，单位：millisecond(可以不需要设置)mmsApiClient.setSendTimeout( 1000000 );int ret = mmsApiClient.getDestAddrsLimit();/ 获得彩信群发提交的数量限制/获取网关连接状态 (Connect:连接正常，Disconnect:断连，NotConnect :没有连嘉讯软件20中国移动通信CHINA MOBILE中国移动代理服务器 MAS V2.0 JAVA API接口开发手册接,Other :其他)Co nn ectStatus