meteor cordova实现苹果App消息推送

业务需求

先简单说一下我要实现的业务需求:就是当有用户下单的时候,把消息推送给供货商的工作人员,提醒他们进行备货,这次主要是实现了下面的四个功能。

  1. 定点推送,指定给某台或者多台手机发送推送
  2. 推送到达后APP的角标数量
  3. 推送到手机后,播放特定的手机消息提示语音
  4. 点击推送的消息跳到指定的页面

推送原理

首先我先简单的讲一下iOSApp的推送的原理,所有的iOSApp的消息推送都要经过APNs(Apple Push Notification service),然后再由APNs发送给设备,然后设备再将数据传递给指定的APP,具体见下图:


notification.png

开发前准备

先要在苹果的开发者网站完成消息推送的配置,具体参考:https://www.jianshu.com/p/fe03f41a17eb

然后注册一个极光推送的账号完成里面的关于iOS的推送配置,同时拿到极光推送的AppKey和Master Secret。参考网址:https://www.jiguang.cn/

功能实现

首先介绍一下我的开发环境:

MacBook Pro系统版本:10.13.6
Xcode版本:10.0
meteor版本:1.4.2.3
调试机型iPhone 8 plus系统版本:12.0

先安装极光推送的cordova包,同时在mobile-config里面配置好APP_KEY

meteor add cordova:[email protected]      //安装cordova包

App.configurePlugin('jpush-phonegap-plugin', {    // 配置APP_KEY
    'APP_KEY': '4xxxxxxxxxxxxxxx03',
});

使用cordova的也可以直接参考极光推送的文档:https://www.npmjs.com/package/jpush-phonegap-plugin

极光推送的api文档参考这个链接:https://github.com/jpush/jpush-phonegap-plugin/blob/HEAD/doc/Common_detail_api.md

  1. 首先初始化极光推送(完成这个步骤已经可以再极光推送后台给所有的用户推送消息了)
document.addEventListener('deviceready', onDeviceReady, false);
function onDeviceReady() {
    if (JPush) {
            JPush.init(); // 初始化极光推送
            JPush.resetBadge();// 每次进入APP将APP角标的数字清除
    }
}
  1. 拿到用户的registrationID(这个是根据用户的devicetoken然后由极光推送生成的一个唯一ID,用于给固定的registrationID推送消息)
JPush.getRegistrationID((regId) => {
        console.log(regId); // 存储到数据库,然后根据这个ID进行定点推送
 });
  1. 每次在打开APP和唤醒APP的时候要将角标数字清除
JPush.resetBadge();// 将APP角标的数字清除
  1. 在收到订单后,发送HTTP请求主动调起给固定的用户发出推送,这个要调用极光推送暴露的rest api参考文档:https://docs.jiguang.cn/jpush/server/push/rest_api_v3_push/
{"platform":["ios"],"audience":{"registration_id:["4312kjklfds2"]"},"notification":{"ios":{"alert":"Hi, test!","sound":"warn.wav","badge":"+1","extras":{"name":"chuck","route":"myOrder"}}},"options":{"apns_production":false}}
// 这是请求的body里面的一个示例(可以用postman发送请求调试)

5.修改收到推送的语音,将语音文件放到xcode项目的根目录下,目前只支持三种格式的语音文件aiff, wav, 或者 caf。然后调用的时候把sound参数传你的文件名,可以看上面那个请求示例。


sound.png

6.点击推送的消息跳转到指定的页面。极光推送有个事件专门捕捉用户点击推送的事件。

document.addEventListener("jpush.openNotification", function (event) {
  console.log(event); // 这个event对象包含你在发送HTTP请求是传的extras里面的数据,根据这个去判断你需要执行的操作
}, false)

注意事项

  1. Xcode打包时要注意将Capabilities里面的Push Notifications的开关打开
  2. Xcode10遇到所有的操作都成功但是还收不到推送,可以点击File>Project Settings将Build System选择为Legacy Build System
  3. 还有一种是devicetoken没有上传到极光推送服务,这样也会收不到消息推送,这个在给手机打包的时候在xcode的控制台上可以看到log输出,可以查看是否devicetoken成功上传。

参考文档

  • 苹果的官方消息推送接口文档
  • 提示语音文件参考文档
  • 极光推送的npm安装文档
  • 极光推送api文档
  • 极光推送rest api文档
  • 苹果消息推送的配置参考文档

最后若对文章有什么疑问可以在评论区指出

你可能感兴趣的:(meteor cordova实现苹果App消息推送)