uniapp消息推送方案

55次阅读

共计 6482 个字符，预计需要花费 17 分钟才能阅读完成。

一、引言

uni-app 是支持消息推送的，参考如下文档：

UniPush 介绍

UniPush 使用指南

UniPush 开通指南

如何自定义推送通知的图标？

在 uni-app 中使用 UniPush

二、效果

开源项目 uniapp-admin

三、需求

不同角色的用户登陆 App，收到不同的待办提醒。即谁处理这个待办任务，谁会收到这个提醒。对不同角色的用户推送待办消息

四、方案步骤

4.1 查看个推文档

因为 uni-app 的推送是集成了个推，所以查看个推文档接入方案

因为后台是 java 语言，所以查看 java 集成指南

  • 下载服务端 SDK 开发工具包，下载地址为：http://www.getui.com/download…
  • 导入 ”GETUI_SERVER_SDK 资源文件”目录下的所有 jar 包
# uni-push
mvn install:install-file -Dfile="gexin-rp-fastjson-1.0.0.3.jar" -DgroupId=com.gexin.platform -DartifactId=gexin-rp-fastjson -Dversion=1.0.0.3 -Dpackaging=jar
mvn install:install-file -Dfile="gexin-rp-sdk-base-4.0.0.30.jar" -DgroupId=com.gexin.platform -DartifactId=gexin-rp-sdk-base -Dversion=4.0.0.30 -Dpackaging=jar
mvn install:install-file -Dfile="gexin-rp-sdk-http-4.1.0.5.jar" -DgroupId=com.gexin.platform -DartifactId=gexin-rp-sdk-http -Dversion=4.1.0.5 -Dpackaging=jar
mvn install:install-file -Dfile="gexin-rp-sdk-template-4.0.0.24.jar" -DgroupId=com.gexin.platform -DartifactId=gexin-rp-sdk-template -Dversion=4.0.0.24 -Dpackaging=jar
mvn install:install-file -Dfile="protobuf-java-2.5.0.jar" -DgroupId=com.google.protobuf -DartifactId=protobuf-java -Dversion=2.5.0 -Dpackaging=jar
<!-- uni push -->
<dependency>
    <groupId>com.gexin.platform</groupId>
    <artifactId>gexin-rp-sdk-base</artifactId>
    <version>4.0.0.30</version>
</dependency>
<dependency>
    <groupId>com.gexin.platform</groupId>
    <artifactId>gexin-rp-sdk-template</artifactId>
    <version>4.0.0.24</version>
</dependency>
<dependency>
    <groupId>com.gexin.platform</groupId>
    <artifactId>gexin-rp-sdk-http</artifactId>
    <version>4.1.0.5</version>
</dependency>
<dependency>
    <groupId>com.gexin.platform</groupId>
    <artifactId>gexin-rp-fastjson</artifactId>
    <version>1.0.0.3</version>
</dependency>
<dependency>
    <groupId>com.google.protobuf</groupId>
    <artifactId>protobuf-java</artifactId>
    <version>2.5.0</version>
</dependency>

4.2 编写服务端简单 demo

按照 UniPush 开通指南，开通 UniPush，获取 appId、appKey 等，编写下面简单 demo，客户端就会收到消息啦~

客户端接收消息代码，参考 4.3

public class AppPush {

    // STEP1：获取应用基本信息
    private static String appId = "";
    private static String appKey = "";
    private static String masterSecret = "";
    private static String url = "http://sdk.open.api.igexin.com/apiex.htm";

    public static void main(String[] args) throws IOException {IGtPush push = new IGtPush(url, appKey, masterSecret);

        Style0 style = new Style0();
        // STEP2：设置推送标题、推送内容
        style.setTitle("请输入通知栏标题");
        style.setText("请输入通知栏内容");
        // 注释采用默认图标
        // style.setLogo("push.png");  // 设置推送图标
        // STEP3：设置响铃、震动等推送效果
        style.setRing(true);  // 设置响铃
        style.setVibrate(true);  // 设置震动

        // STEP4：选择通知模板
        NotificationTemplate template = new NotificationTemplate();
        template.setAppId(appId);
        template.setAppkey(appKey);
        template.setStyle(style);
        // 点击消息打开应用
        template.setTransmissionType(1);
        // 传递自定义消息
        template.setTransmissionContent(" 自定义消息，可以是 json
        字符串 ");


        // STEP5：定义 "AppMessage" 类型消息对象, 设置推送消息有效期等推送参数
        List<String> appIds = new ArrayList<String>();
        appIds.add(appId);
        AppMessage message = new AppMessage();
        message.setData(template);
        message.setAppIdList(appIds);
        message.setOffline(true);
        message.setOfflineExpireTime(1000 * 600);  // 时间单位为毫秒

        // STEP6：执行推送
        IPushResult ret = push.pushMessageToApp(message);
        System.out.println(ret.getResponse().toString());
    }
}

4.3 客户端 App.vue 添加消息处理逻辑

/**
  * 处理推送消息
  */
handlePush() {
  // #ifdef APP-PLUS
  const _self = this
  const _handlePush = function(message) {
    // 获取自定义信息
    let payload = message.payload
    try {
      // JSON 解析
      payload = JSON.parse(payload)
      // 携带自定义信息跳转应用页面
      uni.navigateTo({url: '/pages/xxx?data=' + JSON.stringify(payload)
      })
    } catch(e) {}}
  // 事件处理
  plus.push.addEventListener('click', _handlePush)
  plus.push.addEventListener('receive', _handlePush)
  // #endif
},

五、思考

应用确实接收到了消息，但是所有角色的用户都会接收到和自己不想关的待办任务消息。这是违背需求的！所以基于此，作者研究了服务端发送到客户端消息的原理：

实际上，消息不管是单推还是群推，推送的目标都是 clientid，clientid 标识每个客户端的身份

问题来了，怎么获取客户端的 clientid 呢？

六、最终方案

6.1 获取客户端 clientid

经过查询资料，有一个 api 是 getClientInfo 方法，可以获取客户端信息，但是必须条件编译，因为是 plus 接口。

以下代码，用户登陆完成时，获取 客户端信息（appid,appkey,clientid）、用户信息（账户名、角色等）、其他信息，向服务端提交 api 请求，保存 客户端 clientid 和角色 的关联信息。

// 保存 clientid 到服务器
// #ifdef APP-PLUS
const clientInfo = plus.push.getClientInfo()
let pushUser = {
  clientid: clientInfo.clientid,
  appid: clientInfo.appid,
  appkey: clientInfo.appkey,
  userName: '用户名',
  userRole: '用户角色'
}
// 提交 api 请求，服务端保存客户端角色信息
Vue.prototype.$minApi.savePushUser(pushUser)
// #endif

6.2 服务端接收客户端角色信息处理

服务端接收到信息，根据自己的业务逻辑，保存或者更新，作者的处理逻辑时已经保存的 clientid，不在新增，更新角色信息。

clientid 和角色关系，数据库表结构

6.3 服务端根据不同角色发送待办提醒

改进消息发送方式，采用个推 toList：简称“批量推”，指向制定的一批用户推送消息

/**
* @params pushMessage 推送消息
* @params appPushList 推送角色目标列表
*/
public static void pushMessage(PushMessage pushMessage, List<AppPush> appPushList) {IGtPush push = new IGtPush(url, appKey, masterSecret);

  Style0 style = new Style0();
  // STEP2：设置推送标题、推送内容
  style.setTitle(pushMessage.getTitle());
  style.setText(pushMessage.getContent());
//        style.setLogo("push.png"); // 设置推送图标
  // STEP3：设置响铃、震动等推送效果
  style.setRing(true);  // 设置响铃
  style.setVibrate(true);  // 设置震动

  // STEP4：选择通知模板
  NotificationTemplate template = new NotificationTemplate();
  template.setAppId(appId);
  template.setAppkey(appKey);
  template.setStyle(style);
  // 点击消息打开应用
  template.setTransmissionType(1);
  // 传递自定义消息
  template.setTransmissionContent(JSONUtil.toJsonStr(pushMessage));


  // STEP5：定义 "AppMessage" 类型消息对象, 设置推送消息有效期等推送参数
  // 采用 toList 方案，定义 ListMessage 消息类型
//        List<String> appIds = new ArrayList<String>();
//        appIds.add(appId);
  ListMessage message = new ListMessage();
  message.setData(template);
//        message.setAppIdList(appIds);
  message.setOffline(true);
  message.setOfflineExpireTime(1000 * 600);  // 时间单位为毫秒

  String contentId = push.getContentId(message);
  // 获取推送目标
  List targets = new ArrayList();
  for (AppPush ap : appPushList) {Target target = new Target();
      target.setAppId(appId);
      target.setClientId(ap.getClientid());
      targets.add(target);
  }

  // STEP6：执行推送，不采用 toApp 方案，采用 toList 方案
//        IPushResult ret = push.pushMessageToApp(message);
  IPushResult ret = push.pushMessageToList(contentId, targets);
  System.out.println(ret.getResponse().toString());
}

PushMessage 类是一个 model

public class PushMessage {
    private String title;
    private String content;
    // 用户角色
    private String userRole;
    // 其他对象

    // 省略，getter setter 方法
}

AppPush 类是数据库表映射类

public class AppPush
  private String appid;//appid
  private String appkey;//appkey
  private String clientid;//clientid
  private String userName;// 账户
  private String userRole;// 用户角色
  // 其他对象

  // 省略，getter setter 方法
}

七、自定义通知图标

在客户端 manifest.json 文件中的 sdkConfigs 中添加如下配置，图标自己添加

/* SDK 配置 */
"sdkConfigs" : {
    "push" : {
        "unipush" : {
"icons": {
  "push": {
    "ldpi": "unpackage/res/icons/48x48.png",
    "mdpi": "unpackage/res/icons/48x48.png",
    "hdpi" : "unpackage/res/icons/72x72.png",
    "xhdpi" : "unpackage/res/icons/96x96.png",
    "xxhdpi" : "unpackage/res/icons/144x144.png",
    "xxxhdpi" : "unpackage/res/icons/192x192.png"
  },
  "small": {
    "ldpi": "unpackage/res/icons/18x18.png",
    "mdpi": "unpackage/res/icons/24x24.png",
    "hdpi": "unpackage/res/icons/36x36.png",
    "xhdpi": "unpackage/res/icons/48x48.png",
    "xxhdpi": "unpackage/res/icons/72x72.png"
  }
}
}
    }
},

八、开源项目

开源项目 uniapp-admin

<center> 开源不易，且用且珍惜！</center>

赞助作者

转载请注明：溜爸 » uni-app 消息推送方案

正文完
android ios uni-app vue.js 消息推送
发表至：无分类
2019-11-06
 0