APP消息推送-个推java端实现

时间:2024-04-08 19:02:47

实现效果

APP消息推送-个推java端实现

必要的依赖

    <!-- 个推sdk的依赖 -->
    <dependency>
        <groupId>com.gexin.platform</groupId>
        <artifactId>gexin-rp-sdk-http</artifactId>
        <version>4.0.1.17</version>
    </dependency>
    
<repositories>
    <repository>
        <id>getui-nexus</id>
        <url>http://mvn.gt.igexin.com/nexus/content/repositories/releases/</url>
    </repository>
</repositories>

虽然是按照个推官方文写法档引入,但是我的maven就是无法下载到,最后只能手动引入jar
APP消息推送-个推java端实现
APP消息推送-个推java端实现
手动引入的jar包还是放在maven下载失败的目录下,不要随便放,否则项目还是回报红
https://download.csdn.net/download/u012796085/10913164

一般流程

//1,从个推应用管理中获取参数 https://dev.getui.com/dev/#/login
private static String appId = "duPdyoiHn4926fsCDbuYu8";
private static String appKey = "SWrYn90wZv8jnVT3a68vm";
private static String masterSecret = "ZTqxZR6wSo7tnKum9WQuR6";
private static String url = "http://sdk.open.api.igexin.com/apiex.htm";
//2,构造IGtPush,代表在个推注册一个APP
IGtPush push = new IGtPush(url, appKey, masterSecret);
//3,定义一个个推模板
NotificationTemplate template = new NotificationTemplate();
//4,定义消息类型
AppMessage message = new AppMessage();
message.setData(template);
//5,发送消息
IPushResult ret = push.pushMessageToApp(message);

以上步骤根据业务实际需求更改,具体的属性下面都列出来了

IGtPush构造函数

host          非必填   推送os域名,如果不填自动检测用户网络,选择最快域名连接下发
appKey        必填     鉴定身份是否合法
masterSecret  必填     第三方客户端个推集成鉴权码,验证第三方合法性,在服务端推送鉴权时使用
useSSL        非必填   是否使用https接口调用,默认http

个推模板

1,打开应⽤模板
针对沉默⽤户,发送推送消息,点击消息栏的通知可直接**启动应⽤,提升应⽤的转化率
NotificationTemplate
setAppId     必填  设定接收的应⽤
setAppkey    必填  ⽤于鉴定身份是否合法
setDuration  非必填  收到消息的展示时间
transmissionContent   必填    2048中/英字符,消息内容,不⽀持转义字符
setTransmissionType   必填    收到消息是否⽴即启动应⽤: 1为⽴即启动,2则⼴播等待客户端⾃启动
setStyle              必填    知栏消息布局样式
2,打开⽹⻚模板
推送⼴促销活动,⽤户点击通知栏信息,直接打开到指定的促销活动⻚⾯,推送直接到达指定⻚⾯,免去了中间过程的⽤户流失
LinkTemplate
setAppId     必填  设定接收的应⽤
setAppkey    必填  ⽤于鉴定身份是否合法
setDuration  非必填  收到消息的展示时间
setUrl       必填    200中/英字符,点击通知打开网页地址
setStyle              必填    知栏消息布局样式
3,启动下载任务模板
应⽤有更新,点击推送的更新通知,弹出下载弹窗,点击可启动应⽤更新下载。
NotyPopLoadTemplate
setAppId     必填  设定接收的应⽤
setAppkey    必填  ⽤于鉴定身份是否合法
setDuration  非必填  收到消息的展示时间
setLoadUr       必填    200中/英字符,下载地址
setLoadTitle    必填    下载标题
setLoadIcon     必填    下载图标 ,本地需要加入file://,网络图标直接写网络地址
setPopTitle     必填    40中/英字 弹出框标题
setPopContent   必填    600中/英字 弹出框内容
setPopImage     必填    200中/英字 符弹出框图标
setPopButton1   必填    4中/英字 弹出框确认按钮文本显示
setPopButton2   必填    4中/英字 弹出框取消按钮文本显示
setAutoInstal   非必填  是否自动安装,默认false
setActived      非必填  安装完成后是否自动启动程序,默认false
setStyle              必填    知栏消息布局样式
4,透传消息模板
⾃定义通知栏样式不想使⽤默认的通知栏样式,即可使⽤消息透传的形式,⾃定义通知栏展现形式,使发送的通知更醒⽬,更突出
TransmissionTemplate
setAppId     必填  设定接收的应⽤
setAppkey    必填  ⽤于鉴定身份是否合法
setDuration  非必填  收到消息的展示时间
setTransmissionContent       必填    2048中/英字符,透传内容,不⽀持转义字符
setTransmissionType          必填     收到消息是否⽴即启动应⽤,1为⽴即启动,2则⼴播等待客户端⾃启动
setStyle              必填    知栏消息布局样式
5,消息撤回模板
因为操作失误导致推送错误的消息,即可使⽤消息撤回模板,指定需要撤回的消息进⾏撤回
指定⽤户推送时设置⽤户出现错误,可以⽤消息撤回模板,指定需要撤回的消息和⽤户进⾏撤回
可以针对⽤户 appId下所有消息进⾏撤回
版本要求:
客户端sdk:2.12.5.0以上
服务端os-sdk:java 4.1.0.0以上
撤回限制:
1,⽀持任务类型:os-sdk撤回模板⽀持撤回单推、群推、toApp任务
2, ⽀持模板:只⽀持撤回通知、不⽀持透传
3,第三⽅⼚商都不⽀持撤回
4,如果消息通过第三⽅⼚商离线下发,撤回必须使⽤force参数为true,并且会撤回AppId下的所有消息
TransmissionTemplate

setAppId     必填  设定接收的应⽤
setAppkey    必填  ⽤于鉴定身份是否合法
setOldTaskId 必填  指定需要撤回消息对应的taskId
setForce     非必填  客户端没有找到对应的taskid,是否把对应appid下所有的通知都撤回,默认false
6,模板样式(文档结尾)

消息类型

SingleMessage               单推消息体
ListMessage                 列表推送消息体
AppMessage                  指定应用群推送消息的消息体

消息体共有属性
setData      必填       ITemplate     推送消息内容
setPriority  否         int           消息体优先级
setOffline   否         loolean       消息离线是否存储,默认true
setOfflineExpireTime    非必填  Long  消息离线存储多久,单位毫秒
setPushNetWorkType      非必填  int    1:WIFI环境推送,0:不限制推送方式
AppMessage消息体独有属性
setAppIdList            必填     List  指定推送的应用列表
setPhoneTypeList        非必填   List  设置机型
setProvinceList         非必填   List  设置省份城市,可以是省份名称,也可以是省份编码
setTagList              非必填   List  设置标签内容
setSpeed                非必填   Int   定速推送
setConditions           非必填   AppConditions     限定推送用户的条件

推送结果(所有异常返回编码在文章结尾)

IPushResult ret = push.pushMessageToApp(message);
Map resmap = ret.getResponse();
//{result=ok,...}

一个测试类(链接通知和应用通知)

import com.gexin.rp.sdk.base.IPushResult;
import com.gexin.rp.sdk.base.ITemplate;
import com.gexin.rp.sdk.base.impl.AppMessage;
import com.gexin.rp.sdk.http.IGtPush;
import com.gexin.rp.sdk.template.LinkTemplate;
import com.gexin.rp.sdk.template.NotificationTemplate;
import com.gexin.rp.sdk.template.style.Style0;
import org.junit.Test;

import java.util.ArrayList;
import java.util.List;

public class AppPush {
    
    //定义常量, appId、appKey、masterSecret 采用本文档 "第二步 获取访问凭证 "中获得的应用配置
    private static String appId = "duPdyoiHn4926fsCDbuYu8";
    private static String appKey = "SWrYn90wZv8jnVT3a68vm";
    private static String masterSecret = "ZTqxZR6wSo7tnKum9WQuR6";
    private static String url = "http://sdk.open.api.igexin.com/apiex.htm";

    /**
     * 点击打开链接
     */
    @Test
    public void testLink(){
        IGtPush push = new IGtPush(url, appKey, masterSecret);
        // 定义"点击链接打开通知模板",并设置标题、内容、链接
        LinkTemplate template = new LinkTemplate();
        template.setAppId(appId);
        template.setAppkey(appKey);
        template.setTitle("通知标题");
        template.setText("请填写通知内容AAAAAAAAAAAAAAAAAAAAAAbbbAAAAAAA");
        template.setUrl("https://www.baidu.com");
        toMessage(template);
    }

    /**
     * 点击通知打开应用程序
     */
    @Test
    public void testNotification(){
        // 定义"点击链接打开通知模板",并设置标题、内容、链接
        NotificationTemplate template = new NotificationTemplate();
        template.setAppId(appId);
        template.setAppkey(appKey);
        // 透传消息设置,1为强制启动应⽤,客户端接收到消息后就会⽴即启动应⽤;2为等待应⽤启动
        template.setTransmissionType(1);
        template.setTransmissionContent("请输⼊您要透传的内容");
        // 设置定时展示时间
        // template.setDuration("2015-01-16 11:40:00", "2015-01-16 12:24:00");
        Style0 style = new Style0();
        // 设置通知栏标题与内容
        style.setTitle("请输⼊通知栏标题");
        style.setText("请输⼊通知栏内容");
        // 配置通知栏图标
        style.setLogo("icon.png");
        // 配置通知栏⽹络图标
        style.setLogoUrl("");
        // 设置通知是否响铃,震动,或者可清除
        style.setRing(true);
        style.setVibrate(true);
        style.setClearable(true);
        template.setStyle(style);
        toMessage(template);
    }
    //发送消息
    public void toMessage(ITemplate template){
        IGtPush push = new IGtPush(appKey, masterSecret);
        List<String> appIds = new ArrayList<String>();
        appIds.add(appId);
        // 定义"AppMessage"类型消息对象,设置消息内容模板、发送的⽬标App列表、是否⽀持离线发送、以及离线消息有效期(单位毫秒)
        AppMessage message = new AppMessage();
        message.setData(template);
        message.setAppIdList(appIds);
        message.setOffline(true);
        message.setOfflineExpireTime(1000 * 600);
        IPushResult ret = push.pushMessageToApp(message);
        System.out.println(ret.getResponse().toString());
    }
}
模板样式

APP消息推送-个推java端实现
APP消息推送-个推java端实现
APP消息推送-个推java端实现
APP消息推送-个推java端实现

错误代码

APP消息推送-个推java端实现