最近要做推送的功能,于是去了解了下社区推荐的智游推送zypush
开发指南非常详细,按照这个配置,就可以出来了。
1.申请appkey
2.导入文件
将zhiyou_push.**.jar,liblptcpjin.so库以及push_notification.xml,push_download.xml文件导入到工程内部
3.配置AndroidManifest.xml文件
<注意:在配置过程中有些地方需要用到包名以及appkey>
代码块 <!-- push service(必要) --> <service android:name=”com.joboevan.push.service.PushService”> </service> <!--应用包名.PushReceiver 定义推送消息接收器,PushReceiver在SDK中有这个类--> <!-- <receiver android:name="YOUR_PACKAGENAME.PushReceiver" > --> <!--com.zypush.activity 这是我自己的包名--> <receiver android:name=”com.zypush.activity.PushRecevier”> <intent-filter> <!-- <action android:name=”com.zypush.android.intent.message.申请的appkey”/> --> <!--用户接收消息的action--> <action android:name=”com.zypush.android.intent.message.f262516bedf4c0f567b5659840920f94”/> <!--用户打开通知栏的action--> <action android:name=”com.zypush.android.intent.NOTIFICATION_OPENED.f262516bedf4c0f567b5659840920f94”/> <!-- 需要上传经纬度的action --> <action android:name=”com.zypush.android.intent.LBS_PUSH.f262516bedf4c0f567b5659840920f94”/> </intent-filter> </receiver> <!--- 心跳广播接收器注册(必要) --> <receiver android:name="com.joboevan.push.receiver.CheckConnectRecevier" android:enabled="true" /> <!-- 网络改变广播监听 (必要)--> <receiver android:name="com.joboevan.push.receiver.NetworkReceiver" > <intent-filter > <action android:name="android.net.conn.CONNECTIVITY_CHANGE" /> </intent-filter> </receiver> <!-- android:authorities="packagename"此处填写包名 (必要)--> <provider android:authorities="com.zypush.activity" android:name="com.joboevan.push.providers.downloads.DownloadProvider" /> <!-- 富媒体下载服务 (必要)--> <service android:name="com.joboevan.push.providers.downloads.DownloadService" /> <!-- 富媒体下载接收器 (必要)--> <receiver android:exported="false" android:name="com.joboevan.push.providers.downloads.DownloadReceiver" > <intent-filter > <action android:name="android.net.conn.CONNECTIVITY_CHANGE" /> </intent-filter> </receiver> <!-- 配置的第三方参数属性 测试账号:zypush 密码:123456 --> <!-- http://www.zypush.com --> <meta-data android:name="ZYPUSH_APPKEY" android:value="f262516bedf4c0f567b5659840920f94" />
推送服务运行所需要的权限
代码块 <!--自定义权限--> <permission android:name="com.zypush.permission.ACCESS_DOWNLOAD_MANAGER" /> <!-- 网络权限 --> <uses-permission android:name="android.permission.INTERNET" /> <!-- 网络状态权限 --> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <!-- 往sdcard中写入数据的权限 --> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <!-- 获取手机设备号权限 --> <uses-permission android:name="android.permission.READ_PHONE_STATE" /> <!-- 手机震动权限 --> <uses-permission android:name="android.permission.VIBRATE" /> <!-- 引用富媒体自定义权限 --> <uses-permission android:name="com.zypush.permission.ACCESS_DOWNLOAD_MANAGER" /> <!-- 唤醒权限 --> <uses-permission android:name="android.permission.WAKE_LOCK" /> <!-- 获取当前任务权限 --> <uses-permission android:name="android.permission.GET_TASKS" /> <!-- 悬浮窗体权限--> <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" /> <!-- 保留权限,后续添加功能需要用到 --> <!-- network网络开关权限(可选权限) --> <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" /> <!-- 获取基站需要的权限 (可选权限)--> <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
4.智游推送API接口说明
4.1启动推送服务
函数原型
PushManager.getInstance().connect(Contextcontext,booleanisReconnect)
参数
context: Context对象
isReconnect: 设置是否自动重连,true:表示断线以后自动重连,false标示断线以后不会自动重连
返回值
true:开启推送的条件都满足
false:条件不满足开启推送
示例
booleanresult=PushManager.getInstance().connect(getApplicationContext(),true);
4.2设置别名
需要注意的是:这个接口是覆盖逻辑,而不是增量逻辑。即新的调用会覆盖之前的设置。
一个用户只可以设置一个别名,相当于一个人的名字,为了确保其唯一性,一般是用用户名设置别名,推送可以根据别名进行推送到个人客户端。设置别名超时时间为15秒,别名的最大长度不得超过40个字节,可以在PushReceiver中接收设置别名返回给客户端的返回值
PushManager.getInstance().bindAlias(Contextcontext,Stringalias)
参数
context: Context对象
alias:设置的别名
返回值
无
示例
PushManager.getInstance().bindAlias(this,“别名”);
4.3设置标签
需要注意的是:这个接口是覆盖逻辑,而不是增量逻辑。即新的调用会覆盖之前的设置。
标签的功能可以将一个整体划分成不同的群体,比如说将所有的用户划分成“男”用户和“女”用户,那么就可以给用户设置标签“男”或“女”。一个用户可以设置多个标签,多个标签的关系是或的关系。设置标签超时时间为15秒,单个标签的最大长度不得超过40个字节,并且不能为空,一个客户端最多可以设置100个标签。
函数原型
PushManager.getInstance()。setTags(Contextcontext,名单<STRING>的标签)
参数
context: Context对象
tags: 设置标签的List数组
返回值
无
示例
。PushManager.getInstance()setTags(本,标签);
4.4设置通知栏图标
设置顶层通知栏图标
函数原型
PushManager.getInstance()setNotificationIcon(Contextcontext,的intValue);
参数
context: Context对象
value: 通知栏图标的资源id
返回值
无
示例
PushManager.getInstance().setNotificationIcon(this,R.drawable.icon);
4.5设置是否开启智能提醒
是否开启智能提醒。
函数原型
PushManager.getInstance().isOpenRemind(Contextcontext,booleanstate,Stringcontent,intdays,intstartTime,intendTime);
参数
context: Context对象
state : 设置是否开启智能提醒,true:表示开启智能提醒,false表示暂停智能提醒
content:设置提醒内容
days:相隔几天之后没有打开应用,进行提醒
startTime:在startTime之后进行提醒0-23
endTime:在endTime之前进行提醒0-23
返回值
true:开启智能提醒成功
false:开启智能提醒失败
示例
booleanresult=PushManager.getInstance().isOpenRemind(this,true,"这是一个智能提醒",3,0,23);
想要看更多的API说明,可以到www.zypush.com
5.接收消息PushReceiver
package com.zypush.activity;
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.os.Bundle;
import android.util.Log;
import com.joboevan.push.bean.SendBroastBean;
import com.joboevan.push.tool.Consts;
import com.joboevan.push.tool.LBS;
import com.joboevan.push.tool.Tool;
/**
* 推送消息接收器
*
* **/
public class PushReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
// TODO Auto-generated method stub
String action = intent.getAction();
if (Consts.getACTION_RECEIVER_KEY(context).equals(action)) {
Bundle bundle = intent.getExtras();
String key = bundle.getString("key");
if (Consts.MESSAGE_KEY_CONNECT.equals(key)) {
// 连接结果
int value = bundle.getInt("value");
switch (value) {
case Consts.RESULT_Y:
Log.d("Log", "连接成功");
break;
case Consts.RESULT_N:
Log.d("Log", "连接失败");
break;
}
} else if (Consts.MESSAGE_KEY_LOGIN.equals(key)) {
// 登陆结果
int value = bundle.getInt("value");
switch (value) {
case Consts.RESULT_Y:
Log.d("Log", "登陆成功");
break;
case Consts.RESULT_N:
Log.d("Log", "登陆失败");
break;
}
} else if (Consts.MESSAGE_KEY_SETALIAS.equals(key)) {
int value = bundle.getInt("value");
switch (value) {
case Consts.RESULT_Y:
Log.d("Log", "别名设置成功");
break;
case Consts.RESULT_N:
Log.d("Log", "别名设置失败");
break;
case Consts.RESULT_I:
Log.d("Log", "正在设置别名");
break;
default:
break;
}
} else if (Consts.MESSAGE_KEY_CLEANALIAS.equals(key)) {
int value = bundle.getInt("value");
switch (value) {
case Consts.RESULT_Y:
Log.d("Log", "清除别名成功");
break;
case Consts.RESULT_N:
Log.d("Log", "清除别名失败");
break;
case Consts.RESULT_I:
Log.d("Log", "正在清除别名");
break;
default:
break;
}
} else if (Consts.MESSAGE_KEY_SETTAGS.equals(key)) {
int value = bundle.getInt("value");
switch (value) {
case Consts.RESULT_Y:
Log.d("Log", "标签设置成功");
break;
case Consts.RESULT_N:
Log.d("Log", "标签设置失败");
break;
case Consts.RESULT_I:
Log.d("Log", "正在设置标签");
break;
default:
break;
}
} else if (Consts.MESSAGE_KEY_CLEANTAGS.equals(key)) {
int value = bundle.getInt("value");
switch (value) {
case Consts.RESULT_Y:
Log.d("Log", "标签清除成功");
break;
case Consts.RESULT_N:
Log.d("Log", "标签清除失败");
break;
case Consts.RESULT_I:
Log.d("Log", "正在清除标签");
break;
default:
break;
}
} else if (Consts.MESSAGE_KEY_CUSTOM.equals(key)) {
// 接收自定义推送信息
String value = bundle.getString("value");
String flag = bundle.getString(Consts.MESSAGE_BACK_FLAG);
Log.w("Log", "推送自定义消息: " + value);
Log.w("Log", "推送自定义消息id: " + flag);
//这个方法是推送内部封装生成通知的方法
CustomNotification notification = new CustomNotification();
notification.createNotification(context);
} else if (Consts.MESSAGE_KEY_NOTIFICATION.equals(key)) { // 如需在工程中展示通知标题和内容,请设置是否展示通知内容
String title = bundle.getString(Consts.NOTIFICATION_TITLE);
String content = bundle.getString(Consts.NOTIFICATION_CONTENT);
String ext = bundle.getString(Consts.NOTIFICATION_EXT);
String flag = bundle.getString(Consts.MESSAGE_BACK_FLAG);
Log.d("Log", "通知标题:" + title);
Log.d("Log", "通知内容:" + content);
Log.d("Log", "通知附加字段:" + ext);
Log.d("Log", "通知消息id:" + flag);
} else if (Consts.MESSAGE_KEY_PUSHSTATECHANGED.equals(key)) { // 客户端与服务端的状态
int value = bundle.getInt("value");
switch (value) {
case Consts.PUSH_CONNECTSTATE_CONNECTING: // 通道连接
Log.d("Log", "推送服务已经连接");
break;
case Consts.PUSH_CONNECTSTATE_DISCONNECT: // 通道断开
Log.e("Log", "推送服务已经断开");
break;
}
} else if (Consts.ACTION_RECEIVER_VERSION.equals(key)) {
int value = bundle.getInt("value");
switch (value) {
case Consts.VERSION_LATEST:
Log.d("Log","推送版本是最新版本:可用");
break;
case Consts.VERSION_OLD_PERMIT:
Log.d("Log","推送版本是老版本:可用");
break;
case Consts.VERSION_OLD_REFUSE:
Log.e("Log","推送版本是老版本:不可用");
break;
default:
break;
}
} else if (Consts.CLIENT_DEVICE_ID.equals(key)) {
String device_id = bundle.getString("value");
Log.d("Log", "设备唯一标识:" + device_id);
}
} else if (Consts.getActionNotificationOpened(context).equals(action)) {
Log.d("Log", "用户点击了通知");
Bundle bundle = intent.getExtras() ;
//通知标题
String title = bundle.getString(Consts.NOTIFICATION_TITLE);
//通知内容
String content = bundle.getString(Consts.NOTIFICATION_CONTENT);
//通知附加字段
String ext = bundle.getString(Consts.NOTIFICATION_EXT);
//通知消息flag
String flag = bundle.getString(Consts.MESSAGE_BACK_FLAG);
Intent i = new Intent(context, TestActivity.class);
i.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
context.startActivity(i);
} else if (Consts.getActionLbsPush(context).equals(action)) { // 接收到广播,需要上传经纬度
Log.d("Log", "需要上传经纬度信息");
// 请调用上传经纬度的接口,此处是写的固定的百度经纬度
// 参数分别为context对象,经度,纬度,类型(需要通过枚举类获取,分为GPS,百度,google三种经纬度类型)
String method = LBS.BAIDU.method(); // 获取经纬度类型
PushMethodImpl.getInstance().UploadGpsMessage(context,"0", "0", method);
}
}
}
转载于:https://blog.51cto.com/3636128/1361019