Interfejs przedstawiający opcje dostępne podczas wysyłania wiadomości przez starsze interfejsy API FCM.
Przykładowe fragmenty kodu i szczegółową dokumentację znajdziesz w artykule Tworzenie żądań wysyłania.
Podpis:
export interface MessagingOptions
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
| ZwińKey | ciąg znaków | Ciąg znaków określający grupę wiadomości (np. „Dostępne aktualizacje”), które można zwinąć, aby umożliwić wysłanie tylko ostatniej wiadomości, gdy można wznowić jej dostarczanie. Pozwala to uniknąć wysyłania zbyt wielu tych samych wiadomości, gdy urządzenie powróci do trybu online lub stanie się aktywne.Nie ma gwarancji, w jakiej kolejności wiadomości będą wysyłane.W danym momencie można użyć maksymalnie 4 różnych kluczy zwinięcia. Oznacza to, że serwer FCM może jednocześnie przechowywać 4 różne wiadomości w trybie wysyłania na potrzeby synchronizacji na aplikację kliencką. Po przekroczeniu tej liczby nie ma gwarancji, które 4 klucze zwinięcia zachowa serwer FCM.**Wartość domyślna**: brak. |
| contentAvailable | wartość logiczna | W systemie iOS użyj tego pola do reprezentowania elementu content-available w ładunku APNs. Po wysłaniu powiadomienia lub wiadomości z danymi o wartości true nieaktywna aplikacja kliencka jest wybudzana. Na Androidzie wiadomości z danymi domyślnie wybudzają aplikację. W Chrome ta flaga nie jest obecnie obsługiwana.**Wartość domyślna:** false |
| dryRun | wartość logiczna | Wskazuje, czy wiadomość powinna zostać rzeczywiście wysłana. Gdy zasada ma wartość true, deweloperzy mogą testować żądanie bez wysyłania wiadomości. Gdy ustawisz wartość false, wiadomość zostanie wysłana.**Wartość domyślna:** false |
| zmiennaZawartość | wartość logiczna | W systemie iOS użyj tego pola do reprezentowania elementu mutable-content w ładunku APNs. Gdy powiadomienie ma wartość true, jego treść można zmodyfikować, zanim się wyświetli, za pomocą rozszerzenia aplikacji usługi powiadomień.W przypadku Androida i internetu ten parametr jest ignorowany.**Wartość domyślna:** false |
| priorytet | ciąg znaków | Priorytet wiadomości. Prawidłowe wartości to "normal" i "high". (w systemie iOS) odpowiadają priorytetom APNs 5 i 10.Domyślnie wiadomości z powiadomieniami są wysyłane z wysokim priorytetem, a wiadomości z danymi są wysyłane z normalnym priorytetem. Normalny priorytet optymalizuje zużycie baterii przez aplikację kliencką i powinien być używany, chyba że konieczne jest natychmiastowe dostarczenie. W przypadku wiadomości z normalnym priorytetem aplikacja może je otrzymać z nieokreślonym opóźnieniem.Gdy wiadomość z wysokim priorytetem zostanie wysłana z wysokim priorytetem, jest ona natychmiast wysyłana, a aplikacja może wybudzić urządzenie do snu i nawiązać połączenie sieciowe z Twoim serwerem.Więcej informacji znajdziesz w sekcji Ustawianie priorytetu wiadomości.**Wartość domyślna:** "high" w przypadku powiadomień, "normal" w przypadku wiadomości z danymi. |
| restrictedPackageName | ciąg znaków | Nazwa pakietu aplikacji, z którą muszą zgadzać się tokeny rejestracji, aby otrzymać komunikat.**Wartość domyślna:** brak |
| timeToLive, | liczba | Czas (w sekundach), przez jaki wiadomość ma być przechowywana w pamięci FCM, gdy urządzenie jest offline. Maksymalny obsługiwany czas życia to 4 tygodnie, a wartość domyślna to 4 tygodnie. Więcej informacji znajdziesz w sekcji Ustawianie okresu ważności wiadomości.**Wartość domyślna:** 2419200 (4 tygodnie w sekundach). |
MessagingOptions.ZwińKey
Ciąg znaków określający grupę wiadomości (np. „Dostępne aktualizacje”), które można zwinąć, aby umożliwić wysłanie tylko ostatniej wiadomości, gdy można wznowić jej dostarczanie. Pozwala to uniknąć wysyłania zbyt wielu takich samych wiadomości, gdy urządzenie znów będzie online lub stanie się aktywne.
Nie możemy zagwarantować kolejności wysyłania wiadomości.
W danym momencie dozwolone są maksymalnie 4 różne klucze zwijania. Oznacza to, że serwer FCM może jednocześnie przechowywać 4 różne wiadomości w trybie wysyłania na potrzeby synchronizacji na aplikację kliencką. Po przekroczeniu tej liczby nie ma gwarancji, które cztery klucze zwinięcia zachowa serwer FCM.
**Wartość domyślna:** brak
Podpis:
collapseKey?: string;
MessagingOptions.contentAvailable
W systemie iOS użyj tego pola do reprezentowania elementu content-available w ładunku APNs. Po wysłaniu powiadomienia lub wiadomości z danymi o wartości true nieaktywna aplikacja kliencka jest wybudzana. Na Androidzie wiadomości z danymi domyślnie wybudzają aplikację. W Chrome ta flaga nie jest obecnie obsługiwana.
**Wartość domyślna:** false
Podpis:
contentAvailable?: boolean;
MessagingOptions.dryRun
Wskazuje, czy wiadomość powinna zostać rzeczywiście wysłana. Gdy ustawisz wartość true, deweloperzy będą mogli przetestować żądanie bez wysyłania wiadomości. Gdy ustawisz wartość false, wiadomość zostanie wysłana.
**Wartość domyślna:** false
Podpis:
dryRun?: boolean;
MessagingOptions.mutableContent.
W systemie iOS użyj tego pola do reprezentowania elementu mutable-content w ładunku APNs. Kiedy wysłane powiadomienie ma wartość true, jego treść można modyfikować za pomocą rozszerzenia aplikacji Usługa powiadomień, zanim zostanie wyświetlone.
W przypadku Androida i przeglądarki ten parametr jest ignorowany.
**Wartość domyślna:** false
Podpis:
mutableContent?: boolean;
MessagingOptions.Priorytet
Priorytet wiadomości. Prawidłowe wartości to "normal" i "high". (w systemie iOS). Odpowiadają one priorytetom APNs: 5 i 10.
Domyślnie powiadomienia są wysyłane z wysokim priorytetem, a wiadomości z danymi – z normalnym priorytetem. Normalny priorytet optymalizuje zużycie baterii przez aplikację kliencką i powinien być używany, chyba że konieczne jest natychmiastowe dostarczenie. W przypadku wiadomości o normalnym priorytecie aplikacja może otrzymać wiadomość z nieokreślonym opóźnieniem.
Wiadomość z wysokim priorytetem jest wysyłana natychmiast, a aplikacja może wybudzić urządzenie do snu i nawiązać połączenie sieciowe z Twoim serwerem.
Więcej informacji znajdziesz w sekcji Ustawianie priorytetu wiadomości.
**Wartość domyślna:** "high" – wiadomości z powiadomieniami, "normal" – wiadomości z danymi.
Podpis:
priority?: string;
MessagingOptions.restrictedPackageName
Nazwa pakietu aplikacji, z którą muszą zgadzać się tokeny rejestracji, aby otrzymać wiadomość.
**Wartość domyślna:** brak
Podpis:
restrictedPackageName?: string;
MessagingOptions.timeToLive
Czas (w sekundach), przez jaki wiadomość ma być przechowywana w pamięci FCM, gdy 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.
**Wartość domyślna:** 2419200 (4 tygodnie w sekundach)
Podpis:
timeToLive?: number;