Odbieranie wiadomości w aplikacji na Androida

Powiadomienia Firebase działają różnie w zależności od pierwszego planu lub tła stanu aplikacji odbierającej. Jeśli chcesz, aby aplikacje na pierwszym planie otrzymywały dostęp wiadomości z powiadomieniami lub wiadomości z danymi, musisz napisać kod do obsługi wywołanie zwrotne onMessageReceived. Aby wyjaśnić różnicę między powiadomieniami a komunikatami z danymi, Więcej informacji: Typy wiadomości.

Obsługa wiadomości

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

Czas przetwarzania wiadomości może być krótszy niż 20 sekund w zależności od opóźnień naliczone przed zadzwonieniem pod numer onMessageReceived, w tym opóźnienia systemu operacyjnego, czas uruchomienia aplikacji, wątek główny jest blokowany przez inne operacje lub poprzedni onMessageReceived trwa zbyt długo. Po tym czasie różne zachowania systemu operacyjnego, takie jak zabijanie procesów w Androidzie lub ograniczenia dotyczące wykonywania procesów w tle w Androidzie O, mogą utrudniać Ci dokończenie pracy.

onMessageReceived jest dostępna w przypadku większości typów wiadomości, z tymi wyjątkami:

• Powiadomienia wysyłane, gdy aplikacja działa w tle. W takim przypadku powiadomienie jest dostarczane do obszaru powiadomień urządzenia. Użytkownik klika powiadomienie domyślnie otwiera Menu z aplikacjami.

• Wiadomości z powiadomieniami i ładunkiem danych odebrane w tle W takim przypadku powiadomienie pojawi się w obszarze powiadomień. ładunek danych jest dostarczany w elementach dodatkowych intencji związanych z aktywnością programu uruchamiającego.

W skrócie:

Edytuj plik manifestu aplikacji

Aby używać FirebaseMessagingService, musisz dodać do pliku manifestu aplikacji:

<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ń. Ty pozwala określić niestandardową ikonę domyślną i niestandardowy kolor domyślny, który będzie stosowany nie są ustawione w ładunku powiadomień.

Aby ustawić niestandardową ikonę domyślną i niestandardowy kolor, dodaj te wiersze w 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ą w przypadku

• Wszystkie powiadomienia wysyłane z Edytor 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 wysyłane z narzędzi do tworzenia powiadomień.
• każda wiadomość, która nie ustawia koloru w swoim ładunku;

Jeśli nie ustawisz żadnej niestandardowej ikony domyślnej i nie ustawisz ż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 otrzymanych Zdalna_wiadomość i pobierz 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ługa powiadomień w aplikacji działającej w tle

Gdy aplikacja działa w tle, Android przekierowuje powiadomienia na w obszarze powiadomień. Kliknięcie powiadomienia powoduje domyślnie otwarcie menu z aplikacjami.

Obejmuje to wiadomości zawierające zarówno powiadomienia, jak i dane ładunek (oraz wszystkie wiadomości wysłane z konsoli powiadomień). W takich przypadkach powiadomienie jest dostarczane do w zasobniku systemowym, a ładunek danych jest dostarczany w elementach dodatkowych intencji aktywności programu uruchamiającego.

Więcej informacji o dostarczaniu wiadomości do aplikacji znajdziesz tutaj: FCM panelu raportowania, który rejestruje liczba wiadomości wysłanych i otwartych na urządzeniach Apple i z Androidem oraz dane dotyczące „wyświetleń” (powiadomienia użytkowników) dotyczące aplikacji 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ą włączyć w aplikacji na Androida możliwość odbierania wiadomości, gdy urządzenie jest w trybie bezpośredniego uruchamiania. Możesz na przykład chcieć, aby użytkownicy Twojej aplikacji otrzymywali powiadomienia o alarmach nawet na zablokowanym urządzeniu.

Podczas tworzenia tego przypadku użycia należy przestrzegać ogólnych sprawdzonych metod i ograniczeń dotyczących trybu bezpośredniego uruchamiania. Jest należy wziąć pod uwagę widoczność bezpośredniego rozruchu wiadomości; każdy użytkownik z dostępem do urządzenia może wyświetlić te wiadomości bez podając dane logowania użytkownika.

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 FCM SDK (com.google.firebase:firebase-messaging).

Włączanie obsługi wiadomości w trybie bezpośredniego uruchamiania w aplikacji

1. W pliku Gradle na poziomie aplikacji dodaj zależność od biblioteki obsługi bezpośredniego uruchamiania 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ź musisz spełnić te wymagania:

• Usługa nie powinna mieć dostępu do pamięci chronionej danymi logowania podczas działania w trybie bezpośredniego uruchamiania.
• Usługa nie powinna próbować używać komponentów, takich jak Activities, BroadcastReceiverslub inne Services, które nie są oznaczone jako obsługujące bezpośrednie uruchamianie podczas działania w trybie bezpośredniego uruchamiania.
• Biblioteki używane przez usługę nie mogą też uzyskiwać dostępu do magazynu chronionego za pomocą danych logowania ani wywoływać komponentów, które nie są świadome bezpośredniego uruchamiania. Oznacza to, że wszystkie biblioteki używane przez aplikację i wywoływane przez usługę muszą być świadome bezpośredniego uruchamiania lub aplikacja musi sprawdzić, czy działa w trybie bezpośredniego uruchamiania, i nie wywoływać ich w tym trybie. Na przykład pakiety SDK Firebase działają z bezpośrednim rozruchem (można je włączyć w aplikacji bez jego awarii w trybie bezpośredniego rozruchu), ale wiele interfejsów API Firebase nie obsługuje wywołań bezpośrednich. i trybu uruchamiania.
• Jeśli aplikacja używa niestandardowego Application, Application też musi być bezpośrednim rozruchem (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 sekcji Wysyłanie wiadomości obsługujących funkcję bezpośredniego rozruchu.