亿美短信平台SDK4.2.0用户手册

1、案卷号日期亿美软通短信平台SDK4.2.0 （JAVA版）用户手册作 者：北京亿美软件科技有限公司完成日期：2010-12-13签收人：签收日期：修改情况记录:版本号修改批准人修改人安装日期签收人北京亿美软通科技有限公司地址：北京市朝阳区光华路4号东方梅地亚中心 C座20层（100026）网址： 电话售前咨询：400-810-7255 手机中文实名：亿美软通手机快捷网址： 传真售后服务：400-779-7255 亿美移动商务目录用户手册11 亿美软通SDK开发说明31.1 简介31.2 背景 31.

2、3 定义 31.3.1 接口调用流程52 数据结构说明62.1 上行数据结构62.2 状态报告数据结构 63 功能介绍及使用 73.1 实例化客户端73.2 注册序列号73.3 注册企业信息83.4 注销序列号103.5 查询单价 103.6 查询余额 113.7 序列号充值123.8 发送即时短信133.9 发送即时短信（带扩展号） 143.10 发送即时短信（带字符编码） 153.11 发送即时短信（带扩展号和字符编码） 163.12 发送即时短信（带扩展号，字符编码和短信ID） 173.13 发送定时短信 193.14 发送定时短信（带字符编码） 203.15 发送定时短信（带扩展号）

3、213.16 发送定时短信（带扩展号和字符编码） 223.17 接收短信 243.18 接收状态报告 243.19 修改密码 254 配置及环境要求264.1 配置日志信息 264.2 查看日志264.3 客户端配置274.4 JAVA环境要求285 开发建议 285.1 准备工作 285.2 网络测试 285.3 开发建议285.4 项目检查286 常见问题解答296.1 系统找不到指定的路径 296.2 关于序列号优先级 296.3 关于短信优先级 296.4 余额不足时短信发送 296.5 客户网络环境条件 296.6 异常处理 306.7 无法连接到服务器 301亿美软通SDK开发说明

4、i.i 简介亿美短信SDK :是针对独立软件开发商（ISV）和系统集成商（SI）的软件开发及技术产品服务的需求，提供的短信通讯开发组件（SDK，Software Development Kit）1.2背景系统名称：亿美SDK移动商务开发组件 项目开发者：北京亿美软通科技有限公司1.3 定义MT Message Termi nal下行短信，即向手机终端发送短信MOMessage Origi nal上行短信，即手机用户向特服号码发送短信企业特服号码 由亿美为SDK用户分配的属于该用户专用的特服号码。软件序列号对应一个企业特服号码。扩展号码 基于企业特服号码，企业自行扩展维护的子号码（最大 15位）

5、，类似电话分机号码。软件序列号 由亿美分配给SDK用户，用来身份验证、计费的标识信息EUCPEmay Un ified Commu nicati on Platform 亿美统一通讯平台EUCP实现了统一的接入，提供统一的服务多运营商（中国移动、中国联通、中国网通、中国电信）的统一接入及服务提供，只需通过一个 SDK接入EUCP即可统一的与上述运营商的手机用户进行短信通讯余额与SDK帐户即软件序列号对应的帐户余额，只有拥有足够的余额才能进行成功的短信收发操作KEY值 默认情况下，注册序列号后，序列号会与电脑的硬件信息绑定，这样一个序列号只 能在一台定机器上使用。如果设置Key值，注册序列号后，

6、序列号不会与电脑的硬件信息绑定，这样，一个序列号就可以在多台机器上使用（不同的电脑上设置相同的Key值即可）。优先级 发送短信时，可以定义短信的优先级别，重要的短信定义的优先级可以高一些，普通短信 可以使用低一点的优先级。可以定义1-5共5个级别的优先级，其中 1为最低优先级，5为最高优先级接口调用流程如下:执行方式接口方法永久执行一次企业注册运行时执行发送短信（可以循环调用发送 短信接口方法）需要时执行接收短信修改密码短信转发短信转发扩展获得版本信息接收状态报告查询单条费用查询余额短信充值只在当硬件信息改变 时或换机器时执行短信注销序列号注册1.3.1接口调用流程序列号首次使用时执行一次，类

7、似于信用卡激活操作一样只需激活一次即可序列号注销后再次使用时执行一次序列号注销序列号更换服务器前执行一次序列号停用时执行一次发送短信和接受短信使用前提：序列号注册完成可以多次循环使用短信接口其他功能接口使用前提：序列号注册完成需要时执行数据结构说明2.1上行数据结构所属类：M02.2用途 保存上行短信接口函数返回的短信内容。字段名数据 类型说明mobileNumberStri ng手机号码smsC ontentStri ng内容sen tTimeSting发送时间（格式为 yyyy-mm-dd hi24:mi:ss）addSerialSting发送者附加号码（只有当发送者为满意通网络版时存在此

8、项）addSerialRevSting接收者附加号码（只有当接收者为满意通网络版时可能存在 此项，单机版获得此项为空）cha nn elNumberStri ng该字段用来接收上行短信的被叫号码状态报告数据结构所属类：StatusReport用途 保存状态报告接口函数返回的短信内容。字段名数据类型说明reportStatusStri ng状态报告的值（0发送成功）MobileStri ng手机号码submitDateSting发送时间（格式为 yyyy-mm-dd hi24:mi:ss）receiveDateSting接收时间（格式为 yyyy-mm-dd hi24:mi:ss）errorCo

9、deSting未发送成功错误编码MemoSting备注serviceCodeAddSting短信卜行时服务号码seqIDLo ng自定义唯一的消息ID，长度为不大于19位的正整数，消 息流水号功能介绍及使用3.1实例化客户端功能简介SDK客户端的构造方式，实例化客户端Client类后即可通过该实例调用短信发送等函数构造函数public Client(String serialNumber, String key) throws Exception参数详解参数名称说明serialNumber客户端序列号，必须输入key要注册的关键字，必须输入1 .用户自定义key值，长度不超过15个字符的字 符

10、串(可包含数字和字母)2 .将key做好备份，不要遗忘3.请做好保密工作，因客户自身原因泄露该关键字造成的经济损失北京亿美软通科技有限公司不承担 任何责任代码演示import cn. emay.sdk.clie nt.api.Clie nt;3.2Client c = new Client(3SDK-EMS-0130-AAAAA,123456);注册序列号功能介绍完成对序列号的注册。序列号说明(1) 软件序列号首次使用必须注册，就像信用卡首次使用必须激活一样。(2) 软件序列号只需注册成功一次即可，注册成功后，即使重启电脑，都不需再次注册序列号。(3) 序列号注册成功后，需记住密码并妥善保管。

11、(4) 试用SDK接口时，亿美提供测试序列号，并提供适当测试余额。(5) 正式应用SDK接口时，亿美提供正式序列号，在应用时，只需重新注册一次序列号即可，其它 接口不变。函数声明public int registEx(String serialpass)参数详解参数名称说明serialpass软件序列号密码，密码（6位），必须输入代码演示i mport cn.emay.sdk.client.api.Client;*测试函数*/public void testTegistEx()try Client sdkclient=new Client(3SDK-EMS-0130-AAAAA,123456)

12、; int i=sdkclient.registEx(123456);System.out.println(” 函数结果:+i); catch (Excepti on e) e.pri ntStackTrace();演示结果SDKServer:/7 conn ected !method:THREADGROUP: 收发服务线程启动 method:THREADGROUP: 未发送超时监控启动 函数结果:0返回值返回值描述0注册成功10客户端注册失败101客户端网络故障305服务器端返回错误，错误的返回值（返回值不是数字字 符串）999操作频繁3.3注册企业信息功能介绍用户序列

13、号激活以后便可以通过该接口注册自己企业的详细信息，如果要修企业的某个信 息，那么可重新调用该接口函数声明public int registDetail In fo（Stri ng n ame, String lin kMa n, String phon eNum, String mobile,String email, String fax, String address, String postcode）参数详解参数名称说明eName企业名称（最多60字节），必须输入lin kMa n联系人姓名（最多20字节），必须输入phoneNum联系电话（最多20字节），必须输入mobile联系手机（

14、最多15字节），必须输入email电子邮件（最多60字节），必须输入fax联系传真（最多20字节），必须输入address公司地址（最多60字节），必须输入postcode邮政编码（最多6字节），必须输入代码演示public void testRegistDetaill nfo()try Client sdkclient=new Client(3SDK-EMS-0130-AAAAA,123456);int a=sdkclient.registDetailInfo(企业名称,联系人,固话,手机,邮件 ,传真,企业地址,邮政编码);System.out.println(” 短信发送结果:+a);

15、catch (Excepti on e) e.pri ntStackTrace();演示结果SDKServer:/7 conn ected !method:THREADGROUP: 收发服务线程启动 method:THREADGROUP: 未发送超时监控启动 短信发送结果:0返回值返回值描述0注册企业信息成功-1注册企业信息不符合要求11企业信息注册失败101客户端网络故障305服务器端返回错误，错误的返回值（返回值不是数字字 符串）307目标电话号码不符合规则，电话号码必须是以0、1开头999操作频繁3.4 注销序列号功能介绍用户注销以后就不能再识别发送短信，接受上行短

16、信等接口，只有重新注册以后才能重新使用函数声明public int logout。参数详解无代码演示public void testLogout()try Client sdkclient=new Client(3SDK-EMS-0130-AAAAA,123456);int a=sdkclie nt.logout();System.out.println(” 短信注销结果:+a); catch (Excepti on e) e.pri ntStackTrace();演示结果SDKServer:/7 conn ected !method:THREADGROUP:收发服务线程

17、启动method:THREADGROUP: 未发送超时监控启动短信注销结果:0返回值返回值描述0注销成功22注销失败101客户端网络故障305服务器端返回错误，错误的返回值（返回值不是数字字 符串）999操作频繁3.5 查询单价功能介绍返回一条短信的费用函数声明public double getEachFee()参数详解无代码演示public void testGetEachFee()try Client sdkclient=new Client(3SDK-EMS-0130-AAAAA,123456);double a=sdkclie nt.getEachFee();System.out.pr

18、intln(” 短信发送结果:+a); catch (Excepti on e) e.pri ntStackTrace();演示结果SDKServer:/7 conn ected !method:THREADGROUP:收发服务线程启动method:THREADGROUP:未发送超时监控启动短信发送结果:0.1返回值返回值描述27查询单条短信费用错误码101客户端网络故障305服务器返回错误数据，不能转换成数字999操作频繁3.6查询余额功能介绍获得序列号的剩余金额函数声明public double getBala nce()throws Excepti on参数详解无代

19、码演示public void testGetBala nce()try Client sdkclient=new Client(3SDK-EMS-0130-AAAAA,123456);double a=sdkclie nt.getBala nce();System.out.println(” 短信发送结果:+a); catch (Excepti on e) e.pri ntStackTrace();演示结果SDKServer:/7 conn ected !method:THREADGROUP: 收发服务线程启动method:THREADGROUP: 未发送超时监控启动短信

20、发送结果：1427.03.7序列号充值功能介绍获得充值卡，可利用短信的方式进行充值函数声明public int chargeUp(Stri ng cardNo,Stri ng cardPass)参数名称说明cardNo充值卡号cardPass充值卡密码代码演示public void testChargeUp()try Client sdkclient=new Client(3SDK-EMS-0130-AAAAA,123456); int a=sdkclie nt.chargeUp(23456654646546465, 876459); System.out.println(” 短信充值结果:+

21、a); catch (Excepti on e) e.pri ntStackTrace();演示结果SDKServer:/7 conn ected !method:THREADGROUP:收发服务线程启动method:THREADGROUP:未发送超时监控启动短信充值结果:0返回值返回值描述0充值成功13充值失败101客户端网络故障305服务器端返回错误，错误的返回值（返回值不是数字字 符串）999操作频繁3.8发送即时短信功能介绍短信发送函数，调用该函数会即时的下发短信，支持单发和群发。函数声明public int sendSMS(String mobiles,Stri

22、ng smsContent, int smsPriority)参数名称说明mobiles手机号码（群发为字符串数组推荐最多为200个手机号码或以内）smsC ontent短信内容（最多500个汉字或1000个纯英文，emay服 务器程序能够自动分割；亿美有多个通道为客户提供 服务，所以分割原则采用最短字数的通道为分割短信 长度的规则，请客户应用程序不要自己分割短信以免 造成混乱）smsPriority优先级（级别从1到5的正整数，数字越大优先级越高， 越先被发送）代码演示public void testSe ndSMS()try Client sdkclient= new Client(3SD

23、K-EMS-0130-AAAAA,123456);int a=sdkclient.sendSMS(new String测试内容,3);System.out.println(” 短信发送结果:+a); catch (Excepti on e) e.pri ntStackTrace();演示结果SDKServer:/7 conn ected !method:THREADGROUP: 收发服务线程启动method:THREADGROUP: 未发送超时监控启动短信发送结果:0返回值返回值描述-1发送信息失败（短信内容长度越界）0短信发送成功17发送信息失

24、败（未激活序列号或序列号和KEY值不对，或账户没有余额等）101客户端网络故障305服务器端返回错误，错误的返回值（返回值不是数字字 符串）307目标电话号码不符合规则，电话号码必须是以0、1开头997平台返回找不到超时的短信，该信息是否成功无法确定303由于客户端网络问题导致信息发送超时，该信息是否成功下发无 法确定3.9 发送即时短信（带扩展号）功能介绍函数声明扩展号 带扩展-:类似电话的分机号，它可以区分自己的某种业务代码或 号的需要申请才可使用，其它可参考发送即时短信（短信类别。3.8 节）public int sen dSMS(Stri ngmobiles,Stri ng smsC

25、ontent,smsPriority)String addSerial, int参数详解参数名称说明mobiles手机号码（群发为字符串数组推荐最多为200个手机号码或以内）smsC ontent短信内容（最多500个汉字或1000个纯英文，emay服 务器程序能够自动分割；亿美有多个通道为客户提供 服务，所以分割原则采用最短字数的通道为分割短信 长度的规则，请客户应用程序不要自己分割短信以免 造成混乱）addSerial扩展号（长度小于15的字符串）用户可通过扩展号自 定义短信类别smsPriority优先级（级别从1到5的正整数，数字越大优先级越高， 越先被发送）代码演示public vo

26、id testSe ndSMS()try Client sdkclient= new Client(3SDK-EMS-0130-AAAAA,123456);int a=sdkclient.sendSMS(new String测试内容,123456”,3);System.out.println(” 短信发送结果:+a); catch (Excepti on e) e.pri ntStackTrace();返回值返回值描述-1发送信息失败（短信内容长度越界）0短信发送成功17发送信息失败（未激活序列号或序列号和KEY值不对，或账户没有余额等）101客户端网络故障305服务

27、器端返回错误，错误的返回值（返回值不是数字字 符串）307目标电话号码不符合规则，电话号码必须是以0、1开头997平台返回找不到超时的短信，该信息是否成功无法确定303由于客户端网络问题导致信息发送超时，该信息是否成功下发无 法确定3.10发送即时短信（带字符编码）功能介绍参考发送即时短信(3.8节)函数声明public int sendSMSEx(Stringmobiles,String smsContent. String srcCharset, intsmsPriority)参数详解参数名称说明mobiles手机号码（群发为字符串数组推荐最多为200个手机号码或以内）smsC onten

28、t短信内容（最多500个汉字或1000个纯英文，emay服 务器程序能够自动分割；亿美有多个通道为客户提供 服务，所以分割原则采用最短字数的通道为分割短信 长度的规则，请客户应用程序不要自己分割短信以免 造成混乱）srcCharset短信内容的编码方式只能填GBKsmsPriority优先级（级别从1到5的正整数，数字越大优先级越高， 越先被发送）代码演示public void testSe ndSMSEx()try Client sdkclient= new Client(3SDK-EMS-0130-AAAAA,123456);int a=sdkclient.sendSMSEx(new St

29、ring测试内容,GBK ”15/30 页System.out.println(” 短信发送结果：+a); catch (Excepti on e) e.pri ntStackTrace();返回值返回值描述-1发送信息失败（短信内容长度越界）0短信发送成功17发送信息失败（未激活序列号或序列号和KEY值不对，或账户没有余额等）101客户端网络故障305服务器端返回错误，错误的返回值（返回值不是数字字 符串）307目标电话号码不符合规则，电话号码必须是以0、1开头997平台返回找不到超时的短信，该信息是否成功无法确定303由于客户端网络问题导致信息发送超时，该信息是否

30、成功下发无 法确定3.11发送即时短信（带扩展号和字符编码）功能介绍扩展号：类似电话的分机号，它可以区分自己的某种业务代码或短信类别。带扩展号的需要申请才可使用，其它可参考发送即时短信（3.8节）函数声明public int sendSMSEx(String mobiles,String smsContent, String addSerial, String srcCharset, int smsPriority)参数详解参数名称说明mobiles手机号码（群发为字符串数组推荐最多为200个手机号码或以内）smsC ontent短信内容（最多500个汉字或1000个纯英文，emay服 务器程

31、序能够自动分割；亿美有多个通道为客户提供 服务，所以分割原则采用最短字数的通道为分割短信 长度的规则，请客户应用程序不要自己分割短信以免 造成混乱）addSerial扩展号（长度小于15的字符串）用户可通过扩展号自 定义短信类别srcCharset短信内容的编码方式只能填GBKsmsPriority优先级（级别从1到5的正整数，数字越大优先级越高, 越先被发送）代码演示public void testSe ndSMS()try Client sdkclient= new Client(3SDK-EMS-0130-AAAAA,123456);int a=sdkclie nt.se ndSMSEx

32、( new Stri ng测试内容, 123456”,”GBK ”，3);System.out.println(” 短信发送结果:+a); catch (Excepti on e) e.pri ntStackTrace();返回值返回值描述-1发送信息失败（短信内容长度越界）0短信发送成功17发送信息失败（未激活序列号或序列号和KEY值不对，或账户没有余额等）101客户端网络故障305服务器端返回错误，错误的返回值（返回值不是数字字 符串）307目标电话号码不符合规则，电话号码必须是以0、1开头997平台返回找不到超时的短信，该信息是否成功无法确定303由于客户端网络

33、问题导致信息发送超时，该信息是否成功下发无 法确定3.12发送即时短信（带扩展号，字符编码和短信ID）功能介绍扩展号：类似电话的分机号，它可以区分自己的某种业务代码或短信类别。带扩展号的需要申请才可使用，其它可参考发送即时短信（3.8节）此方法可以调用（3.18节）的方法获取信息的状态报告。函数声明public int sendSMSEx（String mobiles,String smsContent, String addSerial, String srcCharset,int smsPriority, long smsID）参数详解参数名称说明mobiles手机号码（群发为字符串数组推

34、荐最多为200个手机号码或以内）smsC ontent短信内容（最多500个汉字或1000个纯英文，emay服 务器程序能够自动分割；亿美有多个通道为客户提供 服务，所以分割原则采用最短字数的通道为分割短信 长度的规则，请客户应用程序不要自己分割短信以免 造成混乱）addSerial扩展号（长度小于15的字符串）用户可通过扩展号自定义短信类别srcCharset短信内容的编码方式只能填GBKsmsPriority优先级（级别从1到5的正整数，数字越大优先级越高， 越先被发送）smsID短信ID，自定义唯一的消息ID，数字位数最大19位， 与状态报告ID 一一对应，需用户自定义ID规则确保 ID

35、的唯一性。如果smsID为0将获取不到相应的状态 报告信息代码演示public void testSe ndSMS()try Client sdkclient= new Client(3SDK-EMS-0130-AAAAA,123456);int a=sdkclie nt.se ndSMSEx( new Stri ng测试内容, 123456”,”gbk ”，3,12345678);System.out.println(” 短信发送结果:+a); catch (Excepti on e) e.pri ntStackTrace();返回值返回值描述-1发送信息失败（短信

36、内容长度越界）0短信发送成功17发送信息失败（未激活序列号或序列号和KEY值不对，或账户没有余额等）101客户端网络故障305服务器端返回错误，错误的返回值（返回值不是数字字 符串）307目标电话号码不符合规则，电话号码必须是以0、1开头996发送消息时短信序列号错误即smsid错误997平台返回找不到超时的短信，该信息是否成功无法确定303由于客户端网络问题导致信息发送超时，该信息是否成功下发无法确定3.13发送定时短信功能介绍系统可根据自定义时间进行短信发送，该条短信会在指定的时间发送到用户的手机号中，支持单发和群发。函数声明public int sen dScheduledSMS(Str

37、i ng mobiles, String smsC ontent. String sen dTime)参数名称说明mobiles手机号码（群发为字符串数组推荐最多为200个手机号码或以内）smsC ontent短信内容（最多500个汉字或1000个纯英文，emay服 务器程序能够自动分割；亿美有多个通道为客户提供服 务，所以分割原则采用最短字数的通道为分割短信长度 的规则，请客户应用程序不要自己分割短信以免造成混乱）sen dTime定时时间.格式为：年年年年月月日日时时分分秒秒，例如20090801123030表示2009年8月1日12点30分30秒该条短信会发送到用户手机代码演示publi

38、c void testsSe ndScheduledSMS()try Client sdkclient=new Client(3SDK-EMS-0130-AAAAA,123456);int a=sdkclient.sendScheduledSMS(new String测试内容, 20030101101010);System.out.println(” 短信发送结果：+a); catch (Excepti on e) e.pri ntStackTrace();演示结果SDKServer:/7 conn ected !method:THREADGRO

39、UP: 收发服务线程启动method:THREADGROUP: 未发送超时监控启动短信发送结果:0返回值返回值描述-1发送信息失败（短信内容长度越界）0短信发送成功17发送信息失败（未激活序列号或序列号和KEY值不对，或账户没有余额等）18发送定时信息失败101客户端网络故障305服务器端返回错误，错误的返回值（返回值不是数字字 符串）307目标电话号码不符合规则，电话号码必须是以0、1开头997平台返回找不到超时的短信，该信息是否成功无法确定303由于客户端网络问题导致信息发送超时，该信息是否成功下发无 法确定3.14发送定时短信（带字符编码）功能介绍参考发送定时短信(3.13节)函数声明p

40、ublic int sen dScheduledSMSEx(Stri ng mobiles, Stri ng smsC on te nt, Stri ng sen dTime,Stri ng srcCharset)参数详解参数名称说明mobiles手机号码（群发为字符串数组推荐最多为200个手机号码或以内）smsC ontent短信内容（最多500个汉字或1000个纯英文，emay服 务器程序能够自动分割；亿美有多个通道为客户提供服 务，所以分割原则采用最短字数的通道为分割短信长度 的规则，请客户应用程序不要自己分割短信以免造成混 乱）sen dTime定时时间.格式为：年年年年月月日日时时分

41、分秒秒，例如20090801123030表示2009年8月1日12点30分30秒该条短信会发送到用户手机srcCharset短信内容的编码方式（可为空）代码演示public void testsSe ndScheduledSMS()try Client sdkclient=new Client(3SDK-EMS-0130-AAAAA,123456);int a=sdkclie nt.se ndScheduledSMSEx (new Stri ng 测试 内容, 20030101101010, ”GBK ”；System.out.println(” 短信发送结果：+a)

42、; catch (Excepti on e) e.pri ntStackTrace();返回值返回值描述-1发送信息失败（短信内容长度越界）0短信发送成功17发送信息失败（未激活序列号或序列号和KEY值不对，或账户没有余额等）18发送定时信息失败101客户端网络故障305服务器端返回错误，错误的返回值（返回值不是数字字 符串）307目标电话号码不符合规则，电话号码必须是以0、1开头997平台返回找不到超时的短信，该信息是否成功无法确定303由于客户端网络问题导致信息发送超时，该信息是否成功下发无 法确定3.15发送定时短信（带扩展号）功能简介扩展号:类似电话的分机号，它可以区分自己的某种业务代

43、码或短信类别。 带扩展号的需要申请才可使用，其它可参考发送定时短信（3.13节）函数声明public intse ndScheduledSMS（Stri ngmobiles,Stri ngsmsC on te nt, Stri ngsendTime,String addSerial）参数详解参数名称说明mobiles手机号码（群发为字符串数组推荐最多为200个手机号码或以内）smsC ontent短信内容（最多500个汉字或1000个纯英文，emay服 务器程序能够自动分割；亿美有多个通道为客户提供服 务，所以分割原则采用最短字数的通道为分割短信长度 的规则，请客户应用程序不要自己分割短信以免

44、造成混乱）sen dTime定时时间.格式为：年年年年月月日日时时分分秒秒，例如20090801123030表示2009年8月1日12点30分30秒该条短信会发送到用户手机77亿美软通 曲序谕覇务懺博addSerial扩展号（长度小于15的字符串）用户可通过扩展号自定义短信类别代码演示public void testsSe ndScheduledSMS()try Client sdkclient=new Client(3SDK-EMS-0130-AAAAA,123456);int a=sdkclient.sendScheduledSMS(new String 测试内

45、容, 20030101101010, ”23456”)；System.out.println(” 短信发送结果：+a); catch (Excepti on e) e.pri ntStackTrace();返回值返回值描述-1发送信息失败（短信内容长度越界）0短信发送成功17发送信息失败（未激活序列号或序列号和KEY值不对，或账户没有余额等）18发送定时信息失败，一般用户是定时格式不规范所致101客户端网络故障305服务器端返回错误，错误的返回值（返回值不是数字字 符串）307目标电话号码不符合规则，电话号码必须是以0、1开头997平台返回找不到超时的短信，该信息是否成功无法确定303由于客户

46、端网络问题导致信息发送超时，该信息是否成 功下发无法确定3.16发送定时短信（带扩展号和字符编码）功能简介扩展号：类似电话的分机号，它可以区分自己的某种业务代码或短信类别。带扩展号的需要申请才可使用，其它可参考发送定时短信（3.13节）函数声明public intse ndScheduledSMS（Stri ngmobiles, Stri ngsmsC on te nt,Stri ngsendTime,String addSerial, String srcCharset）参数详解参数名称说明演示代码mobiles手机号码（群发为字符串数组推荐最多为200个手机号码或以内）smsC onten

47、t短信内容（最多500个汉字或1000个纯英文，emay服 务器程序能够自动分割；亿美有多个通道为客户提供服 务，所以分割原则采用最短字数的通道为分割短信长度 的规则，请客户应用程序不要自己分割短信以免造成混乱）sen dTime定时时间格式为：年年年年月月日日时时分分秒秒，例如20090801123030表示2009年8月1日12点30分30秒该条短信会发送到用户手机addSerial扩展号（长度小于15的字符串）用户可通过扩展号自 定义短信类别srcCharset短信内容的编码方式（可为空）public void testsSe ndScheduledSMS()try Client sdk

48、client=new Client(3SDK-EMS-0130-AAAAA,123456);int a=sdkclient.sendScheduledSMS(new String 测试内 容, 20030101101010, ”23456”gbk”)；System.out.println(” 短信发送结果：+a); catch (Excepti on e) e.pri ntStackTrace();返回值返回值描述-1发送信息失败（短信内容长度越界）0短信发送成功17发送信息失败（未激活序列号或序列号和KEY值不对，或账户没有余额等）18发送定时信息失败，一般用户是定

49、时格式不规范所致101客户端网络故障305服务器端返回错误，错误的返回值（返回值不是数字字 符串）307目标电话号码不符合规则，电话号码必须是以0、1开头997平台返回找不到超时的短信，该信息是否成功无法确定303由于客户端网络问题导致信息发送超时，该信息是否成功下发无法确定3.17接收短信功能介绍从EUCP平台接收手机用户上行的短信，返回上行短信，该list的每个元素为一个 MO如果获取的结果为 n ull则说明平台暂时还没有获取到上行信息供客户查询。接收短信的方法需要申请才可以使用。函数声明public List getMO () throws Excepti on返回值返回结果说明Lis

50、t接收短信集合，集合中的值是类型为MO的对象，该对象的数据结构请参见第二部分数据结构代码演示public void testGetMO()try Client sdkclient=new Client(0SDK-EMY-0130-AAAAA,123456);List a=sdkclie nt.getMO();MO m=(MO)a.iterator(). next();System.out.println(” 上行短信数量:+a.size();System.out.println(” 上行短信内容:+m.getSmsContent();System.out.println(上行通道号码:+m.g

51、etChannelnumber(); catch (Excepti on e) e.pri ntStackTrace();演示结果SDKServer:/7 conn ected !method:THREADGROUP: 收发服务线程启动method:THREADGROUP: 未发送超时监控启动上行短信数量:1上行短信内容：测试上行通道号码:0591800010033.18接收状态报告功能介绍接收短信发送状态报告只有调用3.12带短信ID的发送方法才可以使用该方法接收状态报告，状态报告的序列ID是与发送短信方法的短信ID是一一对应的。函数声明public List getReport() throws Excepti on返回值返回结果说明List返回状态报告集合，集合中元素是类型为StatusReport 的对象代码演示public void testGetReport()try Client sdkclient=new Cli