業(yè)務(wù)需求
先簡(jiǎn)單說(shuō)一下我要實(shí)現(xiàn)的業(yè)務(wù)需求：就是當(dāng)有用戶下單的時(shí)候危彩，把消息推送給供貨商的工作人員徒欣，提醒他們進(jìn)行備貨逐样，這次主要是實(shí)現(xiàn)了下面的四個(gè)功能。
- 定點(diǎn)推送打肝，指定給某臺(tái)或者多臺(tái)手機(jī)發(fā)送推送
- 推送到達(dá)后APP的角標(biāo)數(shù)量
- 推送到手機(jī)后脂新，播放特定的手機(jī)消息提示語(yǔ)音
- 點(diǎn)擊推送的消息跳到指定的頁(yè)面
推送原理
首先我先簡(jiǎn)單的講一下iOSApp的推送的原理，所有的iOSApp的消息推送都要經(jīng)過(guò)APNs(Apple Push Notification service),然后再由APNs發(fā)送給設(shè)備粗梭，然后設(shè)備再將數(shù)據(jù)傳遞給指定的APP争便，具體見(jiàn)下圖：
開(kāi)發(fā)前準(zhǔn)備
先要在蘋(píng)果的開(kāi)發(fā)者網(wǎng)站完成消息推送的配置，具體參考：http://www.reibang.com/p/fe03f41a17eb
然后注冊(cè)一個(gè)極光推送的賬號(hào)完成里面的關(guān)于iOS的推送配置断医，同時(shí)拿到極光推送的AppKey和Master Secret滞乙。參考網(wǎng)址：https://www.jiguang.cn/
功能實(shí)現(xiàn)
首先介紹一下我的開(kāi)發(fā)環(huán)境：
MacBook Pro系統(tǒng)版本：10.13.6
Xcode版本：10.0
meteor版本：1.4.2.3
調(diào)試機(jī)型iPhone 8 plus系統(tǒng)版本:12.0
先安裝極光推送的cordova包奏纪，同時(shí)在mobile-config里面配置好APP_KEY
meteor add cordova:jpush-phonegap-plugin@3.4.7 //安裝cordova包
App.configurePlugin('jpush-phonegap-plugin', { // 配置APP_KEY
'APP_KEY': '4xxxxxxxxxxxxxxx03',
});
使用cordova的也可以直接參考極光推送的文檔:https://www.npmjs.com/package/jpush-phonegap-plugin
極光推送的api文檔參考這個(gè)鏈接：https://github.com/jpush/jpush-phonegap-plugin/blob/HEAD/doc/Common_detail_api.md
- 首先初始化極光推送（完成這個(gè)步驟已經(jīng)可以再極光推送后臺(tái)給所有的用戶推送消息了）
document.addEventListener('deviceready', onDeviceReady, false);
function onDeviceReady() {
if (JPush) {
JPush.init(); // 初始化極光推送
JPush.resetBadge();// 每次進(jìn)入APP將APP角標(biāo)的數(shù)字清除
}
}
- 拿到用戶的registrationID（這個(gè)是根據(jù)用戶的devicetoken然后由極光推送生成的一個(gè)唯一ID，用于給固定的registrationID推送消息）
JPush.getRegistrationID((regId) => {
console.log(regId); // 存儲(chǔ)到數(shù)據(jù)庫(kù)酷宵，然后根據(jù)這個(gè)ID進(jìn)行定點(diǎn)推送
});
- 每次在打開(kāi)APP和喚醒APP的時(shí)候要將角標(biāo)數(shù)字清除
JPush.resetBadge();// 將APP角標(biāo)的數(shù)字清除
- 在收到訂單后亥贸，發(fā)送HTTP請(qǐng)求主動(dòng)調(diào)起給固定的用戶發(fā)出推送，這個(gè)要調(diào)用極光推送暴露的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}}
// 這是請(qǐng)求的body里面的一個(gè)示例（可以用postman發(fā)送請(qǐng)求調(diào)試）
5.修改收到推送的語(yǔ)音浇垦，將語(yǔ)音文件放到xcode項(xiàng)目的根目錄下，目前只支持三種格式的語(yǔ)音文件aiff, wav, 或者 caf荣挨。然后調(diào)用的時(shí)候把sound參數(shù)傳你的文件名男韧，可以看上面那個(gè)請(qǐng)求示例。
6.點(diǎn)擊推送的消息跳轉(zhuǎn)到指定的頁(yè)面默垄。極光推送有個(gè)事件專門捕捉用戶點(diǎn)擊推送的事件此虑。
document.addEventListener("jpush.openNotification", function (event) {
console.log(event); // 這個(gè)event對(duì)象包含你在發(fā)送HTTP請(qǐng)求是傳的extras里面的數(shù)據(jù)，根據(jù)這個(gè)去判斷你需要執(zhí)行的操作
}, false)
注意事項(xiàng)
- Xcode打包時(shí)要注意將Capabilities里面的Push Notifications的開(kāi)關(guān)打開(kāi)
- Xcode10遇到所有的操作都成功但是還收不到推送口锭，可以點(diǎn)擊File>Project Settings將Build System選擇為L(zhǎng)egacy Build System
- 還有一種是devicetoken沒(méi)有上傳到極光推送服務(wù)朦前，這樣也會(huì)收不到消息推送，這個(gè)在給手機(jī)打包的時(shí)候在xcode的控制臺(tái)上可以看到log輸出鹃操，可以查看是否devicetoken成功上傳韭寸。
