Odbieranie wiadomości w aplikacji na Androida

Powiadomienia Firebase zachowują się różnie w zależności od stanu pierwszego planu/tła aplikacji odbierającej. Jeśli chcesz, aby aplikacje na pierwszym planie otrzymywały powiadomienia lub komunikaty z danymi, musisz napisać kod obsługujący wywołanie zwrotne onMessageReceived. Wyjaśnienie różnicy między powiadomieniami a komunikatami z danymi znajdziesz w artykule Typy wiadomości.

Obsługa wiadomości

Aby odbierać wiadomości, użyj usługi, która obejmuje rozszerzenie FirebaseMessagingService. Usługa powinna zastąpić wywołania zwrotne onMessageReceived i onDeletedMessages.

Czas obsługi wiadomości może być krótszy niż 20 sekund w zależności od opóźnień przed wywołaniem funkcji onMessageReceived, w tym opóźnień systemu operacyjnego, czasu uruchamiania aplikacji, zablokowania wątku głównego przez inne operacje lub poprzednich wywołań onMessageReceived, które trwały zbyt długo. Po tym czasie różne działania systemu operacyjnego, takie jak zatrzymywanie procesów na Androidzie lub limity wykonywania w tle, mogą zakłócać Twoją zdolność do pracy.

Dla większości typów wiadomości jest przeznaczona onMessageReceived, z tymi wyjątkami:

• Powiadomienia z powiadomieniami dostarczane, gdy aplikacja działa w tle. W takim przypadku powiadomienie pojawi się w obszarze powiadomień urządzenia. Gdy użytkownik kliknie powiadomienie, domyślnie otworzy się Menu z aplikacjami.

• Wiadomości z powiadomieniami i ładunkiem danych odebrane w tle W takim przypadku powiadomienie jest dostarczane do obszaru powiadomień urządzenia, a ładunek danych jest dostarczany w ramach dodatków do intencji działania programu uruchamiającego.

W skrócie:

Edytuj plik manifestu aplikacji

Aby używać FirebaseMessagingService, w manifeście aplikacji musisz dodać te elementy:

<service
    android:name=".java.MyFirebaseMessagingService"
    android:exported="false">
    <intent-filter>
        <action android:name="com.google.firebase.MESSAGING_EVENT" />
    </intent-filter>
</service>
AndroidManifest.xml

Zalecamy też ustawienie wartości domyślnych, aby dostosować wygląd powiadomień. Możesz podać niestandardową ikonę domyślną i niestandardowy kolor domyślny, które będą stosowane za każdym razem, gdy w ładunku powiadomień nie zostaną ustawione równoważne wartości.

Aby ustawić niestandardową ikonę domyślną i kolor niestandardowy, dodaj te wiersze wewnątrz tagu 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" />
AndroidManifest.xml

Android wyświetla niestandardową ikonę domyślną

• Wszystkie powiadomienia wysłane z Kreatora powiadomień.
• Wszystkie komunikaty z powiadomieniami, które nie mają wyraźnie określonej ikony w ładunku powiadomień.

Android używa niestandardowego koloru domyślnego dla

• Wszystkie powiadomienia wysłane z Kreatora powiadomień.
• Wszystkie komunikaty z powiadomieniami, które nie mają wyraźnie ustawionego koloru w ładunku powiadomień.

Jeśli nie ustawiono niestandardowej ikony domyślnej i nie ustawiono żadnej ikony w ładunku powiadomień, Android wyświetla ikonę aplikacji wyrenderowaną na biało.

Zastąp onMessageReceived

Zastępując metodę FirebaseMessagingService.onMessageReceived, możesz wykonywać działania na podstawie otrzymanego obiektu RemoteMessage i pobierać dane wiadomości:

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.
}
MyFirebaseMessagingService.kt

@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.
}
MyFirebaseMessagingService.java

Zastąp onDeletedMessages

Obsługuj wiadomości z powiadomieniami w aplikacji działającej w tle

Gdy aplikacja działa w tle, Android przekierowuje powiadomienia do obszaru powiadomień. Gdy użytkownik kliknie powiadomienie, domyślnie otworzy się Menu z aplikacjami.

Obejmuje to wiadomości, które zawierają zarówno powiadomienia, jak i ładunek danych (oraz wszystkie wiadomości wysłane z konsoli powiadomień). W takich przypadkach powiadomienie jest dostarczane do obszaru powiadomień urządzenia, a ładunek danych jest dostarczany w ramach dodatków do intencji działania programu uruchamiającego.

Informacje o dostarczaniu wiadomości do Twojej aplikacji znajdziesz w panelu raportowania FCM, który rejestruje liczbę wysłanych i otwartych wiadomości na urządzeniach Apple i z Androidem oraz dane o „wyświetleniach” (powiadomieniach widocznych dla użytkowników) w aplikacjach na Androida.

Odbieranie wiadomości FCM w trybie bezpośredniego rozruchu

Deweloperzy, którzy chcą wysyłać wiadomości FCM do aplikacji jeszcze przed odblokowaniem urządzenia, mogą umożliwić aplikacji na Androida odbieranie wiadomości, gdy urządzenie jest w trybie bezpośredniego rozruchu. Możesz na przykład chcieć, aby użytkownicy aplikacji otrzymywali powiadomienia o alarmach nawet na zablokowanym urządzeniu.

Tworząc ten przypadek użycia, przestrzegaj ogólnych sprawdzonych metod i ograniczeń dotyczących trybu bezpośredniego rozruchu. Szczególnie należy wziąć pod uwagę widoczność komunikatów podczas bezpośredniego rozruchu, ponieważ każdy użytkownik, który ma dostęp do urządzenia, może je wyświetlić bez podawania danych logowania.

Wymagania wstępne

• Urządzenie musi być skonfigurowane do trybu bezpośredniego rozruchu.
• Na urządzeniu musi być zainstalowana najnowsza wersja Usług Google Play (19.0.54 lub nowsza).
• Aby otrzymywać wiadomości FCM, aplikacja musi używać pakietu SDK FCM (com.google.firebase:firebase-messaging).

Włącz w swojej aplikacji obsługę wiadomości w trybie bezpośredniego rozruchu

1. W pliku Gradle na poziomie aplikacji dodaj zależność od biblioteki pomocy bezpośredniego rozruchu FCM:

   implementation 'com.google.firebase:firebase-messaging-directboot:20.2.0'
   

2. Poinformuj klienta o bezpośrednim rozruchu FirebaseMessagingService aplikacji, dodając atrybut android:directBootAware="true" w manifeście aplikacji:

   <service
       android:name=".java.MyFirebaseMessagingService"
       android:exported="false"
       android:directBootAware="true">
       <intent-filter>
           <action android:name="com.google.firebase.MESSAGING_EVENT" />
       </intent-filter>
   </service>
   

Ważne jest, aby to urządzenie FirebaseMessagingService mogło działać w trybie bezpośredniego rozruchu. Sprawdź, czy spełniasz te wymagania:

• Usługa nie powinna uzyskiwać dostępu do pamięci chronionej danymi uwierzytelniającymi podczas działania w trybie bezpośredniego rozruchu.
• Usługa nie powinna próbować używać komponentów takich jak Activities, BroadcastReceivers czy inne Services, które nie są oznaczone jako będące wykrywaniem bezpośredniego rozruchu w trybie rozruchu bezpośredniego.
• Biblioteki używane przez usługę nie mogą też uzyskiwać dostępu do pamięci chronionej danymi uwierzytelniającymi ani wywoływać komponentów niebezpośrednich w trybie rozruchu w trybie bezpośredniego rozruchu. Oznacza to, że wszystkie używane przez aplikację biblioteki wywoływane z usługi będą musiały obsługiwać bezpośrednie rozruchy lub aplikacja będzie musiała sprawdzić, czy działa w trybie bezpośredniego rozruchu, i nie wywoływać ich w tym trybie. Na przykład pakiety SDK Firebase obsługują rozruch bezpośredni (można je włączyć do aplikacji bez jej awarii w trybie bezpośredniego rozruchu), ale wiele interfejsów API Firebase nie obsługuje wywoływania w trybie bezpośredniego rozruchu.
• Jeśli aplikacja używa niestandardowego Application, Application też musi obsługiwać bezpośrednie rozruchy (brak dostępu do pamięci chronionej danymi uwierzytelniającymi w trybie bezpośredniego rozruchu).

Wskazówki dotyczące wysyłania wiadomości na urządzenia w trybie bezpośredniego rozruchu znajdziesz w artykule Wysyłanie wiadomości przy włączaniu bezpośredniego rozruchu.