Android使用个推实现三方应用的推送功能
PS:用了一下个推.感觉实现第三方应用的推送功能还是比较简单的.官方文档写的也非常的明确.
学习内容:
1.使用个推实现第三方应用的推送.
所有的配置我最后会给一个源代码,内部有相关的配置和文档来帮助大家完成配置,在这里就不进行介绍了.
感觉需要写的东西不是非常的多,因为官方的文档已经写的非常的明确了,如何进行配置,导入jar包,.so文件,以及AndroidManifest的文件的相关配置都写的非常的明确.我这里就稍微的简单介绍一下.注册账号什么的我就不说了,这些基本的东西没有减少的必要性.
i.PushManager
PushManager是实现推送的核心类,可以进行推送控制,设置标签,设置别名,设置默认时间等.所有的接口都由这个对象去调用.因此我们需要初始化PushManager对象.
PushManager.getInstance().initialize(context);
对象的创建方式是单列的.因此拿到的对象也就具有唯一性.这里获取到PushManager对象的同时去初始化个推服务,接口调用之后个推服务后台运行,通过广播的方式将CID发送给App.这里其实最重要的就是这个广播,其他的东西都没有什么重点的地方.只需要稍微的注意一下即可.
ii.GeTuiPushReceiver app接收CID的广播
package com.example.totem.getuidemo.receiver; import android.content.BroadcastReceiver; import android.content.Context; import android.content.Intent; import android.os.Bundle; import com.igexin.sdk.PushConsts; import com.igexin.sdk.PushManager; /** * Created by Totem on 2016/8/15. * @author 代码丶如风 */ public class GeTuiPushReceiver extends BroadcastReceiver { public static String KEY_CLIENT_ID = "push_notification_client_id"; public static String message; public static void init(Context context){ /** * 初始化对象 * 可以进行推送控制,设置标签,设置别名,设置默认时间等 * 所有接口都由该对象调用 * */ PushManager.getInstance().initialize(context); /** * 获取ClientId * */ String clientId = PushManager.getInstance().getClientid(context); if(clientId != null){ KEY_CLIENT_ID = clientId; } } @Override public void onReceive(Context context, Intent intent) { //相关处理 } private static OnGetPushMessageListener onGetPushMessageListener; public static void setOnGetPushMessageListener(OnGetPushMessageListener onGetPushMessageListener) { GeTuiPushReceiver.onGetPushMessageListener = onGetPushMessageListener; } /** * 对外暴露接口 * */ public interface OnGetPushMessageListener{ void getOstfMessage(String message); } }
这个广播是接收推送消息的核心类,其实实现起来也是比较简单的,首先就是获取PushManager对象,然后初始化个推服务,在OnReceiver方法中对传递过来的数据进行判断,这里只对两种状态进行了判断,一种是推送通知,另一种则是透传消息.
@Override public void onReceive(Context context, Intent intent) { Bundle bundle = intent.getExtras(); switch (bundle.getInt(PushConsts.CMD_ACTION)){ /** * 推送通知 * */ case PushConsts.GET_CLIENTID: String cid = bundle.getString("clientid"); break; /** * 透传消息,传递过来的是Json字符串.一般而言需要客户端进行解析. * */ case PushConsts.GET_MSG_DATA: String appid = bundle.getString("appid"); byte[] payload = bundle.getByteArray("payload"); String taskid = bundle.getString("taskid"); String messageid = bundle.getString("messageid"); if(payload != null){ /** * 如果拿到的数据不为空.那么做相关的处理 * */ message = new String(payload); onGetPushMessageListener.getOstfMessage(message); }else{ message = ""; } break; } }
这样通过判断,我们就可以得知,是推送通知,还是透传消息等等.最后写了一个对外界暴露的接口,其实就对Activity暴露接口,当我们在广播中接收到了数据发生了变化,或者是有数据传递过来,需要通过这个接口的方式,告知数据产生了变化,需要主进程做相关的处理,这是暴露接口的目的.然后在主页面中,我们只需要实现这个接口就可以了.
GeTuiPushReceiver.setOnGetPushMessageListener(new GeTuiPushReceiver.OnGetPushMessageListener() { @Override public void getOstfMessage(String message) { if(message!=null){ MessageData.add(message); } } });
iii.打开推送
turnOnPush(context)方法,用于打开推送,如果我们不主动打开推送的话,就算是后台发送了推送消息,我们也是接收不到的.在默认的状态下是开启状态.
GeTuiPushReceiver.init(getApplicationContext());pushManager = PushManager.getInstance();pushManager.turnOnPush(this);
iv.关闭推送服务
turnOffPush(context)方法,用于关闭推送服务.这个方法执行之后,就无法收到推送服务了,需要注意的是,想要再次接收到推送,必须使用turnOnPush(context)方法.其他方法无效.
GeTuiPushReceiver.init(getApplicationContext());pushManager = PushManager.getInstance();pushManager.turnOffPush(this);
v.停止SDK服务.
stopService(context).停止SDK服务之后,服务不会终止运行,而是终止推送和联网功能.重新启动需要调用initalize()方法或者是turnOnPush()方法.
GeTuiPushReceiver.init(getApplicationContext());pushManager = PushManager.getInstance();pushManager.stopService(this);
基本的东西都介绍完了,还有一些设置标签,静默时间,绑定别名什么的,大家如果有兴趣可以自己去研究下,反正我是暂时没有使用到.因此就先不动这几个模块了.我们就来看看如何使用个推后台来实现推送吧.
首先我们需要创建自己的应用,然后我们可以在应用配置当中获取到我们想要的数据,具体效果如下.
这里有我们想要的数据,AppId,AppKey等等,这些东西都需要在AndroidManifest文件中进行配置.自己做好Demo之后,就可以通过后台发送推送了.
标题和内容都是必填项,然后一直确定就可以了,这样消息就被推送出去了.在App上打开推送服务,就可以接收到推送了.透传消息我就不进行截图了.需要注意的一点就是透传消息是Json格式的字串.个推为我们提供好了Json的格式化工具.
最后放上一个源代码,这个源代码是无法运行的,因为这里是使用我自己的后台,大家也需要去创建账号,用自己的后台去创建应用,然后把AndroidManifest文件中的AppId,AppKey,AppSecret进行修改.并且内部提供了很多文档,帮助大家去集成,点击下载。