最近要做推送的功能,于是去了解了下社区推荐的智游推送
开发指南非常详细,按照这个配置,就可以出来了。
1.申请appkey
到http://www.zypush.com申请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启动推送服务
函数原型
|
|
参数
context: Context对象
isReconnect: 设置是否自动重连,true:表示断线以后自动重连,false标示断线以后不会自动重连
返回值
true:开启推送的条件都满足
false:条件不满足开启推送
示例
|
|
4.2设置别名
需要注意的是:这个接口是覆盖逻辑,而不是增量逻辑。即新的调用会覆盖之前的设置。
一个用户只可以设置一个别名,相当于一个人的名字,为了确保其唯一性,一般是用用户名设置别名,推送可以根据别名进行推送到个人客户端。设置别名超时时间为15秒,别名的最大长度不得超过40个字节,可以在PushReceiver中接收设置别名返回给客户端的返回值
|
|
参数
context: Context对象
alias:设置的别名
返回值
无
示例
|
|
4.3设置标签
需要注意的是:这个接口是覆盖逻辑,而不是增量逻辑。即新的调用会覆盖之前的设置。
标签的功能可以将一个整体划分成不同的群体,比如说将所有的用户划分成“男”用户和“女”用户,那么就可以给用户设置标签“男”或“女”。一个用户可以设置多个标签,多个标签的关系是或的关系。设置标签超时时间为15秒,单个标签的最大长度不得超过40个字节,并且不能为空,一个客户端最多可以设置100个标签。
函数原型
|
|
参数
context: Context对象
tags: 设置标签的List数组
返回值
无
示例
|
|
4.4设置通知栏图标
设置顶层通知栏图标
函数原型
|
|
参数
context: Context对象
value: 通知栏图标的资源id
返回值
无
示例
|
|
4.5设置是否开启智能提醒
是否开启智能提醒。
函数原型
|
|
参数
context: Context对象
state : 设置是否开启智能提醒,true:表示开启智能提醒,false表示暂停智能提醒
content:设置提醒内容
days:相隔几天之后没有打开应用,进行提醒
startTime:在startTime之后进行提醒0-23
endTime:在endTime之前进行提醒0-23
返回值
true:开启智能提醒成功
false:开启智能提醒失败
示例
|
|
想要看更多的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);
}
}
}