本文已授權(quán)微信公眾號 Android技術(shù)經(jīng)驗分享 獨家發(fā)布
轉(zhuǎn)載請注明出處：FCM---Android系統(tǒng)級推送---你還在用第三方推送？
Firebase Cloud Messaging
FCM是谷歌推出的最新的Android系統(tǒng)級別的消息推送服務（用來替換GCM）。
GCM(Google Cloud Message for Android)是Google發(fā)布的Android服務器推送（push）技術(shù)。
之前的C2DM(Android Cloud to Device Messaging)已與2012年6月26日被正式棄用。
注：國內(nèi)可接收FCM推送，但必須安裝谷歌服務。具體操作請參考官方文檔。
生命周期流程
下面是FCM的主要過程：
- Enabling FCM：運行在手機上注冊了來接收消息的Android程序。
- Sending a message：發(fā)送消息到手機的第三方程序服務器。
- Receiving a message：從GCM服務器接收消息的Android程序。
Android端設置
- 一項可以擴展 FirebaseMessagingService 的服務。如果您希望在后臺進行接收應用通知之外的任何消息處理，則必須添加此服務。要在前臺應用中接收通知、接收數(shù)據(jù)負載以及發(fā)送上游消息等，您必須擴展此服務。
- 一項可以擴展 FirebaseInstanceIdService 的服務，用于處理注冊令牌的創(chuàng)建、輪轉(zhuǎn)和更新。如果要發(fā)送至特定設備或者創(chuàng)建設備群組，則必須添加此服務。
通過替換 FirebaseMessagingService.onMessageReceived 方法，您可以根據(jù)收到的消息執(zhí)行操作，并獲取消息數(shù)據(jù)：
@Override
public void onMessageReceived(RemoteMessage remoteMessage) {
// ...
// TODO(developer): Handle FCM messages here.
// Not getting messages here? See why this may be: https://goo.gl/39bRNJ
Log.d(TAG, "From: " + remoteMessage.getFrom());
// Check if message contains a data payload.
if (remoteMessage.getData().size() > 0) {
Log.d(TAG, "Message data payload: " + remoteMessage.getData());
}
// Check if message contains a notification payload.
if (remoteMessage.getNotification() != null) {
Log.d(TAG, "Message Notification Body: " + remoteMessage.getNotification().getBody());
}
// Also if you intend on generating your own notifications as a result of a received FCM
// message, here is where that should be initiated. See sendNotification method below.
}
檢查 Google Play 服務 APK
實現(xiàn)連接服務器協(xié)議
Firebase Cloud Messaging服務器端包含兩個組件：
- GCM 連接服務器，由 Google 提供。這些服務器從一個應用服務器獲取消息，并將其發(fā)送至在設備上運行的客戶端應用。Google 為 HTTP 和 XMPP 提供連接服務器。
- 一臺應用服務器，您必須在您的環(huán)境中實現(xiàn)它。此應用服務器通過選定的FCM連接服務器，使用合適的 XMPP 或 HTTP 協(xié)議向客戶端應用發(fā)送數(shù)據(jù)。
實現(xiàn) HTTP 連接服務器協(xié)議
要對某個下游消息進行尋址或"確定其目標"，應用服務器需要將 to 設置為接收客戶端應用的注冊令牌。您可以發(fā)送帶有預定義字段的通知消息或自定義數(shù)據(jù)消息；請參閱消息負載中的通知和數(shù)據(jù)，了解關(guān)于負載支持的詳細信息。本頁中的示例用于說明如何通過 HTTP協(xié)議發(fā)送數(shù)據(jù)消息。
- HTTP POST 請求
https://fcm.googleapis.com/fcm/send
Content-Type:application/json
Authorization:key=AIzaSyZ-1u...0GBYzPu7Udno5aA
{ "data": {
"score": "5x1",
"time": "15:10"
},
"to" : "bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1..."
}
高級消息傳遞選項
| 屬性 | 范例 |
|---|---|
| Sender ID （發(fā)送者 ID） | 819786133815 |
| API Key （API 密鑰 ） | AAAAvt8PsTc:APA91bFjsbsccwMDjxr7m04Fm9qEKVesfpm_3Gdy-9Wv_TC33nmi-9o6ksbUK1eK-TIyn9q6khLF7MHRSqj0DbxPyN4SVPZED0cEFE5E9ysz5VIZFZkOUHjuws7cKKfhSNhlQ9cYgL7kcdcjIOi7xYVYyyWSOjCaew |
| Registration Token （注冊令牌） | 由 FCM SDK 為每個客戶端應用實例生成的 ID。 單一設備和設備群組消息傳遞需要該令牌。請注意，注冊令牌必須保密。 |
通知
要發(fā)送通知，可設置 notification 鍵并針對通知消息的用戶可見部分設置必要的預定義鍵選項集。
例如，這是 IM 應用中的 JSON 格式的通知消息。 用戶可能會在設備上看到標題為"Portugal vs. Denmark"、文本為"great match!"的消息：
- Authorization: key=AAAAvt8PsTc:APA91bFjsbsccwMDjxr7m04Fm9qEKVesfpm_3Gdy-9Wv_TC33nmi-9o6ksbUK1eK-
TIyn9q6khLF7MHRSqj0DbxPyN4SVPZED0cEFE5E9ysz5VIZFZkOUHjuws7cKKfhSNhlQ9cYgL7kcdcjIOi7xYVYyyWSOjCaew - Content-Type: application/json
//單個客戶端使用令牌通知
{
"to" : "eNh8RzL09LY:APA91bEKwVeY-FGl_h-9oTZ7BZQJ79xR_EtPBpnoq3ecuPwTpbLWgrVaTuqjoakDZCuf0SVVsc5QbnOOAWYpHuLH7_QYiwT7LE2XMSA_rokM6NB0HlwfcuY-oYNnZsqxveumhg7tR0G2",
"notification" : {
"body" : "great match!",
"title" : "Portugal vs. Denmark",
"icon" : "myicon"
}
}
{
"to" : "eV1M0ZMn3Qc:APA91bHQiquRmGUPSuK8KaTf3N1tVMKp43WvX1TnPWSOVuHw6imb8digKv-yIRyESweHvkK7I8lNtzRllDSXb9WVswD9kX5dGUfs3uAH3U_m0qJxcHUe_F9YIiCwI3lTNnzP_TRlNw1-",
"notification" : {
"body" : "great match!",
"title" : "Portugal vs. Denmark",
"icon" : "myicon"
}
}
//多個客戶端通知，使用registration_ids數(shù)組
{
"registration_ids" : ["eNh8RzL09LY:APA91bEKwVeY-FGl_h-9oTZ7BZQJ79xR_EtPBpnoq3ecuPwTpbLWgrVaTuqjoakDZCuf0SVVsc5QbnOOAWYpHuLH7_QYiwT7LE2XMSA_rokM6NB0HlwfcuY-oYNnZsqxveumhg7tR0G2",
"eV1M0ZMn3Qc:APA91bHQiquRmGUPSuK8KaTf3N1tVMKp43WvX1TnPWSOVuHw6imb8digKv-yIRyESweHvkK7I8lNtzRllDSXb9WVswD9kX5dGUfs3uAH3U_m0qJxcHUe_F9YIiCwI3lTNnzP_TRlNw1-",
"notification"]
"notification" : {
"body" : "是的。我成功了!",
"title" : "Portugal vs. Denmark",
"icon" : "myicon"
}
}
應用在后臺運行時，通知將會傳遞至通知托盤。 對于在后臺運行的應用，消息由下列回調(diào)處理：
- iOS 上的 didReceiveRemoteNotification:
- Android 上的 onMessageReceived()。數(shù)據(jù)包中的 notification 鍵包含通知。
設置消息優(yōu)先級
"priority" : "high",
下游消息語法
官方文檔 ： https://firebase.google.cn/docs/cloud-messaging/http-server-ref?hl=zh-cn#send-downstream
demo
http://www.itdecent.cn/p/5d1982dd588b
注意
當firebase推送的時候，是分當前應用在前后臺兩種情況的。當應用在前臺的時候，消息到來的時候會響應onMessageReceived函數(shù)，你就可以在里面想怎么處理就怎么處理了。當應用在后臺或者被殺掉的時候，這個函數(shù)是不會響應的，它會直接吧參數(shù)發(fā)送到啟動的Activity中，以下是google的文檔說明：
Handle messages in a backgrounded app
When your app is in the background, Android directs notification messages to the system tray. A user tap on the notification opens the app launcher by default.
This includes messages that contain both notification and data payload. In these cases, the notification is delivered to the device's system tray, and the data payload is delivered in the extras of the intent of your launcher Activity.
處理方式：在后臺的情況下你需要在應用的主Activity的onCreate方法中調(diào)用getIntent.getExtra()方法才能拿到推送到的參數(shù)
server 端建置
Google 稱開發(fā)者的 server 為 third party server，third party server 通常就是您的網(wǎng)站，至少要具備 2 個功能：
一是接收 Android 裝置上傳 GCM 註冊成功的 regId，
一是負責處理註銷 regId。
另外有個功能是用來發(fā)送訊息給 Android client 端 或 接收 client 端上傳的訊息，如果只有需要發(fā)送訊息的功能，那麼這支程式您可以放在您的網(wǎng)站(third party server)上 或是 放在公司內(nèi)某個部門的電腦內(nèi)；如果還要接收 client 端上傳的訊息，那這支程式就得放在您的網(wǎng)站上。
要納入考慮的是，當安裝您 app 的 Android 裝置數(shù)達成千上萬時，執(zhí)行網(wǎng)站上的 php 可能會有效率上的問題。
接收註冊的程式 gcm_register.php：
if(isset($_POST['regId']))
{
$regId = $_POST['regId'];
$sql = "INSERT INTO 資料表 (gcm_id,...) VALUES ('$regId',...)";
$pdo->exec($sql);
}
GCM 運作流程
安裝好的 app 第一次執(zhí)行時，app 會向 Google 註冊並取得 regId，app 成功取得 regId 後便將 regId 傳送給您網(wǎng)站 gcm_register.php，您可在 ADT 的 log 中看到取得的 regId；regId 長達 162 字元， 如果您想將 regId 儲存於資料庫系統(tǒng)內(nèi)，則您需要建立一個 table 存放 Android 裝置傳上來的 regId，存放 regId 的欄位長度最好大於 162 字元，因為以 Android 設備爆炸性成長的速度來看，如果愈來愈多開發(fā)人員採用 GCM，那麼 regId 長度勢必再增加...
當您的網(wǎng)站(third party server) 接收並儲存註冊 GCM 成功的 regId，爾後您的網(wǎng)站便可以發(fā)送訊息到已註冊的 app。
當您的 third party server 要發(fā)送訊息給有安裝您 app 的 Android 裝置時，您的 server 是將訊息發(fā)送給 Google GCM server，由 Google GCM server 再將訊息轉(zhuǎn)發(fā)給您 指定的 regId。
而當 Android 裝置解除安裝您的 app 時，Google GCM server 並不會立即通知您的 thrid party server，而是在下一次您發(fā)送訊息給該 Android 裝置時，Google GCM server 才會回應給您的 third party server 錯誤，錯誤的內(nèi)容是該裝置並未註冊，所以您的 third party server 要在此時將該裝置的 regId 從您的資料庫中刪除。
