dcloud开发混合app-消息推送push

一、这里使用个推，先注册个推账号，申请一个应用。



二、在manifest.json中添加sdk配置和模块权限配置





三、添加推送消息事件监听器

先看一下官方文档：

void plus.push.addEventListener( event, listener, Boolean );

说明：

添加推送消息事件监听器，当指定推送事件发出时触发。

参数：

type: ( String ) 必选 事件类型

支持事件类型：”click”-从系统消息中心点击消息启动应用事件；”receive”-应用从推送服务器接收到推送消息事件。

listener: ( PushReceiveCallback ) 必选 事件监听器回调函数，在接收到推送消息时调用

capture: ( Boolean ) 可选 是否捕获事件，此处可忽略

返回值：

void : 无

PushReceiveCallback

客户端接收到推动消息的回调函数

void onReceive( msg ) {

// Recieved push message code.

}

参数：

msg: ( String ) 必选 接收到的推送信息msg

返回值：

void : 无

PushMessage

JSON对象，推送消息对象

属性：

title: (String 类型 )推送消息显示的标题

平台支持

Android - 2.2+ (支持)

iOS - ALL (支持): 。

content: (String 类型 )推送消息显示的内容

payload: (JSON 类型 )推送消息承载的数据

如果推送消息中传输的数据不符合JSON格式，则作为String类型数据保存。

aps: (JSON 类型 )Apple APNS推送协议数据

平台支持

Android - 2.2+ (不支持): 不支持此数据，返回值为undefined。

iOS - 5.0+ (支持): 仅封装标准APNS协议中的数据，其它数据封装在payload中。如果是通过本地API创建的消息此属性值则为undefined。

实际代码使用的情况是，PushReceiveCallback中的msg最好是PushMessage的格式，在使用苹果或者安卓才都比较符合type自己的对receive或者click的说明。

//推送 添加监听从系统消息中心收到某条消息启动应用事件
//使用dcloud固定json格式“{title:'',content:'',payload:''}”时，
//安卓无效，苹果有效但是不会有在消息中心显示
plus.push.addEventListener("receive", receiveOrClickPushMessage, false);
//推送 添加监听从系统消息中心点击某条消息启动应用事件
//使用dcloud固定json格式“{title:'',content:'',payload:''}”时，
//安卓会在消息中心显示且点击有效，苹果离线状态下点击有效
plus.push.addEventListener("click", receiveOrClickPushMessage, false);
/**
* 接收或点击推送来的消息
*/
var receiveOrClickPushMessage = function(msg){
...
}

四、要对单个设备进行推送，还要先绑定clientid。

//获取个推客户端信息主要是clientid,并提交给服务器与绑定用户

//如果有多个设备用同一个账号登录了，保证用户最后打开的设备收到推送或者都收到推送，而不需要重新登录

/**
* 获取个推clientinfo，绑定用户信息
*/
var t = 0;
var getuiCliendInfo = function(){
var clientInfo = plus.push.getClientInfo();//获取clientinfo
if(isValidObject(clientInfo) && isValidString(clientInfo.clientid) && isValidString(clientInfo.token)){
var clientId = clientInfo.clientid;//clientid需要发给服务器与用户进行绑定
var osname = plus.os.name;//plus.os.name如果消息要区分系统，还需要绑定设备系统
mui.ajax(...);//提交服务器绑定用户信息，退出时最好还要解绑
}else{//有时也不是一次就能获取成功，可能会没有clientid，重新获取
if(t<200){//最多循环200次
var m=10,n=2;
var sec = parseInt(Math.random()*(m-n)+n,10);//2-10秒
mui.later(getuiCliendInfo, sec*1000);//延后执行。
t++;
}
}
}

注意：后台服务器的代码虽然个推提供了很多方法推送，但是只有一种在苹果安卓都可以接收，而且一定要是固定的json格式“{title:”,content:”,payload:”}”，大小写都不能错，而且不要使用苹果的消息记数功能，因为只能加没办法控制减。

五、服务器发送单个用户推送

message {title:”通知标题”,content:”通知内容”,payload:”通知去干嘛这里可以自定义”}

package com.chhuang.huaao.thread;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;

import com.alibaba.fastjson.JSONObject;
import com.chhuang.huaao.consts.HaConstact;
import com.chhuang.utils.Assert;
import com.chhuang.utils.config.SysConfig;
import com.gexin.rp.sdk.base.IPushResult;
import com.gexin.rp.sdk.base.impl.SingleMessage;
import com.gexin.rp.sdk.base.impl.Target;
import com.gexin.rp.sdk.exceptions.RequestException;
import com.gexin.rp.sdk.http.IGtPush;
import com.gexin.rp.sdk.template.TransmissionTemplate;

/**
* 个推线程
* @author CHHUANG
*
*/
public class GeTuiThread implements Runnable {
private static final Log log = LogFactory.getLog(GeTuiThread.class);

private String clientId;
private JSONObject message;

/**
*
* @param clientId
* @param message {title:"通知标题",content:"通知内容",payload:"通知去干嘛这里可以自定义"}
*/
public GeTuiThread(String clientId, JSONObject message){
this.clientId = clientId;
this.message = message;
}

@Override
public void run() {
try {
if(Assert.isInvalidString(clientId) || message==null){
log.debug("客户端还不支持推送或消息为空");
return ;
}

String host = SysConfig.getValue(HaConstact.GETUI_URL);
String appId = SysConfig.getValue(HaConstact.GETUI_APP_ID);
String appKey = SysConfig.getValue(HaConstact.GETUI_APP_KEY);
String masterSecret = SysConfig.getValue(HaConstact.GETUI_MASTER_SECRET_);

//消息模板
TransmissionTemplate template = new TransmissionTemplate();
template.setAppId(appId);
template.setAppkey(appKey);
// 透传消息设置，1为强制启动应用，客户端接收到消息后就会立即启动应用；2为等待应用启动
template.setTransmissionType(1);
template.setTransmissionContent(message.toString());

//消息体
SingleMessage message = new SingleMessage();
message.setOffline(true);
// 离线有效时间，单位为毫秒，可选
message.setOfflineExpireTime(7 * 24 * 3600 * 1000);
message.setData(template);
// 可选，1为wifi，0为不限制网络环境。根据手机处于的网络情况，决定是否下发
message.setPushNetWorkType(0);

//目标对象
Target target = new Target();
target.setAppId(appId);
target.setClientId(clientId);

IGtPush push = new IGtPush(host, appKey, masterSecret);

IPushResult ret = null;
try {
ret = push.pushMessageToSingle(message, target);
} catch (RequestException e) {
e.printStackTrace();
ret = push.pushMessageToSingle(message, target, e.getRequestId());
}
if (ret != null) {
log.debug("推送结果："+ret.getResponse().toString());
} else {
log.debug("推送服务器响应异常");
}
} catch (Exception e) {
e.printStackTrace();
}
}

}