Eski FCM API'leri aracılığıyla mesaj gönderirken sunulabilecek seçenekleri temsil eden arayüz.
Kod örnekleri ve ayrıntılı belgeler için Derleme istekleri derleme sayfasına göz atın.
İmza:
export interface MessagingOptions
Özellikler
Özellik | Tür | Açıklama |
---|---|---|
daraltmaAnahtarı | dize | Dağıtım devam ettirildiğinde yalnızca son iletinin gönderilmesi için daraltılabilen bir ileti grubunu (örneğin, "Güncellemeler Mevcut") tanımlayan dize. Cihaz tekrar çevrimiçi olduğunda veya etkin hale geldiğinde aynı mesajların çok sayıda gönderilmesini önlemek için kullanılır.Mesajların hangi sırayla gönderileceğine dair bir garanti yoktur.Herhangi bir zamanda en fazla dört farklı daraltma anahtarına izin verilir. Bu, FCM sunucusunun istemci uygulaması başına aynı anda dört farklı senkronizasyon için gönder mesajı depolayabileceği anlamına gelir. Bu sayıyı aşarsanız FCM sunucusunun hangi dört daraltma anahtarını saklayacağı garanti edilmez.**Varsayılan değer:** Yok |
contentKullanılabilir | boolean | iOS'te, APN yükünde content-available değerini göstermek için bu alanı kullanın. Bir bildirim veya veri mesajı gönderildiğinde ve bu ayar true olarak ayarlandığında etkin olmayan bir istemci uygulaması uyanır. Android'de, veri mesajları varsayılan olarak uygulamayı uyandırır. Bu işaret, Chrome'da şu anda desteklenmiyor.**Varsayılan değer:** false |
dryRun | boolean | Mesajın gerçekten gönderilip gönderilmeyeceği. true olarak ayarlanırsa geliştiricilerin gerçekten mesaj göndermeden bir isteği test etmesine olanak tanır. false olarak ayarlandığında mesaj gönderilir.**Varsayılan değer:** false |
mutableContent | boolean | iOS'te, APN yükünde mutable-content değerini göstermek için bu alanı kullanın. Bir bildirim gönderildiğinde ve bu değer true olarak ayarlandığında, bildirimin içeriği görüntülenmeden önce Bildirim Hizmeti uygulama uzantısı kullanılarak değiştirilebilir.Android ve Web'de bu parametre yoksayılır.**Varsayılan değer:** false |
öncelik | dize | Mesajın önceliği. Geçerli değerler "normal" ve "high". iOS'te bunlar, 5 ve 10 APNs önceliklerine karşılık gelir.Varsayılan olarak, bildirim mesajları yüksek öncelikli, veri mesajları ise normal öncelikle gönderilir. Normal öncelik, istemci uygulamasının pil tüketimini optimize eder ve acil teslimat gerekmiyorsa kullanılmalıdır. Normal öncelikli mesajlarda uygulama, mesajı belirtilmemiş bir gecikmeyle alabilir.Bir mesaj, yüksek öncelikte gönderildiğinde hemen gönderilir ve uygulama, uyku modundan çıkan bir cihazı uyandırarak sunucunuza yönelik bir ağ bağlantısı açabilir.Daha fazla bilgi için Bir iletinin önceliğini ayarlama başlıklı makaleye göz atın.**Varsayılan değer:** Bildirim mesajları için "high" , veri mesajları için "normal" |
restrictedPackageName | dize | Mesajı almak için kayıt jetonlarının eşleşmesi gereken uygulamanın paket adı.**Varsayılan değer:** Yok |
Canlı Yayın Süresi | sayı | Cihaz çevrimdışıysa mesajın FCM depolama alanında ne kadar süre (saniye cinsinden) saklanması gerektiği. Desteklenme süresi maksimum dört haftadır, varsayılan değer de dört haftadır. Daha fazla bilgi için Bir iletinin kullanım ömrünü ayarlama bölümüne bakın.**Varsayılan değer:** 2419200 (saniye cinsinden dört haftayı temsil eder) |
MessagingOptions.daraltmaAnahtarı
Dağıtım devam ettirildiğinde yalnızca son iletinin gönderilmesi için daraltılabilen bir ileti grubunu (örneğin, "Güncellemeler Mevcut") tanımlayan dize. Bu özellik, cihaz tekrar çevrimiçi olduğunda veya etkin hale geldiğinde aynı iletilerin çok sayıda gönderilmesini önlemek için kullanılır.
Mesajların hangi sırayla gönderileceği konusunda garanti verilmez.
Herhangi bir zamanda en fazla dört farklı daraltma anahtarına izin verilir. Bu, FCM sunucusunun istemci uygulaması başına aynı anda dört farklı senkronizasyon için gönder mesajı depolayabileceği anlamına gelir. Bu sayıyı aşarsanız, FCM sunucusunun hangi dört daraltma anahtarını saklayacağı konusunda bir garanti yoktur.
**Varsayılan değer:** Yok
İmza:
collapseKey?: string;
MessagingOptions.contentKullanılabilir
iOS'te, APN yükünde content-available
değerini göstermek için bu alanı kullanın. Bir bildirim veya veri mesajı gönderildiğinde ve bu ayar true
olarak ayarlandığında etkin olmayan bir istemci uygulaması uyanır. Android'de, veri mesajları varsayılan olarak uygulamayı uyandırır. Chrome'da bu bayrak şu anda desteklenmiyor.
**Varsayılan değer:** false
İmza:
contentAvailable?: boolean;
MessagingOptions.dryRun
Mesajın gerçekten gönderilip gönderilmeyeceği. true
olarak ayarlanırsa geliştiricilerin mesaj göndermeden isteği test etmesine olanak tanır. false
olarak ayarlandığında mesaj gönderilir.
**Varsayılan değer:** false
İmza:
dryRun?: boolean;
MessagingOptions.mutableContent
iOS'te, APN yükünde mutable-content
değerini göstermek için bu alanı kullanın. Bir bildirim gönderildiğinde ve bu ayar true
olarak ayarlandığında bildirimin içeriği, görüntülenmeden önce Bildirim Hizmeti uygulama uzantısı kullanılarak değiştirilebilir.
Android ve web'de bu parametre yoksayılır.
**Varsayılan değer:** false
İmza:
mutableContent?: boolean;
MessagingOptions.öncelik
Mesajın önceliği. Geçerli değerler "normal"
ve "high".
iOS'te bunlar, 5
ve 10
APNs önceliklerine karşılık gelir.
Varsayılan olarak, bildirim mesajları yüksek öncelikli, veri mesajları ise normal öncelikli gönderilir. Normal öncelik, istemci uygulamasının pil tüketimini optimize eder ve acil teslimat gerekmiyorsa kullanılmalıdır. Normal önceliğe sahip mesajlar için uygulama, mesajı belirtilmemiş bir gecikmeyle alabilir.
Yüksek öncelikli bir mesaj gönderildiğinde hemen gönderilir ve uygulama, uyku modunda olan bir cihazı uyandırarak sunucunuza yönelik bir ağ bağlantısı açabilir.
Daha fazla bilgi için Bir iletinin önceliğini ayarlama başlıklı makaleye bakın.
**Varsayılan değer:** Bildirim mesajları için "high"
, veri mesajları için "normal"
İmza:
priority?: string;
MessagingOptions.restrictedPackageName
Mesajı almak için kayıt jetonlarının eşleşmesi gereken uygulamanın paket adı.
**Varsayılan değer:** Yok
İmza:
restrictedPackageName?: string;
MessagingOptions.timeToLive
Cihaz çevrimdışıysa mesajın FCM depolama alanında ne kadar süre (saniye cinsinden) saklanması gerektiği. Desteklenme süresi maksimum dört haftadır, varsayılan değer de dört haftadır. Daha fazla bilgi için Bir iletinin kullanım ömrünü ayarlama konusuna bakın.
**Varsayılan değer:** 2419200
(saniye cinsinden dört haftayı temsil eder)
İmza:
timeToLive?: number;