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:
Stan aplikacji | Powiadomienie | Dane | Oba rodzaje |
---|---|---|---|
Pierwszy plan | onMessageReceived |
onMessageReceived |
onMessageReceived |
Tło | Zasobnik systemowy | onMessageReceived |
Powiadomienie: obszar powiadomień Dane: w dodatkowych celach. |
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>
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" />
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:
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. }
Zastąp onDeletedMessages
W niektórych sytuacjach FCM może nie dostarczyć wiadomości. Dzieje się tak, gdy jest zbyt wiele
oczekujące wiadomości (> 100) dla
w momencie nawiązania połączenia lub gdy urządzenie nie połączyło się
FCM za ponad miesiąc. W takich przypadkach
możesz oddzwonić pod numer FirebaseMessagingService.onDeletedMessages()
Gdy instancja aplikacji otrzyma to wywołanie zwrotne,
powinien przeprowadzić pełną synchronizację z serwerem aplikacji. Jeśli wiadomość nie została jeszcze wysłana do aplikacji
urządzenie w ciągu ostatnich 4 tygodni, FCM nie będzie nawiązywać połączenia z numerem 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
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'
Poinformuj klienta o bezpośrednim rozruchu
FirebaseMessagingService
aplikacji, dodając atrybutandroid: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śnikiServices
, 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.