MessagingOptions interface

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

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;