MessagingOptions interface

Eski FCM API'leri aracılığıyla mesaj gönderilirken sağlanabilecek seçenekleri temsil eden arayüz.

Kod örnekleri ve ayrıntılı belgeler için gönderme istekleri oluşturma konusuna bakın.

İmza:

export interface MessagingOptions 

Özellikler

Mülk Tip Tanım
daraltAnahtar sicim Dağıtım devam ettirildiğinde yalnızca son mesajın gönderilmesi için daraltılabilen bir grup mesajı (örneğin, "Güncellemeler Mevcut") tanımlayan dize. Bu, cihaz tekrar çevrimiçi olduğunda veya aktif olduğunda aynı mesajların çok fazla gönderilmesini önlemek için kullanılır. Mesajların gönderilme sırasının garantisi yoktur. Herhangi bir zamanda en fazla dört farklı daraltma anahtarına izin verilir. Bu, FCM sunucusunun, istemci uygulaması başına dört farklı senkronizasyona gönderme mesajını aynı anda depolayabileceği anlamına gelir. Bu sayıyı aşarsanız FCM sunucusunun hangi dört daraltma anahtarını tutacağının garantisi yoktur. **Varsayılan değer:** Yok
içerikMevcut boolean iOS'ta APN yükünde content-available temsil etmek için bu alanı kullanın. Bir bildirim veya veri mesajı gönderildiğinde ve bu true olarak ayarlandığında etkin olmayan bir istemci uygulaması uyandırılır. Android'de veri mesajları uygulamayı varsayılan olarak uyandırır. Chrome'da bu işaret şu anda desteklenmiyor. **Varsayılan değer:** false
kuru Çalıştır boolean Mesajın gerçekten gönderilip gönderilmeyeceği. true olarak ayarlandığında, geliştiricilerin aslında bir mesaj göndermeden bir isteği test etmesine olanak tanır. false olarak ayarlandığında mesaj gönderilecektir. **Varsayılan değer:** false
değişken İçerik boolean iOS'ta APN yükündeki mutable-content temsil etmek için bu alanı kullanın. Bir bildirim gönderildiğinde ve bu true olarak ayarlandığında, Bildirim Hizmeti uygulama uzantısı kullanılarak bildirimin içeriği görüntülenmeden önce değiştirilebilir. . Android ve Web'de bu parametre göz ardı edilecektir. **Varsayılan değer:** false
öncelik sicim Mesajın önceliği. Geçerli değerler "normal" ve "high". iOS'ta bunlar APN'nin 5 ve 10 önceliklerine karşılık gelir. Varsayılan olarak, bildirim mesajları yüksek öncelikle, veri mesajları ise normal öncelikle gönderilir. Normal öncelik, istemci uygulamasının pil tüketimini optimize eder ve hemen teslim gerekmediği sürece kullanılmalıdır. Normal öncelikli mesajlar için uygulama, mesajı belirtilmemiş bir gecikmeyle alabilir. Yüksek öncelikli bir mesaj gönderildiğinde hemen gönderilir ve uygulama uyuyan cihazı uyandırıp sunucunuza bir ağ bağlantısı açabilir. Daha fazla bilgi için bkz. Bir mesajın önceliğini ayarlama . **Varsayılan değer:** Bildirim mesajları için "high" , veri mesajları için "normal"
kısıtlıPaketAdı sicim Mesajın alınabilmesi için kayıt belirteçlerinin eşleşmesi gereken uygulamanın paket adı. **Varsayılan değer:** Yok
yaşama zamanı sayı Cihaz çevrimdışıysa mesajın FCM deposunda ne kadar süre (saniye olarak) saklanması gerektiği. Desteklenmeye devam edecek maksimum süre dört haftadır ve varsayılan değer de dört haftadır. Daha fazla bilgi için bkz. Mesajın ömrünü ayarlama . **Varsayılan değer:** 2419200 (saniye cinsinden dört haftayı temsil eder)

MessagingOptions.collapseKey

Dağıtım devam ettirildiğinde yalnızca son mesajın gönderilmesi için daraltılabilen bir grup mesajı (örneğin, "Güncellemeler Mevcut") tanımlayan dize. Bu, cihaz tekrar çevrimiçi olduğunda veya aktif olduğunda aynı mesajların çok fazla gönderilmesini önlemek için kullanılır.

Mesajların gönderilme sırasının garantisi yoktur.

Herhangi bir zamanda en fazla dört farklı daraltma anahtarına izin verilir. Bu, FCM sunucusunun, istemci uygulaması başına dört farklı senkronizasyona gönderme mesajını aynı anda depolayabileceği anlamına gelir. Bu sayıyı aşarsanız FCM sunucusunun hangi dört daraltma anahtarını tutacağının garantisi yoktur.

**Varsayılan değer:** Yok

İmza:

collapseKey?: string;

MessagingOptions.contentAvailable

iOS'ta APN yükünde content-available temsil etmek için bu alanı kullanın. Bir bildirim veya veri mesajı gönderildiğinde ve bu true olarak ayarlandığında etkin olmayan bir istemci uygulaması uyandırılır. Android'de veri mesajları uygulamayı varsayılan olarak uyandırır. Chrome'da bu işaret şu anda desteklenmiyor.

**Varsayılan değer:** false

İmza:

contentAvailable?: boolean;

MessagingOptions.dryRun

Mesajın gerçekten gönderilip gönderilmeyeceği. true olarak ayarlandığında , geliştiricilerin aslında bir mesaj göndermeden bir isteği test etmesine olanak tanır. false olarak ayarlandığında , mesaj gönderilecektir.

**Varsayılan değer:** false

İmza:

dryRun?: boolean;

MessagingOptions.mutableContent

iOS'ta APN yükündeki mutable-content temsil etmek için bu alanı kullanın. Bir bildirim gönderildiğinde ve bu true olarak ayarlandığında , Bildirim Hizmeti uygulama uzantısı kullanılarak bildirimin içeriği görüntülenmeden önce değiştirilebilir .

Android ve Web'de bu parametre göz ardı edilecektir.

**Varsayılan değer:** false

İmza:

mutableContent?: boolean;

MessagingOptions.priority

Mesajın önceliği. Geçerli değerler "normal" ve "high". iOS'ta bunlar APN öncelikleri 5 ve 10 karşılık gelir .

Varsayılan olarak, bildirim mesajları yüksek öncelikle, veri mesajları ise normal öncelikle gönderilir. Normal öncelik, istemci uygulamasının pil tüketimini optimize eder ve hemen teslim gerekmediği sürece kullanılmalıdır. Normal öncelikli mesajlar için uygulama, mesajı belirtilmemiş bir gecikmeyle alabilir.

Yüksek öncelikli bir mesaj gönderildiğinde hemen gönderilir ve uygulama uyuyan cihazı uyandırıp sunucunuza bir ağ bağlantısı açabilir.

Daha fazla bilgi için bkz. Bir mesajın önceliğini ayarlama .

**Varsayılan değer:** Bildirim mesajları için "high" , veri mesajları için "normal"

İmza:

priority?: string;

MessagingOptions.restrictedPackageName

Mesajın alınabilmesi için kayıt belirteçlerinin eşleşmesi gereken uygulamanın paket adı.

**Varsayılan değer:** Yok

İmza:

restrictedPackageName?: string;

MessagingOptions.timeToLive

Cihaz çevrimdışıysa mesajın FCM deposunda ne kadar süre (saniye olarak) saklanması gerektiği. Desteklenmeye devam edecek maksimum süre dört haftadır ve varsayılan değer de dört haftadır. Daha fazla bilgi için bkz. Mesajın ömrünü ayarlama .

**Varsayılan değer:** 2419200 (saniye cinsinden dört haftayı temsil eder)

İmza:

timeToLive?: number;