極光推送是為 App 提供第三方推送服務(wù)的平臺之一,它提供四種消息形式:通知,自定義消息,富媒體和本地通知。
筆者將基于官方說明與個人理解來談一下這四種消息。本篇為 Android 篇, iOS 篇入口。
1.通知
Push Notification,即指在手機的通知欄(狀態(tài)欄)上會顯示的一條通知信息。
Android: 依靠 JPush service ,由 JPush SDK 實現(xiàn)在手機通知欄的展示。
Android 通知消息的流程是這樣的:
- 我們可以調(diào)用極光的 API 發(fā)起推送請求,也可以通過極光官網(wǎng)控制臺推送。
- 請求在參數(shù)要求上基本正確——請求成功,返回 msgid (這條消息的 ID 標(biāo)識),返回 200(成功)或由極光判斷的推送失?。ㄒ话闶?1011 找不到目標(biāo)的錯誤);參數(shù)錯誤,有返回錯誤碼。
- 極光服務(wù)器處理該請求:
- 若該 App 長連接正常,極光服務(wù)器就會把這條消息在線下發(fā)給它。
- 如果長連接是斷開的,那么就會免費保存 5 條離線消息。
- 如果該 App 在你推送消息時設(shè)定的離線保存時間(
time_to_live) 時間內(nèi),重連上了長連接,該條消息就會下發(fā)給 App 。 - 如果離線時間內(nèi),推送的消息超過5條,最先保存的消息會被刪掉。
- 如果過了
time_to_live,該條消息也會被刪掉,沒有收到的 App 就不會再收到了。
- 如果該 App 在你推送消息時設(shè)定的離線保存時間(
- 這里涉及到長連接斷開的問題:
- RTC 會定時發(fā)送心跳去觸發(fā)連接。
- 斷網(wǎng),關(guān)機,進程不在(被殺死),主動調(diào)用 stoppush 都會導(dǎo)致斷開。
- 一些手機系統(tǒng)的限制會導(dǎo)致斷網(wǎng)和進程不在。
- 解決辦法:添加極光提供的拉起服務(wù);文檔提示用戶對 App 進行保護。
Android 收不到消息的情況,極光社區(qū)也有一個總結(jié)說明。
- App 收到了通知,由 JPush SDK 進行展示,和 iOS 一樣,如果通知內(nèi)容( alert )為空,也是默認不展示的, 但能獲取到消息中的數(shù)據(jù),以作他用。
- 我們可以簡單的修改這個通知欄的樣式。
- 在客戶端定制了通知欄樣式后,需要使用該通知欄時,在推送的時候就 記得要寫對應(yīng)的通知欄編號。(API 推送時,V2 接口的字段是
n_builder_id,V3 接口的字段是builder_id。V2 功能較少,且在2015年已不再維護,建議大家盡快升級 V3 ,可以幫助我們更好的做推送。) - 這里容易有問題的是圖標(biāo)顯示不正常,解決方案:
- 若沒有
res/drawable-xxxx/jpush_notification_icon這個資源,那么通知欄默認使用應(yīng)用圖標(biāo)作為通知 icon 。 - 在 5.0 以上系統(tǒng)將應(yīng)用圖標(biāo)作為
statusbar icon可能顯示不正常,我們可以定義 沒有陰影和漸變色的 icon 同名替換res/drawable-xxxx/jpush_notification_icon這個文件。 - 應(yīng)該將 res 文件夾下的 所有 icon 文件都替換成自己的圖標(biāo)文件。
- 還有一個可能是:小米手機的 launcher 緩存可能有bug,按照上述要求配置好后, 重啟手機,再測試。
- 若沒有
- 點擊該條通知消息:
- 如果我們在
AndroidManifest.xml里沒有配置Action - cn.jpush.android.intent.NOTIFICATION_OPENED,JPush SDK 默認打開 App 首頁,相當(dāng)于點擊桌面圖標(biāo)的效果。 - 如果我們需要做點擊跳轉(zhuǎn),那么就得在
AndroidManifest.xml里配置此receiver action,SDK 在點擊后不會做動作。我們需要在自己寫的BroadcastReceiver類里處理,打開某Activity。 - 這里可能遇到的問題是:某些手機系統(tǒng)下,App 從后臺退出了,但是能收到通知消息,點擊卻沒有反應(yīng),無法跳轉(zhuǎn)。
- 可能的原因: Android 應(yīng)用退出后,可能長連接還存在,所以能收到消息,但是由于手機系統(tǒng)對 App 的限制,導(dǎo)致點擊通知欄不能重啟 App 成功。
- 解決辦法:打開手機系統(tǒng)的限制。
- 具體會出現(xiàn)該情況的手機系統(tǒng)和后臺退出后還能收到消息的前提條件(是否需要將 JPush 相關(guān)組件設(shè)置為一個獨立進程)等還沒有測試驗證過。
- 如果我們在
- Android 關(guān)閉通知:
可以達到關(guān)閉通知效果的有兩個辦法,我們可以根據(jù)自己的需求去選用,如果在 UI 層面加一個關(guān)閉的按鈕,那么對應(yīng)的代碼層面也是去選用這兩種 API 。-
調(diào)用 stoppush :
- 一種本地的狀態(tài)操作,相當(dāng)于手動終止 push 服務(wù)的效果,這個會導(dǎo)致同時關(guān)掉對所有類型消息的接收。
- 極光推送所有的其他 API 調(diào)用都無效。
- 必須調(diào)用 resumepush 才能恢復(fù)推送服務(wù)。
- 恢復(fù)后,如果推送的消息還在
time_to_live內(nèi),客戶端會收到這條消息。
- 置空別名/標(biāo)簽(極光官網(wǎng)有總結(jié)一個 別名的高級應(yīng)用場景可以仔細閱讀一下)
- 一般需求是:用戶退出登錄后不要收到通知。
對應(yīng)的操作是:項目的用戶退出登錄—置空別名—點擊登錄—重設(shè)別名。 - 如果用戶是直接殺死 A 手機的 App ,然后在 B 手機登錄。
若你們不允許多設(shè)備登錄,希望 A 手機不再收到消息,那么應(yīng)該在自己的后臺判斷出 A 用戶“ 換了設(shè)備登錄” ,讓 A 手機自動做登出操作,在客戶端置空別名;
或者在服務(wù)端調(diào)用極光的 API 去置空 A 手機設(shè)置的別名。
(判斷的方法可以是:將用戶某唯一信息與獲取到的 registrationID 一起上傳,registrationID 與之前相比改變了,則判斷為更換了設(shè)備。) -
需要注意:別名置空 至 重設(shè)別名 期間,推送的消息, 在重設(shè)別名后,設(shè)備不會收到。
若需要這期間的消息也被收到,需要自己服務(wù)器對此進行判斷、保存、并在客戶端重設(shè)別名后,重新向極光發(fā)起推送請求。
若需要用戶的歷史推送消息可被查詢,需要自己服務(wù)器那邊去保存。
- 一般需求是:用戶退出登錄后不要收到通知。
-
調(diào)用 stoppush :
2.自定義消息
iOS 需要當(dāng) App 處于前臺才能收到,Android 不需要處于前臺。
幾個特點
- 只接收,不展示,需要我們自己做接收處理,并且自己代碼實現(xiàn) 通知欄,或者轉(zhuǎn)為本地通知來展示。
- 需要依靠 App 與極光服務(wù)器建立的長連接。
- Android 需要我們在
AndroidManifest.xml里配置Action - cn.jpush.android.intent.MESSAGE_RECEIVED,并且在自己寫的BroadcastReceiver里接收處理,詳細看官方文檔說明。
什么時候使用它?
主要用于應(yīng)用的內(nèi)部業(yè)務(wù)邏輯和特殊展示需求,譬如:
- 需要自定義通知欄時(Android 要播放自定義的聲音文件等情況)。
- 在 App 項目內(nèi)的消息提醒。
- 有條件的消息提醒(譬如只讓處在某一頁面的用戶看到該條消息)。
可能會犯的錯誤
弄混自定義內(nèi)容(字段 extras)與自定義消息(Message)
- 一般會出現(xiàn)的疑問是: Android 點擊通知欄無法獲取到自定義的內(nèi)容
- 推送時 extras 是寫在 Notification 下還是 Message 下?
- 點擊 SDK 的通知欄 用
JPushInterface.EXTRA_EXTRA獲取的是寫在 Notification 下的 extras 信息,沒法獲取寫在 Message 下的 extras。 - Message 消息和 Notification 消息 分別有各自的參數(shù),不要混用。
3.富媒體
可以推送 Web頁面、圖片、聲音等除普通文本之外更豐富的內(nèi)容。
- 兩種:信:息流模板推送、URL 富媒體鏈接推送
- 信息流模板推送
- 推送 Web 頁面(富文本);
- 極光官網(wǎng)控制臺上有創(chuàng)建富文本頁面的功能模塊,提供了5種模板;
- 富文本作為通知推送到客戶端;
- 客戶端點擊通知,自動展示該富文本頁面。
- URL 富媒體鏈接推送
- 推送某個頁面的 URL ,點擊通知欄消息后跳轉(zhuǎn)到這個 URL 指定的頁面。
- 信息流模板推送
- 僅支持 Android ,需要JPush Android SDK 1.8.0 及以上。
- 只能通過極光推送的控制臺發(fā)送。
- 必須將壓縮包 res 中的資源放到我們自己的項目的對應(yīng)文件夾,并按照官方示例
AndroidManifest配置 PushActivity 組件。
4.本地通知
適用于在特定時間發(fā)出的通知,如一些Todo和鬧鐘類的應(yīng)用,在每周、每月固定時間提醒用戶回到應(yīng)用查看任務(wù)
幾個特點
- 不依賴于網(wǎng)絡(luò),無網(wǎng)也可以觸發(fā)。
- 定時時間是自發(fā)送時算起,不受中間關(guān)機等操作的影響。
- 本地通知與遠程推送的通知是相互獨立的,不受 保留最近通知條數(shù)上限(Android)的限制。
- Android 依舊需要 App 應(yīng)用程序在運行。
規(guī)則
- 本地推送保存在本地的 db 中,時間上的控制也是從 db 里面取。
- 關(guān)機或者殺進程后將收不到本地通知。
- 進程重啟后,會檢測 db ,準(zhǔn)備設(shè)定時間在此之后的本地通知的推送。
- 本地通知的時間也依賴于每4分50秒的心跳來檢測,所以并不能特別精準(zhǔn)地剛好到了通知時間你剛好啟動了進程,就能收到推送,會有一定偏差。