业务需求
先简单说一下我要实现的业务需求:就是当有用户下单的时候,把消息推送给供货商的工作人员,提醒他们进行备货,这次主要是实现了下面的四个功能。
- 定点推送,指定给某台或者多台手机发送推送
- 推送到达后APP的角标数量
- 推送到手机后,播放特定的手机消息提示语音
- 点击推送的消息跳到指定的页面
推送原理
首先我先简单的讲一下iOSApp的推送的原理,所有的iOSApp的消息推送都要经过APNs(Apple Push Notification service),然后再由APNs发送给设备,然后设备再将数据传递给指定的APP,具体见下图:
开发前准备
先要在苹果的开发者网站完成消息推送的配置,具体参考: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
- 首先初始化极光推送(完成这个步骤已经可以再极光推送后台给所有的用户推送消息了)
document.addEventListener('deviceready', onDeviceReady, false);
function onDeviceReady() {
if (JPush) {
JPush.init(); // 初始化极光推送
JPush.resetBadge();// 每次进入APP将APP角标的数字清除
}
}
- 拿到用户的registrationID(这个是根据用户的devicetoken然后由极光推送生成的一个唯一ID,用于给固定的registrationID推送消息)
JPush.getRegistrationID((regId) => {
console.log(regId); // 存储到数据库,然后根据这个ID进行定点推送
});
- 每次在打开APP和唤醒APP的时候要将角标数字清除
JPush.resetBadge();// 将APP角标的数字清除
- 在收到订单后,发送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参数传你的文件名,可以看上面那个请求示例。
6.点击推送的消息跳转到指定的页面。极光推送有个事件专门捕捉用户点击推送的事件。
document.addEventListener("jpush.openNotification", function (event) {
console.log(event); // 这个event对象包含你在发送HTTP请求是传的extras里面的数据,根据这个去判断你需要执行的操作
}, false)
注意事项
- Xcode打包时要注意将Capabilities里面的Push Notifications的开关打开
- Xcode10遇到所有的操作都成功但是还收不到推送,可以点击File>Project Settings将Build System选择为Legacy Build System
- 还有一种是devicetoken没有上传到极光推送服务,这样也会收不到消息推送,这个在给手机打包的时候在xcode的控制台上可以看到log输出,可以查看是否devicetoken成功上传。
参考文档
- 苹果的官方消息推送接口文档
- 提示语音文件参考文档
- 极光推送的npm安装文档
- 极光推送api文档
- 极光推送rest api文档
- 苹果消息推送的配置参考文档