《有推客户端中间件(AOE SDK)API使用说明书》由会员分享，可在线阅读，更多相关《有推客户端中间件(AOE SDK)API使用说明书（21页珍藏版）》请在金锄头文库上搜索。
1、有推客户端中间件（AOE_SDK） API使用说明书文档版本V1.2.2发布日期2016-07-18目录1、概述 31.1 有推系统介绍31.2 有推系统示意图31.3 术语解释42、接入说明42.1 导入工程或者引用开发包42.2 第一步继承 AoiCallback52.3 第二步声明 AoiSDK 对象62.4第三步配置AndroidMenifest.xml （以demo中配置文件为准）62.5 第四步实现需要的广播和 Service错误！未定义书签。2.6 调试113、常见问题列表FAQ124、升级集成说明165、编制历史181、概述1.1 有推系统介绍有推系统是中国移动定义的永远在线平
2、台，手机应用平台可以通过有推系统向终端发送 消息。有推系统由终端中间件（AOE）、AOI网关、服务端中间件（AOI_SDK）三部分组成。1. AOE集成在手机终端应用中，管理与AOI网关的长连接并处理下发和上行的消息，它可 以将收到的消息（下行）转发给终端应用，也可以将终端应用的消息转发给AOI网关（上 行） 。2. AOI 网关是有推系统的核心网元，它主要负责终端连接管理及处理消息上下行。3. 服务端中间件（AOI_SDK）集成在与手机终端应用对应的应用平台中，管理应用平台和 AOI 网关之间的连接及处理消息的上下行。对于无应用平台的终端应用无需集成 AOI_SDK，可通过有推网站进行推送（
3、htt p:/ 有推系统示意图下图为有推系统的示意图，图中的方框代表软件，AOE是由手机应用集成的，AOI-SDK 是由应用平台集成的。AOI网关是中间一个独立系统。终端应川T-仃服务器宜泪T台抉并AOI SDK1.3 术语解释术语解释下行消息流向为应用平台（或者有推网站）一 AOI网关手机终端 应用的消息上行消息流向为手机终端应用AOI网关应用平台的消息AOEAlways Online Engine,永远在线推送基础平台AOIAlways Online Infrastructure,永远在线推送基础平台2、接入说明2.1导入工程或者引用开发包将AOE DEMO源码导入IDE（此处使用Ecli
4、pse）, DEMO对应的工程名为AoeDemo,导入后如 下图所示：丿羽libs2? android-support-v4.jar丿羽res 凸 drawable-hdpi凸 drawable-ldpi 凸 drawable-mdpi （S? drawahle-xhdpi D drawable-xxhdpi丿 & layciut旦 activity_first.xml口 activity_init.xml 口 activity_main.xmlIjOjaleiessa&xmJ1、检查 libs 中是否成功引用了 jar 包（此处以 1.2.0 版本为例,最新版本请登录 http:/ 进行下载
5、）。2、alert_message.xml是对下载框的样式定义，使用点击“下载功能”必须将该文件拷贝到 目标工程的layout目录下，可以根据自己需要更改下载框字体的大小。其它的xml文件 为 demo 自身为演示而使用的, APP 集成时可以不需要关注。2.2 第一步 继承 AoiCallback第1步，新建class继承AoiCallback (当然也可以根据自身业务需求，在既有类基础上继承AoiCallback 类)/*第一步：继承AoiCallback类，重写onInit和onNotifyData方法。其它方法可以根须需要 备选，参见ThreeCallback类。*第二步：配置Andr
6、oidMenifes t.xml中相关权限、组件参数，可参考demo配置*第三步：启动BindAoeService,内部有对应初始化方法*当前为第一步。*/public class AoeCallback extends AoiCallback Override/用于获得注册成功后返回的t oken，应用可根据t oken是否改变自行增加业务public void onInit(int result, String token) / TODO Auto-generated method stubOverridepublic void onNotifyData(int result, byte
7、data) / TODO Auto-generated method stubOverridepublic void onUnregister(int error) / TODO Auto-generated method stubOverridepublic void setContext(Context context) / TODO Auto-generated method stubOverride/用于APP获取当前的推送服务运行状态，具体状态值参考附录列表public void onState(int state) / TODO Auto-generated method stub
8、/重写onInit、onNoti fyDa ta和se tCo nt ex t方法，主要示例代码如下：private static final String TAG = AoeDemo;private Context mContext;Override/用于获得注册成功后返回的t oken,APP可保存t oken值，当t oken发生改变时，接收消息 或t oken发生变化后，进行对应业务调控public void onInit(int result, String token) if(mContext!=null) Toast.makeText(mContext, TAG + token:
9、+ token,Toas t. LENGMLONG).show();Override用于获得服务端推送给APP的消息，data指消息内容，为通过服务端下发透传消息的内容 public void onNotifyData(int result, byte data) String temp = new String(data);if (mContext != null) Toast.makeText(mContext, TAG + notify:+temp,Toas t. LENGTLONG).show();Override/用于APP获取当前的推送服务运行状态，具体状态值参考附录列表publi
10、c void onState(int state) / TODO Auto-generated method stubOverridepublic void setContext(Context context) mContext = context;2.3 第二步 配置 AndroidMenifest.xml (参考 demo 中配置)1）添加 SDK 运行所需要的系统权限 android:name=android.permission.RECEZVE_SMS / android:name=android.permission.READ_PHONE_STATE / android:name=
11、android.permission.ZNTERNET / android:name=android.permission.ACCESS_NETWORK_STATE / android:name=android.permission.CHANGE_NETWORK_STATE / android:name= android.permission.ACCES WIFI_STATE / android:name= android.permission.CHANG WIFI_STATE /uses-permissionuses-permission uses-permission uses-permi
12、ssion uses-permissionuses-permission uses-permission uses-permission uses-permissionandroid:name= android.permission.DEVICE_POWERuses-permission uses-permission uses-permission uses-permission uses-permission uses-permission uses-permission uses-permission uses-permission android:name=android.permis
13、sion.WAKE_LOCK /android:name=android.permission.WRITE_SETTINGS / android:name=android.permission.READ_SYNC_ SETTINGS/ android:name=android.permission.KILL_BACKGROUND_PROCESSES / android:name=android.permission.RECEIVE_BO0T_COMPLETED / android:name=android.permission.VIBRATE / android:name=android.permission.WRITE_EXTERNAL_STORAGE / android:name=android.permission.MOUNT_UNMOUNT_FILESYSTEMS / android:name=android.permission.RECEIVE_USER_PRESENT / android:name=android.permission.BROADCAST_STICKY /2）添加 AOE 用到的 BroadcastReceiver和 Serviceactivityandroid:name=com.cmcc.aoe.activity.Me
