**移动端设备: **
Android:走自建的TCP长连接通道
iOS : 走自家的系统推送通道,
WinPhone: 走自家的系统推送通道,
那么意味着你服务端要维护这三套推送系统。
极光推送是：使得开发者可以即时地向其应用程序的用户推送通知或者消息，与用户保持互动，从而有效地提高留存率，提升用户体验。简单的说就是通过JPush后台管理网站进行app消息的推送。可以让用户及时的收到最新的消息提示。
但是往往有时候需要我们自己开发自己的后台管理网站实现推送的功能，这个时候就需要调用JPush提供的API接口，来进行消息的推送。这里我只讲一些核心API接口,JPush 当前支持 Android, iOS, Windows Phone 三个平台的推送。其关键字分别为："android", "ios", "winphone"。
服务端主动推送到客户端的原理:
目前服务端给客户端推送，普遍做法是客户端与服务端维持一个长连接，客户端定时向服务端发送心跳值以维持这个长连接。当有新消息过来的时候，服务端查出该消息对应的TCP Channel的ID并找到对应的通道进行消息下发。
这只是最基本的通讯模型，在此之上，有衍生出针对消息的发布/订阅模型，客户端可以订阅某一个Topic，服务端根据Topic找到对应的Channel进行批量的消息下发。所有的客户端隐式的订阅的all这个opic，所以『类似中国移动给全网信号内所有手机发消息的模式』亦可以理解『广播消息』，即给all这个Topic发消息。
下面是[Java]后台的代码部分：
调用地址
POST https://api.jpush.cn/v3/push
public class JPushClientExample {
//在极光注册上传应用的 appKey 和 masterSecret
private static final String appKey ="a148767f7440ff9daf56457f";//必填，例如466f7032ac604e02fb7bda89
private static final String masterSecret = "731e374afd796d5942ba1363";//必填，每个应用都对应一个masterSecret
private static JPushClient jpush = null;
/*调用验证
*HTTP Header（头）里加一个字段（Key/Value对）：
*Authorization: Basic base64_auth_string 其中 base64_auth_string 的生成算法为：*base64(appKey:masterSecret)即，对 appKey 加上冒号，加上 masterSecret 拼装
*起来的字符串，再做 base64 转换
*/
/*
* 保存离线的时长。秒为单位。最多支持10天（864000秒）。
* 0 表示该消息不保存离线。即：用户在线马上发出，当前不在线用户将不会收到此消息。
* 此参数不设置则表示默认，默认为保存1天的离线消息（86400秒
*/
private static long timeToLive = 60 * 60 * 24;
public static void main(String[] args) {
/*
* Example1: 初始化,默认发送给android和ios，同时设置离线消息存活时间
* jpush = new JPushClient(masterSecret, appKey, timeToLive);
*
* Example2: 只发送给android *
* Example3: 只发送给IOS
* jpush = new JPushClient(masterSecret, appKey, DeviceEnum.IOS);
*
* Example4: 只发送给android,同时设置离线消息存活时间
* jpush = new JPushClient(masterSecret, appKey, timeToLive, DeviceEnum.Android);
*/
jpush = new JPushClient(masterSecret, appKey, timeToLive);
/*
* 是否启用ssl安全连接, 可选
* 参数：启用true， 禁用false，默认为非ssl连接
*/
jpush.setEnableSSL(true);
//测试发送消息或者通知
testSend();
}
推送字段解说.png
private static void testSend() {
// 在实际业务中，建议 sendNo 是一个你自己的业务可以处理的一个自增数字。
// 除非需要覆盖，请确保不要重复使用。详情请参考 API 文档相关说明。
// Integer num= getRandomSendNo();
String sendNo="1900192560";
String msgTitle = "Hi, JPush!";
String msgContent = "我是JPush测试信息，已经成功发送给你，请查收。";
/*
* IOS设备扩展参数,
* 设置badge，设置声音
*/
Map<String, Object> extra = new HashMap<String, Object>();
IOSExtra iosExtra = new IOSExtra(1, "WindowsLogonSound.wav");
extra.put("id1",iosExtra);
extra.put("id2","I am extra infomation");
//IOS和安卓一起
MessageResult msgResult = jpush.sendNotificationWithAppKey(sendNo, msgTitle, msgContent, 0, extra);
//对所有用户发送通知, 更多方法请参考文档
// MessageResult msgResult = jpush.sendCustomMessageWithAppKey(sendNo,msgTitle, msgContent);
if (null != msgResult) {
System.out.println("服务器返回数据: " + msgResult.toString());
if (msgResult.getErrcode() == ErrorCodeEnum.NOERROR.value()) {
System.out.println("发送成功， sendNo=" + msgResult.getSendno());
} else {
System.out.println("发送失败， 错误代码=" + msgResult.getErrcode() + ", 错误消息=" + msgResult.getErrmsg());
}
} else {
System.out.println("无法获取数据");
}
}
public static final int MAX = Integer.MAX_VALUE;
public static final int MIN = (int) MAX/2;
/**
* 保持 sendNo 的唯一性是有必要的
* It is very important to keep sendNo unique.
* @return sendNo
*/
public static int getRandomSendNo() {
return (int) (MIN + Math.random() * (MAX - MIN));
}
}
状态码.png
