有推客户端中间件（OE_SDK）API使用说明书.docVIP

有推客户端中间件（AOE_SDK）API使用说明书 文档版本 V1.0.9 发布日期 2014-07-30  目 录 1、概述 3 1.1 有推系统介绍 3 1.2 有推系统示意图 3 1.3 术语解释 4 2、接入说明 4 2.1导入工程或者引用开发包 4 2.2第一步继承AoiCallback 4 2.3第二步声明AoiSDK对象 6 2.4第三步配置AndroidMenifest.xml 7 2.5第四步实现需要的广播和Service 10 2.6调试 11 3、常见问题列表FAQ 12 4、升级集成说明 15 5、编制历史 16  1、概述 有推系统介绍 有推系统是中国移动定义的永远在线平台，手机应用平台可以通过有推系统向终端发送消息。 有推系统由终端中间件（AOE)、AOI网关、服务端中间件（AOI_SDK）三部分组成。 AOE集成在手机终端应用中，管理与AOI网关的长连接并处理下发和上行的消息，它可以将收到的消息（下行）转发给终端应用，也可以将终端应用的消息转发给AOI网关(上行)。 AOI网关是有推系统的核心网元，它主要负责终端连接管理及处理消息的上下行。 服务端中间件（AOI_SDK）集成在与手机终端应用对应的应用平台中，管理应用平台和AOI网关之间的连接及处理消息的上下行。对于无应用平台的终端应用无需集成AOI_SDK，可通过有推网站进行推送（/aoi）。 有推系统示意图 下图为有推系统的示意图，图中的方框代表软件，AOE是由手机应用集成的，AOI-SDK是由应用平台集成的。AOI网关是中间一个独立系统。 术语解释 术语 解释 下行消息 流向为应用平台（或者有推网站）——AOI网关——手机终端应用的消息 上行消息 流向为手机终端应用——AOI网关——应用平台的消息 AOE Always Online Engine, 永远在线推送基础平台 AOI Always Online Infrastructure, 永远在线推送基础平台 2、接入说明 2.1导入工程或者引用开发包 将AOE DEMO源码导入IDE(此处使用Eclipse)，DEMO对应的工程名为AoeDemo3，导入后如下图所示： 检查libs中是否成功引用了jar包（此处以1.0.9版本为例，最新版本请登录/aoi/downloadcenter/tosdk.do进行下载）。 alert_message.xml是对下载框的样式定义，使用点击“下载功能”必须将该文件拷贝到目标工程的layout目录下，可以根据自己需要更改下载框字体的大小。 2.2第一步继承AoiCallback 第1步，新建class继承AoiCallback（当然也可以根据自身业务需求，在既有类基础上继承AoiCallback类） /* * 第一步：继承AoiCallback类，重写onInit和onNotifyData方法。其它方法可以根须需要备选。 * 第二步：声明AoiSDK对象，声明回调函数对象，初始化AoiSDK，参见ThreeDemo类； * 第三步：将Demo中AndroidMenifest.xml中配置拷贝到目标工程中； * 第四步：实现AOE用到的BroadcastReceiver和Service，参见BindAoeService和RebindReceiver； * 当前为第一步。 */ public class ThreeCallback extends AoiCallback { @Override //用于获得注册成功后返回的token public void onInit(int arg0, String arg1) { // TODO Auto-generated method stub } @Override public void onNotifyData(int arg0, byte[] arg1) { // TODO Auto-generated method stub } @Override public void onPostData(int arg0, byte[] arg1) { // TODO Auto-generated method stub } @Override public void onUnregister(int arg0) { // TODO Auto-generated method stub } @Override public void setContext(Context arg0) { // TODO Auto-generated method stub } } //然后重写onInit、onNotifyData和set