Ta strona została przetłumaczona przez Cloud Translation API.

Odbieranie wiadomości w aplikacji na Androida

Powiadomienia Firebase działają inaczej w zależności od stanu aplikacji odbiorczej (na pierwszym lub drugim planie). Jeśli chcesz, aby aplikacje na pierwszym planie otrzymywały wiadomości z powiadomieniami lub dane, musisz napisać kod do obsługi wywołania zwrotnego onMessageReceived. Więcej informacji o różnicach między powiadomieniami a wiadomościami z danymi znajdziesz w artykule 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.

Okno czasowe na przetworzenie wiadomości może być krótsze niż 20 sekund, w zależności od opóźnień występujących przed wywołaniem funkcji onMessageReceived, w tym opóźnień systemu operacyjnego, czasu uruchamiania aplikacji, blokowania głównego wątku przez inne operacje lub zbyt długiego czasu trwania poprzednich wywołań funkcji onMessageReceived. 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.

onMessageReceived jest dostępna w przypadku większości typów wiadomości, 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 zawartością danych i powiadomienia, które są odbierane w tle. W takim przypadku powiadomienie jest dostarczane do zasobnika systemowego urządzenia, a dane są dostarczane w ramach dodatkowych informacji o intencji aktywności w launcherze.

W skrócie:

Stan aplikacji	Powiadomienie	Dane	Oba rodzaje
Pierwszy plan	`onMessageReceived`	`onMessageReceived`	`onMessageReceived`
Tło	obszar powiadomień.	`onMessageReceived`	Powiadomienie: pasek systemowy Dane: w dodatkowych informacjach intencji.

Więcej informacji o typach wiadomości znajdziesz w artykule Powiadomienia i wiadomości z danymi.

Edytowanie pliku 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 określić niestandardową domyślną ikonę i niestandardowy domyślny kolor, które są stosowane, gdy w danych powiadomienia nie są ustawione odpowiednie 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 wysyłane z narzędzi do tworzenia powiadomień.
każde powiadomienie, które nie ma wyraźnie ustawionej ikony w danych powiadomienia;

Android używa niestandardowego koloru domyślnego w przypadku

Wszystkie powiadomienia wysyłane z narzędzi do tworzenia powiadomień.
Wszystkie komunikaty z powiadomieniami, które nie mają wyraźnie ustawionego koloru w ładunku powiadomień.

Jeśli nie ustawisz niestandardowej domyślnej ikony ani nie podasz ikony w danych powiadomienia, Android wyświetli ikonę aplikacji w kolorze białym.

Zastąpić `onMessageReceived`

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

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

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

Zastąpić `onDeletedMessages`

W niektórych sytuacjach FCM może nie dostarczyć wiadomości. Dzieje się tak, gdy w danym momencie w aplikacji na konkretnym urządzeniu jest zbyt wiele oczekujących wiadomości (ponad 100) lub gdy urządzenie nie było połączone z aplikacją FCM przez ponad miesiąc. W takich przypadkach możesz otrzymać połączenie zwrotne na numer FirebaseMessagingService.onDeletedMessages(). Gdy instancja aplikacji otrzyma to połączenie zwrotne, powinna przeprowadzić pełną synchronizację z serwerem aplikacji. Jeśli w ciągu ostatnich 4 tygodni nie wysłano do tej aplikacji żadnej wiadomości, FCM nie zadzwoni do onDeletedMessages().

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

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

Dotyczy to wiadomości zawierających zarówno powiadomienia, jak i dane (oraz wszystkich wiadomości wysłanych z konsoli powiadomień). W takich przypadkach powiadomienie jest wysyłane do zasobnika systemowego urządzenia, a dane są dostarczane w ramach dodatkowych informacji o intencji w aktywności Launchera.

Aby uzyskać informacje o dostarczaniu wiadomości do aplikacji, otwórz FCM panel raportowania, który zawiera informacje o liczbie wiadomości wysłanych i otwartych na urządzeniach Apple i Android, a także dane o wyświetleniach (powiadomieniach wyświetlanych użytkownikom) aplikacji na Androida.

Odbieranie wiadomości FCM w trybie bezpośredniego uruchamiania

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 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. Szczególnie ważne jest uwzględnienie widoczności wiadomości w trybie bezpośredniego uruchamiania. Każdy użytkownik z dostępem do urządzenia może wyświetlić te wiadomości bez podawania danych logowania.

Wymagania wstępne

Urządzenie musi być skonfigurowane do uruchamiania w trybie bezpośrednim.
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łączanie obsługi wiadomości w trybie bezpośredniego uruchamiania w aplikacji

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'
```

Aby umożliwić uruchamianie aplikacji FirebaseMessagingService bezpośrednio po włączeniu urządzenia, dodaj atrybut android:directBootAware="true" w pliku manifestu 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>

Należy upewnić się, że FirebaseMessagingService może działać w trybie bezpośredniego uruchamiania. Sprawdź, czy spełniasz 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 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 korzysta z niestandardowego Application, Application musi też obsługiwać bezpośrednie uruchamianie (w trybie bezpośredniego uruchamiania nie ma dostępu do pamięci chronionej hasłem).

Więcej informacji o wysyłaniu wiadomości na urządzeniach w trybie bezpośredniego uruchamiania znajdziesz w artykule Wysyłanie wiadomości na urządzeniach w trybie bezpośredniego uruchamiania.