Rodzaje wiadomości w usłudze Firebase Cloud Messaging

Za pomocą FCM możesz wysyłać do aplikacji klienckich 2 typy wiadomości:

• Powiadomienia, podobne do "wiadomości wyświetlanych", są automatycznie obsługiwane przez pakiet FCM SDK.
• Wiadomości z danymi, które są obsługiwane przez aplikację kliencką.

Powiadomienia zawierają wstępnie zdefiniowany zestaw kluczy widocznych dla użytkownika i mogą zawierać opcjonalny ładunek danych. Wiadomości z danymi zawierają natomiast tylko zdefiniowane przez użytkownika niestandardowe pary klucz-wartość. Maksymalny rozmiar ładunku w przypadku obu typów wiadomości to 4096 bajtów, z wyjątkiem wysyłania wiadomości z konsoli Firebase, w której obowiązuje limit 1000 znaków.

Powiadomienia możesz używać, gdy chcesz, aby pakiet FCM SDK automatycznie wyświetlał powiadomienie, gdy aplikacja działa w tle. FCM może wysłać powiadomienie z opcjonalnym ładunkiem danych. W takich przypadkach FCM wyświetla ładunek powiadomienia, a aplikacja kliencka obsługuje ładunek danych.

Wiadomości z danymi możesz używać, gdy chcesz przetwarzać wiadomości za pomocą własnego kodu aplikacji klienckiej.

Powiadomienia

Powiadomienia możesz wysyłać za pomocą Firebase konsoli, Firebase Admin SDK lub interfejsu FCM HTTP v1 API. Konsola Firebase udostępnia testy A/B oparte na danych analitycznych, które pomagają udoskonalać powiadomienia.

Aby wysyłać powiadomienia za pomocą Firebase Admin SDK lub FCM interfejsu HTTP v1 API, ustaw klucz notification z wstępnie zdefiniowanym zestawem opcji klucz-wartość powiadomienia. Możesz użyć tego przykładu, aby sformatować powiadomienie w aplikacji do obsługi wiadomości.

{
  "message":{
    "token":"bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
    "notification":{
      "title":"Portugal vs. Denmark",
      "body":"great match!"
    }
  }
}

Gdy aplikacja działa w tle, powiadomienia są dostarczane do zasobnika powiadomień. W przypadku aplikacji działających na pierwszym planie wiadomości są obsługiwane przez funkcję wywołania zwrotnego.

Pełną listę wstępnie zdefiniowanych kluczy dostępnych do tworzenia powiadomień znajdziesz w dokumentacji referencyjnej obiektu powiadomienia interfejsu FCM HTTP v1 API.

Wiadomości z danymi

To Ty decydujesz, jak chcesz używać ładunku FCM data do wdrożenia wybranego schematu szyfrowania. Upewnij się, że w niestandardowych parach klucz-wartość nie używasz żadnych słów zastrzeżonych. Słowa zastrzeżone to m.in. from, message_type oraz wszystkie słowa zaczynające się od google., gcm. lub gcm.notification..

Poniższy przykład pokazuje użycie pola danych najwyższego poziomu lub wspólnego pola danych, które jest interpretowane przez klientów na wszystkich platformach, na których wiadomość jest odbierana. Na każdej platformie aplikacja kliencka otrzymuje ładunek danych w funkcji wywołania zwrotnego.

{
  "message":{
    "token":"bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
    "data":{
      "Nick" : "Mario",
      "body" : "great match!",
      "Room" : "PortugalVSDenmark"
    }
  }
}

Powiadomienia z opcjonalnym ładunkiem danych

Powiadomienia, które zawierają opcjonalny ładunek niestandardowych par klucz-wartość, możesz wysyłać programowo lub za pomocą konsoli Firebase. W kreatorze powiadomień, użyj pól Dane niestandardowe w sekcji Opcje zaawansowane.

Zachowanie aplikacji podczas odbierania wiadomości, które zawierają zarówno ładunek powiadomienia, jak i ładunek danych zależy od tego, czy aplikacja działa w tle czy na pierwszym planie – czyli czy jest aktywna w momencie otrzymania.

• Gdy aplikacja działa w tle, otrzymuje ładunek powiadomienia w zasobniku powiadomień i obsługuje ładunek danych tylko wtedy, gdy użytkownik kliknie powiadomienie.
• Gdy aplikacja działa na pierwszym planie, otrzymuje obiekt wiadomości z dostępnymi oboma ładunkami.

Oto wiadomość w formacie JSON zawierająca zarówno klucz notification jak i klucz data:

{
  "message":{
    "token":"bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
    "notification":{
      "title":"Portugal vs. Denmark",
      "body":"great match!"
    },
    "data" : {
      "Nick" : "Mario",
      "Room" : "PortugalVSDenmark"
    }
  }
}