亿美短信平台SDK4.2.0(JAVA版)用户手册 下载本文

? 返回值

}

} catch (Exception e) { e.printStackTrace(); }

返回值 -1 0 17 18 101 305 307 997 303 描述 发送信息失败(短信内容长度越界) 短信发送成功 发送信息失败(未激活序列号或序列号和KEY值不对,或账户没有余额等) 发送定时信息失败 客户端网络故障 服务器端返回错误,错误的返回值(返回值不是数字字符串) 目标电话号码不符合规则,电话号码必须是以0、1开头 平台返回找不到超时的短信,该信息是否成功无法确定 由于客户端网络问题导致信息发送超时,该信息是否成功下发无法确定 3.15 发送定时短信(带扩展号) ? 功能简介

扩展号:类似电话的分机号,它可以区分自己的某种业务代码或短信类别。 带扩展号的需要申请才可使用,其它可参考发送定时短信(3.13节)

? 函数声明

public int sendScheduledSMS(String[] mobiles, String smsContent, String sendTime,String addSerial)

? 参数详解

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

addSerial

扩展号 (长度小于15的字符串) 用户可通过扩展号自定义短信类别 ? 代码演示

public void testsSendScheduledSMS(){ try { Client sdkclient=new Client(\

int a=sdkclient.sendScheduledSMS(new String[] {\测试内

容\”123456”);

System.out.println(\短信发送结果:\ } catch (Exception e) { e.printStackTrace(); }

}

? 返回值

返回值 -1 0 17 18 101 305 307 997 303 描述 发送信息失败(短信内容长度越界) 短信发送成功 发送信息失败(未激活序列号或序列号和KEY值不对,或账户没有余额等) 发送定时信息失败,一般用户是定时格式不规范所致 客户端网络故障 服务器端返回错误,错误的返回值(返回值不是数字字符串) 目标电话号码不符合规则,电话号码必须是以0、1开头 平台返回找不到超时的短信,该信息是否成功无法确定 由于客户端网络问题导致信息发送超时,该信息是否成功下发无法确定 3.16 发送定时短信(带扩展号和字符编码) ? 功能简介

扩展号:类似电话的分机号,它可以区分自己的某种业务代码或短信类别。 带扩展号的需要申请才可使用,其它可参考发送定时短信(3.13节)

? 函数声明

public int sendScheduledSMS(String[] mobiles, String smsContent, String sendTime,String addSerial, String srcCharset)

? 参数详解

参数名称 说明 22/30 页

mobiles smsContent 手机号码(群发为字符串数组推荐最多为200个手机号码或以内) 短信内容(最多500个汉字或1000个纯英文,emay服务器程序能够自动分割;亿美有多个通道为客户提供服务,所以分割原则采用最短字数的通道为分割短信长度的规则,请客户应用程序不要自己分割短信以免造成混乱) sendTime 定时时间.格式为:年年年年月月日日时时分分秒秒,例如20090801123030 表示2009年8月1日12点30分30秒该条短信会发送到用户手机 addSerial srcCharset 扩展号 (长度小于15的字符串) 用户可通过扩展号自定义短信类别 短信内容的编码方式(可为空) ? 演示代码

public void testsSendScheduledSMS(){ try { Client sdkclient=new Client(\

int a=sdkclient.sendScheduledSMS(new String[] {\测试内

容\”123456”,”gbk”);

System.out.println(\短信发送结果:\ } catch (Exception e) { e.printStackTrace(); }

}

? 返回值

返回值 -1 0 17 18 101 305 307 997 303 描述 发送信息失败(短信内容长度越界) 短信发送成功 发送信息失败(未激活序列号或序列号和KEY值不对,或账户没有余额等) 发送定时信息失败,一般用户是定时格式不规范所致 客户端网络故障 服务器端返回错误,错误的返回值(返回值不是数字字符串) 目标电话号码不符合规则,电话号码必须是以0、1开头 平台返回找不到超时的短信,该信息是否成功无法确定 由于客户端网络问题导致信息发送超时,该信息是否成功下发无法确定 23/30 页

3.17 接收短信 ? 功能介绍

从EUCP平台接收手机用户上行的短信,返回上行短信,该list的每个元素为一个MO,如果获取的结果为null则说明平台暂时还没有获取到上行信息供客户查询。 接收短信的方法需要申请才可以使用。

? 函数声明

public List getMO () throws Exception

? 返回值

返回结果 List 说明 接收短信集合,集合中的值是类型为MO的对象,该对象的数据结构请参见第二部分数据结构 ? 代码演示

public void testGetMO(){ try { Client sdkclient=new Client(\ List a=sdkclient.getMO(); MO m=(MO)a.iterator().next(); System.out.println(\上行短信数量:\ System.out.println(\上行短信内容:\ System.out.println(\上行通道号码:\ } catch (Exception e) { e.printStackTrace(); } }

? 演示结果

SDKServer:/192.168.1.67 connected ! method:THREADGROUP:收发服务线程启动 method:THREADGROUP:未发送超时监控启动 上行短信数量:1 上行短信内容:测试 上行通道号码:059180001003

3.18 接收状态报告 ? 功能介绍

接收短信发送状态报告

只有调用3.12带短信ID的发送方法才可以使用该方法接收状态报告,状态报告的序列ID是与发送短信方法的短信ID是一一对应的。

? 函数声明

public List getReport() throws Exception

24/30 页