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 odbierać wiadomości, użyj usługi z rozszerzeniem FirebaseMessagingService Twoja usługa powinna zastąpić te zasady: 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 działania systemu operacyjnego, takie jak procesu zabijanie czy i limity wykonywania w tle mogą zakłócać Twoją zdolność do wykonywania pracy.

W przypadku większości typów wiadomości uwzględniana jest właściwość onMessageReceived, przy czym z następującymi wyjątki:

• Powiadomienia z powiadomieniami dostarczane, gdy aplikacja działa w tle. W tym powiadomienie pojawi się w obszarze 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żyć usługi FirebaseMessagingService, musisz dodać te elementy do plik 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ń.

Dodaj te wiersze w polu Tag application, który pozwala ustawić niestandardową ikonę domyślną i niestandardowy kolor:

<!-- 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 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 Edytor powiadomień.
• Wszystkie powiadomienia, które nie mają w sposób wyraźny określony koloru. ładunek.

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ługuj wiadomości z powiadomieniami w aplikacji działającej w tle

Gdy aplikacja działa w tle, Android przekierowuje powiadomienia na w obszarze powiadomień. Kliknięcie powiadomienia przez użytkownika powoduje otwarcie menu z aplikacjami wartość domyślną.

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 urządzenie jest odblokowane, może umożliwić aplikacji na Androida odbieranie wiadomości, gdy urządzenie jest w trybie bezpośredniego rozruchu. Użytkownicy aplikacji mogą na przykład: otrzymywać powiadomienia o alarmach nawet na zablokowanym urządzeniu.

Tworząc ten przypadek użycia, zwróć uwagę na ogólne sprawdzone metody i ograniczenia dotyczące trybu bezpośredniego rozruchu. 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 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ź musisz spełnić 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, lub inne nośniki Services, które nie są oznaczone jako rozpoznawane podczas uruchamiania w trybie bezpośredniego rozruchu.
• Biblioteki używane przez usługę nie mogą też uzyskiwać dostępu do magazynu chronionego danymi uwierzytelniającymi ani wywoływania niebezpośrednich komponentów BootAware w trybie bezpośredniego rozruchu. Oznacza to, że wszystkie biblioteki używane przez aplikację są wywoływane z usługi albo muszą mieć świadomość bezpośredniego rozruchu lub aplikacja musi sprawdzić, czy działa w trybie bezpośredniego rozruchu, i nie wywoływać jej 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.