java SDK服务端推送 --极光推送(JPush)

时间:2023-03-08 17:48:05
java SDK服务端推送 --极光推送(JPush)

网址:https://blog.csdn.net/duyusean/article/details/86581475

消息推送在APP应用中越来越普遍,来记录一下项目中用到的一种推送方式,对于Andriod它并没有自己的原生推送机制,一种简单的推送方式是采用第三方推送服务的方式,即通过嵌入SDK使用第三方提供的推送服务,主流的有百度云推送,极光推送,友盟,个推、亚马逊等等。本篇博文只介绍采用极光推送的方式。
        如果你是一个新手,建议你先看完本篇博客,然后在去看官网,这样也许上手会快一些。
关键步骤:1.在极光官网先注册一个账号,创建一个应用,获取AppKey、Master Secret (官网:https://www.jiguang.cn/)
2.在java项目中导入依赖的jar包,如果你是maven项目,在pom文件中添加依赖即可。
3.创建一个JPushUtil类,代码放在下面。
 
详细步骤1.登录极光官网,注册一个账号2.选择“开发者服务”—“极光推送”—“立即体验”

3.创建一个应用

4.点击新创建的应用,获取AppKey和Master Secret

5.在java项目中导入依赖包,(可参考官网:https://docs.jiguang.cn/jpush/server/sdk/java_sdk/#_2)maven 方式将下边的依赖条件放到你项目的 maven pom.xml 文件里。
<dependency>    <groupId>cn.jpush.api</groupId>    <artifactId>jpush-client</artifactId>    <version>3.3.9</version></dependency>jar 包方式请到 Release页面下载相应版本的发布包。
依赖包slf4j / log4j (Logger)gson (Google JSON Utils)其中 slf4j 可以与 logback, log4j, commons-logging 等日志框架一起工作,可根据你的需要配置使用。
如果使用 Maven 构建项目,则需要在你的项目 pom.xml 里增加:
    <dependency>        <groupId>cn.jpush.api</groupId>        <artifactId>jiguang-common</artifactId>        <version>1.1.3</version>    </dependency>    <dependency>        <groupId>io.netty</groupId>        <artifactId>netty-all</artifactId>        <version>4.1.6.Final</version>        <scope>compile</scope>    </dependency>    <dependency>        <groupId>com.google.code.gson</groupId>        <artifactId>gson</artifactId>        <version>2.3</version>    </dependency>    <dependency>        <groupId>org.slf4j</groupId>        <artifactId>slf4j-api</artifactId>        <version>1.7.7</version>    </dependency>     <!-- For log4j -->    <dependency>        <groupId>org.slf4j</groupId>        <artifactId>slf4j-log4j12</artifactId>        <version>1.7.7</version>    </dependency>    <dependency>        <groupId>log4j</groupId>        <artifactId>log4j</artifactId>        <version>1.2.17</version>    </dependency>如果不使用 Maven 构建项目,则项目 libs/ 目录下有依赖的 jar 可复制到你的项目里去。
6.创建JPushUtil类,该类中给出了使用与Android和ios的方法,以及两者都适用的方法,代码如下: /** * 极光推送工具类 * Created by DUYU on 2019/1/17. */public class JPushUtil {     // 设置好账号的app_key和masterSecret是必须的    private static String APP_KEY = "fcc67*************ba80d76";    private static String MASTER_SECRET = "a4c45*************cc0";      //极光推送>>Android    //Map<String, String> parm是我自己传过来的参数,可以自定义参数    public static void jpushAndroid(Map<String, String> parm) {         //创建JPushClient(极光推送的实例)        JPushClient jpushClient = new JPushClient(MASTER_SECRET, APP_KEY);        //推送的关键,构造一个payload        PushPayload payload = PushPayload.newBuilder()                .setPlatform(Platform.android())//指定android平台的用户                .setAudience(Audience.all())//你项目中的所有用户//                .setAudience(Audience.alias(parm.get("alias")))//设置别名发送,单发,点对点方式                //.setAudience(Audience.tag("tag1"))//设置按标签发送,相当于群发//                .setAudience(Audience.registrationId(parm.get("id")))//registrationId指定用户                 .setNotification(Notification.android(parm.get("msg"), parm.get("title"), parm))  //发送内容                .setOptions(Options.newBuilder().setApnsProduction(true).setTimeToLive(7200).build())                // apnProduction指定开发环境 true为生产模式 false 为测试模式 (android不区分模式,ios区分模式) 不用设置也没关系                // TimeToLive 两个小时的缓存时间                .setMessage(Message.content(parm.get("msg")))//自定义信息                .build();         try {            PushResult pu = jpushClient.sendPush(payload);            System.out.println(pu.toString());        } catch (APIConnectionException e) {            e.printStackTrace();        } catch (APIRequestException e) {            e.printStackTrace();        }    }     //极光推送>>ios    //Map<String, String> parm是我自己传过来的参数,可以自定义参数    public static  void jpushIOS(Map<String, String> parm) {         //创建JPushClient        JPushClient jpushClient = new JPushClient(MASTER_SECRET, APP_KEY);        PushPayload payload = PushPayload.newBuilder()                .setPlatform(Platform.ios())//ios平台的用户                .setAudience(Audience.all())//所有用户                //.setAudience(Audience.registrationId(parm.get("id")))//registrationId指定用户                .setNotification(Notification.newBuilder()                        .addPlatformNotification(IosNotification.newBuilder()                                .setAlert(parm.get("msg"))                                .setBadge(+1)                                .setSound("happy")//这里是设置提示音(更多可以去官网看看)                                .addExtras(parm)                                .build())                        .build())                .setOptions(Options.newBuilder().setApnsProduction(false).build())                .setMessage(Message.newBuilder().setMsgContent(parm.get("msg")).addExtras(parm).build())//自定义信息                .build();         try {            PushResult pu = jpushClient.sendPush(payload);            System.out.println(pu.toString());        } catch (APIConnectionException e) {            e.printStackTrace();        } catch (APIRequestException e) {            e.printStackTrace();        }    }       //极光推送>>All所有平台    public static void jpushAll(Map<String, String> parm) {         //创建JPushClient        JPushClient jpushClient = new JPushClient(MASTER_SECRET, APP_KEY);        //创建option        PushPayload payload = PushPayload.newBuilder()                .setPlatform(Platform.all())  //所有平台的用户                .setAudience(Audience.registrationId(parm.get("id")))//registrationId指定用户                .setNotification(Notification.newBuilder()                        .addPlatformNotification(IosNotification.newBuilder() //发送ios                                .setAlert(parm.get("msg")) //消息体                                .setBadge(+1)                                .setSound("happy") //ios提示音                                .addExtras(parm) //附加参数                                .build())                        .addPlatformNotification(AndroidNotification.newBuilder() //发送android                                .addExtras(parm) //附加参数                                .setAlert(parm.get("msg")) //消息体                                .build())                        .build())                .setOptions(Options.newBuilder().setApnsProduction(true).build())//指定开发环境 true为生产模式 false 为测试模式 (android不区分模式,ios区分模式)                .setMessage(Message.newBuilder().setMsgContent(parm.get("msg")).addExtras(parm).build())//自定义信息                .build();        try {            PushResult pu = jpushClient.sendPush(payload);            System.out.println(pu.toString());        } catch (APIConnectionException e) {            e.printStackTrace();        } catch (APIRequestException e) {            e.printStackTrace();        }    } }7.DEMO测试类public class demo {     public static void main(String[] args) {         //设置推送参数        //这里可以自定义推送参数了        Map<String, String> parm = new HashMap<String, String>();        //设置提示信息,内容是文章标题        parm.put("msg","收到请联系发送人");        parm.put("title","这里是title");        parm.put("alias","abc");        JPushUtil.jpushAndroid(parm);    } }测试结果:

8.极光后台查看在极光后台可以查看推送历史,登录极光后台,在应用的下方点击“推送”

选择Api

点击“操作”查看详情

9。参数信息:(来自于官方文档https://docs.jiguang.cn/jpush/server/push/rest_api_v3_push/#platform)
platform:推送平台JPush 当前支持 Android, iOS, Windows Phone 三个平台的推送。其关键字分别为:"android", "ios", "winphone"。
如果目标平台为 iOS 平台,推送 Notification 时需要在 options 中通过 apns_production 字段来设定推送环境。True 表示推送生产环境,False 表示要推送开发环境; 如果不指定则为推送生产环境;一次只能推送给一个环境。
 
推送到所有平台:
{ "platform" : "all" }指定特定推送平台:
{ "platform" : ["android", "ios"] } 
audience:推送目标推送设备对象,表示一条推送可以被推送到哪些设备列表。确认推送设备对象,JPush 提供了多种方式,比如:别名、标签、注册 ID、分群、广播等。
all如果要发广播(全部设备),则直接填写 “all”。
推送目标广播外的设备选择方式,有如下几种:
关键字类型含义说明备注tagJSON Array标签OR数组。多个标签之间是 OR 的关系,即取并集。用标签来进行大规模的设备属性、用户属性分群。 一次推送最多 20 个。有效的 tag 组成:字母(区分大小写)、数字、下划线、汉字、特殊字符@!#$&*+=.|¥。限制:每一个 tag 的长度限制为 40 字节。(判断长度需采用 UTF-8 编码)tag_andJSON Array标签AND数组。多个标签之间是 AND 关系,即取交集。注意与 tag 区分。一次推送最多 20 个。tag_notJSON Array标签NOT数组。多个标签之间,先取多标签的并集,再对该结果取补集。一次推送最多 20 个。aliasJSON Array别名数组。多个别名之间是 OR 关系,即取并集。用别名来标识一个用户。一个设备只能绑定一个别名,但多个设备可以绑定同一个别名。一次推送最多 1000 个。有效的 alias 组成:字母(区分大小写)、数字、下划线、汉字、特殊字符@!#$&*+=.|¥。限制:每一个 alias 的长度限制为 40 字节。(判断长度需采用 UTF-8 编码)registration_idJSON Array注册ID数组。多个注册 ID 之间是 OR 关系,即取并集。设备标识。一次推送最多 1000 个。客户端集成 SDK 后可获取到该值。segmentJSON Array用户分群 ID在页面创建的用户分群的 ID。定义为数组,但目前限制一次只能推送一个。目前限制是一次只能推送一个。abtestJSON ArrayA/B Test ID在页面创建的 A/B 测试的 ID。定义为数组,但目前限制是一次只能推送一个。目前限制一次只能推送一个。 
以上几种类型至少需要有其一。如果值数组长度为 0,表示该类型不存在。
这几种类型可以并存,多项的隐含关系是 AND,即取几种类型结果的交集。
例如:
"audience" : { "tag" : [ "tag1", "tag2" ], "tag_and" : [ "tag3", "tag4"], "tag_not" : [ "tag5", "tag6"] }
先计算 "tag" 字段的结果 tag1或tag2=A;
再计算 "tag_and" 字段的结果 tag3且tag4=B;
再计算 "tag_not" 字段的结果 非(tag5或tag6)=C
"audience" 的最终结果为 A且B且C 。
notification:通知
 
message:自定义消息
 
options:可选参数推送可选项。
当前包含如下几个可选项:
关键字类型选项含义说明sendnoint可选推送序号纯粹用来作为 API 调用标识,API 返回时被原样返回,以方便 API 调用方匹配请求与返回。值为 0 表示该 messageid 无 sendno,所以字段取值范围为非 0 的 int.time_to_liveint可选离线消息保留时长(秒)推送当前用户不在线时,为该用户保留多长时间的离线消息,以便其上线时再次推送。默认 86400 (1 天),最长 10 天。设置为 0 表示不保留离线消息,只有推送当前在线的用户可以收到。该字段对 iOS 的 Notification 消息无效。override_msg_idlong可选要覆盖的消息 ID如果当前的推送要覆盖之前的一条推送,这里填写前一条推送的 msg_id 就会产生覆盖效果,即:1)该 msg_id 离线收到的消息是覆盖后的内容;2)即使该 msg_id Android 端用户已经收到,如果通知栏还未清除,则新的消息内容会覆盖之前这条通知;覆盖功能起作用的时限是:1 天。如果在覆盖指定时限内该 msg_id 不存在,则返回 1003 错误,提示不是一次有效的消息覆盖操作,当前的消息不会被推送;该字段仅对 Android 有效。apns_productionboolean可选APNs 是否生产环境True 表示推送生产环境,False 表示要推送开发环境;如果不指定则为推送生产环境。但注意,JPush 服务端 SDK 默认设置为推送 “开发环境”。该字段仅对 iOS 的 Notification 有效。apns_collapse_idstring可选更新 iOS 通知的标识符APNs 新通知如果匹配到当前通知中心有相同 apns-collapse-id 字段的通知,则会用新通知内容来更新它,并使其置于通知中心首位。collapse id 长度不可超过 64 bytes。big_push_durationint可选定速推送时长(分钟)又名缓慢推送,把原本尽可能快的推送速度,降低下来,给定的 n 分钟内,均匀地向这次推送的目标用户推送。最大值为 1400。未设置则不是定速推送。
————————————————版权声明:本文为CSDN博主「杜_小妖」的原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接及本声明。原文链接:https://blog.csdn.net/duyusean/article/details/86581475