Protokół XMPP Firebase Cloud Messaging

Ten parametr określa adresata wiadomości.

Wartością może być token rejestracji urządzenia, identyfikator grupy urządzeń klucza powiadomień lub pojedynczego tematu (z przedrostkiem /topics/). Aby wysłać wiadomość do wielu tematów, użyj condition.

Ten parametr określa wyrażenie logiczne warunków, które określa cel wiadomości.

Obsługiwany warunek: temat w formacie „TwójTemat” w tematach”. Ten Wielkość liter w wartości nie jest rozróżniana.

Obsługiwane operatory: &&, ||. Maksymalnie 2 operatorów na wiadomość w temacie.

Ten parametr jednoznacznie identyfikuje komunikat w połączeniu XMPP.

Ten parametr określa grupę wiadomości (np. collapse_key: "Updates Available"), które można zwinąć, tak aby tylko ostatnia wiadomość jest wysyłana po wznowieniu dostarczania. Ma to na celu uniknięcie wysyłania wiele tych samych wiadomości, gdy urządzenie znów jest online lub jest uśpione.

Nie możemy zagwarantować kolejności wysyłania wiadomości.

Uwaga: w danym momencie dozwolone są maksymalnie 4 różne klucze zwijania. Oznacza to, że W FCM można jednocześnie przechowywać 4 różne wiadomości na aplikację kliencką. Jeśli przekracza tę liczbę, nie ma gwarancji, które 4 klucze zwijania w FCM aby zachować.

Określa priorytet wiadomości. Prawidłowe wartości to „normal” i „wysoka”. Na platformach Apple odpowiadają priorytetom 5 i 10 APNs.

Domyślnie powiadomienia są wysyłane z wysokim priorytetem oraz wiadomościami zawierającymi dane. wysyłane z normalnym priorytetem. Normalny priorytet optymalizuje zużycia baterii i należy go używać, chyba że wymagane jest natychmiastowe W przypadku wiadomości o normalnym priorytecie aplikacja może otrzymać wiadomość z kodem nieokreślone opóźnienie.

Gdy wiadomość o wysokim priorytecie jest wysyłana, jest ona wysyłana natychmiast, a aplikacja może wyświetlić powiadomienie.

Na platformach Apple używaj tego pola do reprezentowania tego pola (content-available) w punktach APN. ładunek. Gdy zostanie wysłane powiadomienie lub wiadomość z ustawieniem true, pojawi się nieaktywna aplikacja kliencka jest wybudzana, a wiadomość jest wysyłana za pośrednictwem punktów APN jako cichy powiadomienia, a nie przez FCM. Pamiętaj, że ciche powiadomienia w Nie ma gwarancji, że punkty APN zostaną dostarczone i mogą zależeć od takich czynników jak użytkownik włączenie trybu niskiego poboru energii, wymuszenie zamknięcia aplikacji itp. Na Androidzie wiadomości z danymi aplikacji. W Chrome. Ta funkcja nie jest obecnie obsługiwana.

Na platformach Apple użyj tego pola, aby określić, mutable-content w ładunku APNs. Gdy zostanie wysłane powiadomienie, do true, treść powiadomienia można zmienić przed jego wyświetleniem, za pomocą funkcji Rozszerzenie aplikacji usługi powiadomień. W przypadku Androida i internetu ten parametr będzie ignorowany.

Ten parametr określa czas (w sekundach), przez jaki wiadomość ma być przechowywana w pamięci FCM jeśli urządzenie jest offline. Maksymalny obsługiwany czas życia to 4 tygodnie, a wartość domyślna to 4 tygodnie. Więcej informacji znajdziesz w artykule Ustawianie okresu ważności wiadomości.

Po ustawieniu tego parametru na true deweloperzy mogą testować żądania bez wysyłania wiadomości.

Wartością domyślną jest false.

Ten parametr określa pary klucz-wartość ładunku wiadomości.

Przykład: data:{"score":"3x1"}:

Na platformach Apple wiadomość jest dostarczana przez punkty APN. Przedstawia ona niestandardowe pola danych. Jeśli jest dostarczana przez FCM, w AppDelegate application:didReceiveRemoteNotification: jest przedstawiany jako słownik par klucz-wartość.

W przypadku Androida skutkuje to dodatkową intencją o nazwie score z wartością ciągu znaków 3x1.

Klucz nie może być słowem zarezerwowanym („z”, „message_type” ani innym słowem rozpoczynającym się od „Google” lub „gcm”). Nie używaj żadnych słów zdefiniowanych w tej tabeli (np. collapse_key).

Zalecane są wartości w typach ciągów znaków. Musisz przekonwertować wartości w obiektach lub innych typach danych niebędących ciągami znaków (np. liczby całkowite lub logiczne) na ciąg znaków.

Tytuł powiadomienia.

To pole jest niewidoczne na telefonach i tabletach.

Treść powiadomienia.

Dźwięk do odtwarzania, gdy urządzenie otrzyma powiadomienie.

Ciąg tekstowy określający pliki dźwiękowe w głównym pakiecie aplikacji klienckiej lub w pliku Folder Library/Sounds kontenera danych aplikacji. Zobacz w Bibliotece deweloperów iOS, aby dowiedzieć się więcej.

Wartość plakietki na ikonie aplikacji na ekranie głównym.

Jeśli go nie podasz, identyfikator się nie zmieni.

Jeśli ma wartość 0, plakietka zostanie usunięta.

Działanie powiązane z użytkownikiem kliknie powiadomienie.

Odpowiada parametrowi category w ładunku APNs.

Podtytuł powiadomienia.

Klucz do ciągu treści w zasobach ciągu tekstowego aplikacji, który ma być używany do zlokalizuj tekst główny do bieżącej lokalizacji użytkownika.

Odpowiada parametrowi loc-key w ładunku APNs.

Zobacz Dokumentacja klucza ładunku Lokalizuję zawartość powiadomień zdalnych, aby dowiedzieć się więcej i informacjami o nich.

Ciągi znaków zmiennych, które mają być używane zamiast specyfikatorów formatu w body_loc_key, który służy do lokalizowania tekstu głównego w sekcji bieżącej lokalizacji użytkownika.

Odpowiada parametrowi loc-args w ładunku APNs.

Zobacz Dokumentacja klucza ładunku Lokalizuję zawartość powiadomień zdalnych, aby dowiedzieć się więcej i informacjami o nich.

Klucz do ciągu tytułu w zasobach ciągu tekstowego aplikacji, który ma służyć do przetłumaczyć tekst tytułu do bieżącej lokalizacji użytkownika.

Odpowiada parametrowi title-loc-key w ładunku APNs.

Zobacz Dokumentacja klucza ładunku Lokalizuję zawartość powiadomień zdalnych, aby dowiedzieć się więcej i informacjami o nich.

Ciągi znaków zmiennych, które mają być używane zamiast specyfikatorów formatu w title_loc_key służy do zlokalizowania tekstu tytułu w sekcji bieżącej lokalizacji użytkownika.

Odpowiada parametrowi title-loc-args w ładunku APNs.

Zobacz Dokumentacja klucza ładunku Lokalizuję zawartość powiadomień zdalnych, aby dowiedzieć się więcej i informacjami o nich.

Tytuł powiadomienia.

Treść powiadomienia.

identyfikator kanału powiadomienia (nowość w Androidzie O).

Aplikacja musi utworzyć kanał z tym identyfikatorem, zanim powiadomienie z tym identyfikatorem zostanie odebrane.

Jeśli nie podasz tego identyfikatora kanału w prośbie lub jeśli podany identyfikator kanału nie został jeszcze utworzony przez aplikację, FCM używa identyfikatora kanału określonego w manifeście aplikacji.

Ikona powiadomienia.

Ustawia ikonę powiadomień na myicon dla zasobu rysowalnego myicon Jeśli nie wyślesz tego klucza w żądaniu, FCM wyświetla ikonę programu uruchamiającego określoną w manifeście aplikacji.

Dźwięk do odtwarzania, gdy urządzenie otrzyma powiadomienie.

Obsługuje pole "default" lub nazwę pliku zasobu dźwiękowego zawarte w pakiecie do aplikacji. Pliki dźwiękowe muszą znajdować się w lokalizacji /res/raw/.

Identyfikator używany do zastępowania obecnych powiadomień w powiadomieniu szuflady.

Jeśli go nie podasz, dla każdego żądania tworzone będzie nowe powiadomienie.

Jeśli został określony, a powiadomienie z tym samym tagiem jest już wysyłane nowe powiadomienie zastąpi dotychczasowe panelu powiadomień.

Kolor ikony powiadomienia w formacie #rrggbb.

Działanie powiązane z użytkownikiem kliknie powiadomienie.

Jeśli określisz działanie z pasującym filtrem intencji, zostanie ono uruchomione, gdy użytkownik klika je.

Klucz do ciągu treści w zasobach ciągu tekstowego aplikacji, który ma być używany do zlokalizuj tekst główny do bieżącej lokalizacji użytkownika.

Zobacz String Resources.

Ciągi znaków zmiennych, które mają być używane zamiast specyfikatorów formatu w body_loc_key, który służy do lokalizowania tekstu głównego w sekcji bieżącej lokalizacji użytkownika.

Zobacz Formatowanie i styl.

Klucz do ciągu tytułu w zasobach ciągu tekstowego aplikacji, który ma służyć do przetłumaczyć tekst tytułu do bieżącej lokalizacji użytkownika.

Zobacz String Resources.

Ciągi znaków zmiennych, które mają być używane zamiast specyfikatorów formatu w title_loc_key służy do zlokalizowania tekstu tytułu w sekcji bieżącej lokalizacji użytkownika.

Zobacz Formatowanie i styl.

Tytuł powiadomienia.

Treść powiadomienia.

Adres URL, który ma być używany na potrzeby ikony powiadomienia.

Działanie powiązane z użytkownikiem kliknie powiadomienie.

W przypadku wszystkich wartości adresów URL wymagany jest protokół HTTPS.

Ten parametr określa, kto wysłał tę odpowiedź.

Wartość to token rejestracji aplikacji klienckiej.

Ten parametr określa komunikat ack lub nack z z FCM do serwera aplikacji.

Jeśli wartość jest ustawiona na nack, serwer aplikacji powinien sprawdzić, error i error_description, aby uzyskać informacje o błędach.

• Jeśli aplikacja kliencka wyrejestruje się z FCM.
• Jeśli aplikacja kliencka została automatycznie wyrejestrowana, co może się zdarzyć, użytkownik odinstaluje aplikację. Na przykład w iOS, jeśli APN-y zgłosił token APNs jako nieprawidłowy.
• Jeśli token rejestracji wygaśnie (na przykład Google może zdecydować się na odświeżenie strony tokeny rejestracji lub token APNs wygasł dla urządzeń).
• Jeśli aplikacja kliencka została zaktualizowana, ale nowa wersja nie jest skonfigurowana do odbierania wiadomości.

Serwer nie mógł przetworzyć żądania na czas. Ponów tę samą prośbę, ale musisz:

• Wdróż wykładniczy czas do ponowienia w mechanizmie ponawiania. (np. jeśli odczekano jedną sekundę przed pierwszą próbą, odczekaj co najmniej dwie sekundy przed następną, następnie cztery sekundy itd.). Jeśli wysyłasz wiele wiadomości, opóźnij każdą z nich niezależnie o dodatkową losową liczbę , aby uniknąć jednoczesnego zgłaszania nowego żądania dotyczącego wszystkich wiadomości.
• Początkowe opóźnienie ponawiania powinno być ustawione na 1 sekundę.

Uwaga: nadawcy, którzy powodują problemy, mogą znaleźć się na czarnej liście.

Ten parametr określa, kto wysłał wiadomość.

Wartość to token rejestracji aplikacji klienckiej.

Ten parametr określa adresata wiadomości z odpowiedzią.

Wartość musi być tokenem rejestracji aplikacji klienckiej, która wysłała wiadomość nadrzędną.

Ten parametr określa typ komunikatu: Control.

Jeśli zasada ma wartość control, komunikat zawiera ciąg control_type, który wskazuje typu komunikatu kontrolnego.

Ten parametr określa typ komunikatu kontrolnego wysyłanego z FCM.

Obecnie obsługiwana jest tylko CONNECTION_DRAINING. FCM wysyła tę wiadomość kontrolną przed zamknięciem połączenia w celu zrównoważenia obciążenia. Po rozłączeniu połączenia nie pojawiają się żadne wiadomości mogą być wysyłane do połączenia, ale istniejące wiadomości w potoku nadal być przetwarzane.