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