Firebase 通知的行為會因接收應用程式的前景/背景狀態而異。如果您希望前景應用程式接收通知訊息或資料訊息,就必須編寫程式碼來處理 onMessageReceived
回呼。如需通知與資料訊息之間的差異,請參閱訊息類型。
處理訊息
如要接收訊息,請使用擴充
FirebaseMessagingService
的服務。您的服務應覆寫 onMessageReceived
和 onDeletedMessages
回呼。
處理訊息的時間可能短於 20 秒,視呼叫 onMessageReceived
前產生的延遲而定,包括 OS 延遲、應用程式啟動時間、主要執行緒遭到其他作業封鎖,或先前的 onMessageReceived
呼叫耗時過長。之後,各種作業系統行為 (例如 Android 程序終止或 Android O 的
背景執行限制) 都有可能幹擾您完成工作。
大多數訊息類型都會提供 onMessageReceived
,以下為例外狀況:
-
應用程式在背景執行時顯示的通知訊息。在這種情況下,通知會傳送至裝置的系統匣。根據預設,使用者只要輕觸通知,即可開啟應用程式啟動器。
-
在背景接收時,具有通知和資料酬載的訊息。在此情況下,通知會傳送至裝置的系統匣,而資料酬載則會隨啟動器活動的額外意圖傳送。
簡單來說:
應用程式狀態 | 通知 | 資料 | 兩者並用 |
---|---|---|---|
前景 | onMessageReceived |
onMessageReceived |
onMessageReceived |
背景 | 系統匣 | onMessageReceived |
通知:系統匣 資料:意圖的額外資料。 |
編輯應用程式資訊清單
如要使用 FirebaseMessagingService
,您必須在應用程式資訊清單中新增以下內容:
<service android:name=".java.MyFirebaseMessagingService" android:exported="false"> <intent-filter> <action android:name="com.google.firebase.MESSAGING_EVENT" /> </intent-filter> </service>
此外,建議您設定預設值,自訂通知的外觀。您可以指定自訂預設圖示和自訂預設顏色,只要通知酬載未設定同等的值,系統就會套用該顏色。
在 application
標記中加入以下幾行,即可設定自訂預設圖示和自訂顏色:
<!-- Set custom default icon. This is used when no icon is set for incoming notification messages. See README(https://goo.gl/l4GJaQ) for more. --> <meta-data android:name="com.google.firebase.messaging.default_notification_icon" android:resource="@drawable/ic_stat_ic_notification" /> <!-- Set color used with incoming notification messages. This is used when no color is set for the incoming notification message. See README(https://goo.gl/6BKBk7) for more. --> <meta-data android:name="com.google.firebase.messaging.default_notification_color" android:resource="@color/colorAccent" />
Android 會顯示自訂預設圖示
- 從 通知編輯器傳送的所有通知訊息。
- 未明確設定通知酬載中圖示的任何通知訊息。
Android 會使用自訂預設顏色
- 從 通知編輯器傳送的所有通知訊息。
- 未明確設定通知酬載中顏色的任何通知訊息。
如果沒有設定自訂預設圖示,也未在通知酬載中設定圖示,Android 會以白色顯示應用程式圖示。
覆寫 onMessageReceived
覆寫 FirebaseMessagingService.onMessageReceived
方法後,即可根據收到的 RemoteMessage 物件執行操作並取得訊息資料:
Kotlin+KTX
override fun 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.from}") // Check if message contains a data payload. if (remoteMessage.data.isNotEmpty()) { Log.d(TAG, "Message data payload: ${remoteMessage.data}") // Check if data needs to be processed by long running job if (needsToBeScheduled()) { // For long-running tasks (10 seconds or more) use WorkManager. scheduleJob() } else { // Handle message within 10 seconds handleNow() } } // Check if message contains a notification payload. remoteMessage.notification?.let { Log.d(TAG, "Message Notification Body: ${it.body}") } // 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. }
Java
@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()); if (/* Check if data needs to be processed by long running job */ true) { // For long-running tasks (10 seconds or more) use WorkManager. scheduleJob(); } else { // Handle message within 10 seconds handleNow(); } } // 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. }
覆寫 onDeletedMessages
在某些情況下,FCM 可能無法傳送訊息,如果在某個裝置上連線時,應用程式在特定裝置上有過多待處理的訊息 (>100 個),或是裝置在一個月內未連結至 FCM,就會發生這種情況。在這類情況下,您可能會收到對 FirebaseMessagingService.onDeletedMessages()
的回呼。當應用程式執行個體收到此回呼時,應該與應用程式伺服器執行完整同步。如果您在過去 4 週內沒有在該裝置上傳送訊息給應用程式,FCM 就不會呼叫 onDeletedMessages()
。
在背景執行應用程式中處理通知訊息
當應用程式在背景運作時,Android 會將通知訊息導向至系統匣。根據預設,使用者輕觸通知會開啟應用程式啟動器。
這包括包含通知和資料酬載的訊息,以及從通知主控台傳送的所有訊息。在這類情況下,通知會傳送至裝置的系統匣,而資料酬載會隨啟動器活動的額外意圖提供。
如要深入瞭解傳送給應用程式的訊息,請參閱 FCM 報告資訊主頁,其中記錄在 Apple 和 Android 裝置上傳送及開啟的訊息數,以及 Android 應用程式的「曝光」(使用者看到的通知) 資料。
透過直接啟動模式接收 FCM 訊息
如果開發人員想在裝置解鎖前傳送 FCM 訊息給應用程式,可以讓 Android 應用程式在裝置處於直接啟動模式時接收訊息。例如,您可能希望應用程式的使用者在鎖定裝置時接收鬧鐘通知。
建構此用途時,請觀察直接啟動模式的一般最佳做法和限制。請務必考量直接啟動功能訊息的瀏覽權限;凡是可存取裝置的使用者,不必輸入使用者憑證就能查看這些訊息。
先備知識
- 必須將裝置設為直接啟動模式。
- 裝置必須安裝最新版本的 Google Play 服務 (19.0.54 以上版本)。
- 應用程式必須使用 FCM SDK (
com.google.firebase:firebase-messaging
) 才能接收 FCM 訊息。
在應用程式中啟用直接啟動模式訊息處理功能
在應用程式層級的 Gradle 檔案中,新增 FCM 直接啟動支援資料庫的依附元件:
implementation 'com.google.firebase:firebase-messaging-directboot:20.2.0'
請在應用程式資訊清單中新增
android:directBootAware="true"
屬性,讓應用程式的FirebaseMessagingService
直接啟動感知特性:<service android:name=".java.MyFirebaseMessagingService" android:exported="false" android:directBootAware="true"> <intent-filter> <action android:name="com.google.firebase.MESSAGING_EVENT" /> </intent-filter> </service>
請務必確保這個 FirebaseMessagingService
能在直接啟動模式下執行。請檢查下列要求:
- 服務在直接啟動模式下執行時,不應存取受憑證保護的儲存空間。
- 服務不應嘗試在直接啟動模式下,使用未標示為直接啟動感知的元件,例如
Activities
、BroadcastReceivers
或其他Services
。 - 這項服務使用的任何程式庫也不得在直接啟動模式下存取受憑證保護的儲存空間,或呼叫非 directBootAware 元件。這表示應用程式從服務呼叫的所有程式庫皆須具備直接啟動感知特性,或者應用程式必須檢查應用程式是否在直接啟動模式下執行,且未在該模式下呼叫這些程式庫。舉例來說,Firebase SDK 可透過直接啟動功能運作,這類 SDK 可在不直接啟動模式下造成應用程式當機,但許多 Firebase API 都不支援在直接啟動模式下呼叫。
- 如果應用程式使用自訂
Application
,則Application
也必須具備直接啟動感知能力 (無法在直接啟動模式下存取受憑證保護的儲存空間)。
如需以直接啟動模式傳送訊息至裝置的相關指引,請參閱「傳送已啟用直接啟動功能的訊息」。