AndroidConfig'e dahil edilebilecek Android'e özel bildirim seçeneklerini temsil eder.
İmza:
export interface AndroidNotification
Özellikler
Özellik | Tür | Açıklama |
---|---|---|
body | dize | Android bildiriminin gövdesi. Bu değer sağlandığında admin.messaging.Notification aracılığıyla ayarlanan gövdeyi geçersiz kılar. |
bodyLocArgs | dize[] | bodyLocKey içindeki biçim belirteçlerin yerine kullanılacak kaynak anahtarları dizisi. |
bodyLocKey | dize | Gövde metnini yerelleştirmek için kullanılacak uygulamanın dize kaynağındaki gövde dizesinin anahtarı. |
kanalkimliği | dize | Android bildirim kanalı kimliği (Android O'da yenidir). Bu kanal kimliğine sahip herhangi bir bildirimin alınabilmesi için uygulamanın bu kanal kimliğiyle bir kanal oluşturması gerekir. İstekte bu kanal kimliğini göndermezseniz veya sağlanan kanal kimliği henüz uygulama tarafından oluşturulmamışsa FCM, uygulama manifest dosyasında belirtilen kanal kimliğini kullanır. |
clickAction | dize | Bildirimdeki bir kullanıcı tıklamasıyla ilişkilendirilmiş işlem. Belirtilirse kullanıcı bildirimi tıkladığında eşleşen Intent Filtresine sahip bir etkinlik başlatılır. |
color [renk] | dize | #rrggbb biçimindeki bildirim simgesi rengi. |
defaultLightSettings (varsayılan ışık ayarları) | boolean | true olarak ayarlanırsa bildirim için Android çerçevesinin varsayılan LED ışık ayarlarını kullanın. Varsayılan değerler config.xml dosyasında belirtilmiştir. default_light_settings , true olarak ayarlandıysa ve light_settings de ayarlanırsa varsayılan değer yerine kullanıcı tarafından belirtilen light_settings kullanılır. |
defaultSes | boolean | true olarak ayarlanırsa bildirim için Android çerçevesinin varsayılan sesini kullanın. Varsayılan değerler config.xml dosyasında belirtilmiştir. |
defaultVibrateTimings | boolean | true değerine ayarlanırsa bildirim için Android çerçevesinin varsayılan titreşim desenini kullanın. Varsayılan değerler config.xml dosyasında belirtilmiştir. default_vibrate_timings , true olarak ayarlandıysa ve vibrate_timings de ayarlanırsa kullanıcı tarafından belirtilen vibrate_timings yerine varsayılan değer kullanılır. |
eventTimestamp (EtkinlikZaman Damgası) | Tarih | Kullanıcıları mutlak zaman referansı olan etkinlikler hakkında bilgilendiren bildirimler için bildirimdeki etkinliğin gerçekleştiği zamanı ayarlar. Paneldeki bildirimler bu zamana göre sıralanır. |
simge | dize | Android bildiriminin simge kaynağı. |
resimUrl | dize | Bildirimde gösterilecek resmin URL'si. |
lightSettings | Işık Ayarları | Cihazda LED kullanılabiliyorsa bildirimin LED yanıp sönme hızını ve rengini kontrol etmek için kullanılan ayarlar. Toplam yanıp sönme süresi işletim sistemi tarafından kontrol edilir. |
localOnly | boolean | Bu bildirimin yalnızca geçerli cihazla alakalı olup olmadığını belirler. Bazı bildirimler, uzak görüntüleme için Wear OS kol saati gibi diğer cihazlara köprü olarak eklenebilir. Bu ipucu, bu bildirimin köprü görevini üstlenmemesi için ayarlanabilir. Wear OS kılavuzlarına bakın. |
notificationCount | sayı | Bu bildirimin temsil ettiği öğe sayısını ayarlar. Rozetleri destekleyen başlatıcılar için rozet sayısı olarak gösterilebilir. BildirimBadge bölümünü inceleyin. Örneğin, birden çok yeni iletiyi temsil etmesi için yalnızca bir bildirim kullanıyorsanız ancak buradaki sayının toplam yeni ileti sayısını temsil etmesini istiyorsanız bu yararlı olabilir. Sıfır veya belirtilmemişse rozeti destekleyen sistemler varsayılanı kullanır. Bu, uzun basma menüsünde yeni bir bildirim geldiğinde gösterilen sayıyı artırmaktır. |
öncelik | ('min' | 'düşük' | 'varsayılan' | 'yüksek' | 'maks') | Bu bildirim için göreli önceliği ayarlar. Düşük öncelikli bildirimler belirli durumlarda kullanıcıdan gizlenebilir. Bu önceliğin AndroidMessagePriority değerinden farklı olduğunu unutmayın. Bu öncelik, ileti teslim edildikten sonra istemci tarafından işlenir. AndroidMessagePriority ise mesajın ne zaman teslim edileceğini kontrol eden bir FCM kavramıdır. |
ses | dize | Cihaz bildirimi aldığında çalınacak sesin dosya adı. |
yapışkan | boolean | false değerine ayarlanır veya ayarlanmadan bırakılırsa kullanıcı panelde tıkladığında bildirim otomatik olarak kapatılır. true olarak ayarlanırsa kullanıcı tıklasa bile bildirim gösterilmeye devam eder. |
etiket | dize | Bildirim etiketi. Bu, bildirim çekmecesindeki mevcut bildirimlerin yerine kullanılan bir tanımlayıcıdır. Belirtilmezse her istek yeni bir bildirim oluşturur. |
borsa kodu | dize | "Sohbet şeridi"ni ayarlar erişilebilirlik hizmetlerine gönderilir. API düzeyi 21'den (Lollipop) önce, bildirim ilk geldiğinde durum çubuğunda görüntülenen metni ayarlar. |
title | dize | Android bildiriminin başlığı. Bu değer sağlandığında admin.messaging.Notification aracılığıyla ayarlanan başlığı geçersiz kılar. |
BaşlıkLocArgs | dize[] | titleLocKey içindeki biçim belirteçlerin yerine kullanılacak kaynak anahtarları dizisi. |
BaşlıkKonumuAnahtarı | dize | Başlık metnini yerelleştirmek için kullanılacak uygulamanın dize kaynağındaki başlık dizesinin anahtarı. |
titreşim zamanlamaları | numara[] | Kullanılacak titreşim modelini ayarlar. Titreşimi açmak veya kapatmak için milisaniye cinsinden bir değer girin. İlk değer, titreşimi açmadan önce beklenecek süreyi gösterir. Sonraki değer, titreşimin açık kalacağı süreyi gösterir. Sonraki değerler, titreşimi kapatma ve açma için süre arasında değişir. vibrate_timings ayarlanır ve default_vibrate_timings , true olarak ayarlanırsa kullanıcı tarafından belirtilen vibrate_timings yerine varsayılan değer kullanılır. |
görünürlük | ('gizli' | 'herkese açık' | 'gizli') | Bildirimin görünürlüğünü ayarlar. private , public veya secret olmalıdır. Belirtilmemişse varsayılan olarak private olur. |
AndroidBildirimi.body
Android bildiriminin gövdesi. Bu değer sağlandığında admin.messaging.Notification
aracılığıyla ayarlanan gövdeyi geçersiz kılar.
İmza:
body?: string;
AndroidBildirimi.bodyLocArgs
bodyLocKey
öğesindeki biçim belirteçlerin yerine kullanılacak bir kaynak anahtarları dizisi.
İmza:
bodyLocArgs?: string[];
AndroidBildirimi.bodyLocKey
Gövde metnini yerelleştirmek için kullanılacak uygulamanın dize kaynağındaki gövde dizesinin anahtarı.
İmza:
bodyLocKey?: string;
AndroidBildirimi.Kanal Kimliği
Android bildirim kanalı kimliği (Android O'da yenidir). Bu kanal kimliğine sahip herhangi bir bildirimin alınabilmesi için uygulamanın bu kanal kimliğiyle bir kanal oluşturması gerekir. İstekte bu kanal kimliğini göndermezseniz veya sağlanan kanal kimliği henüz uygulama tarafından oluşturulmamışsa FCM, uygulama manifest dosyasında belirtilen kanal kimliğini kullanır.
İmza:
channelId?: string;
AndroidBildirimi.tıklamaİşlemi
Bildirimdeki bir kullanıcı tıklamasıyla ilişkilendirilmiş işlem. Belirtilirse kullanıcı bildirimi tıkladığında eşleşen Intent Filtresine sahip bir etkinlik başlatılır.
İmza:
clickAction?: string;
AndroidBildirimi.renk
#rrggbb
biçimindeki bildirim simgesi rengi.
İmza:
color?: string;
AndroidBildirimi.defaultLightSettings
true
olarak ayarlanırsa bildirim için Android çerçevesinin varsayılan LED ışık ayarlarını kullanın. Varsayılan değerler config.xml dosyasında belirtilmiştir. default_light_settings
, true
olarak ayarlandıysa ve light_settings
de ayarlanırsa varsayılan değer yerine kullanıcı tarafından belirtilen light_settings
kullanılır.
İmza:
defaultLightSettings?: boolean;
AndroidBildirimi.varsayılanSes
true
olarak ayarlanırsa bildirim için Android çerçevesinin varsayılan sesini kullanın. Varsayılan değerler config.xml dosyasında belirtilmiştir.
İmza:
defaultSound?: boolean;
AndroidBildirimi.defaultVibrateTimings
true
olarak ayarlanırsa bildirim için Android çerçevesinin varsayılan titreşim desenini kullanın. Varsayılan değerler config.xml dosyasında belirtilmiştir. default_vibrate_timings
, true
olarak ayarlandıysa ve vibrate_timings
de ayarlanırsa kullanıcı tarafından belirtilen vibrate_timings
yerine varsayılan değer kullanılır.
İmza:
defaultVibrateTimings?: boolean;
AndroidBildirimi.eventTimestamp
Kullanıcıları mutlak zaman referansı olan etkinlikler hakkında bilgilendiren bildirimler için bildirimdeki etkinliğin gerçekleştiği zamanı ayarlar. Paneldeki bildirimler bu zamana göre sıralanır.
İmza:
eventTimestamp?: Date;
AndroidBildirimi.simgesi
Android bildiriminin simge kaynağı.
İmza:
icon?: string;
AndroidBildirimi.imageUrl
Bildirimde gösterilecek resmin URL'si.
İmza:
imageUrl?: string;
AndroidBildirimi.Işık Ayarları
Cihazda LED kullanılabiliyorsa bildirimin LED yanıp sönme hızını ve rengini kontrol etmek için kullanılan ayarlar. Toplam yanıp sönme süresi işletim sistemi tarafından kontrol edilir.
İmza:
lightSettings?: LightSettings;
AndroidBildirimi.localOnly
Bu bildirimin yalnızca geçerli cihazla alakalı olup olmadığını belirler. Bazı bildirimler, uzak görüntüleme için Wear OS kol saati gibi diğer cihazlara köprü olarak eklenebilir. Bu ipucu, bu bildirimin köprü görevini üstlenmemesi için ayarlanabilir. Wear OS kılavuzlarına bakın.
İmza:
localOnly?: boolean;
AndroidBildirimi.bildirimSayısı
Bu bildirimin temsil ettiği öğe sayısını ayarlar. Rozetleri destekleyen başlatıcılar için rozet sayısı olarak gösterilebilir. BildirimBadge bölümünü inceleyin. Örneğin, birden çok yeni iletiyi temsil etmesi için yalnızca bir bildirim kullanıyorsanız ancak buradaki sayının toplam yeni ileti sayısını temsil etmesini istiyorsanız bu yararlı olabilir. Sıfır veya belirtilmemişse rozeti destekleyen sistemler varsayılanı kullanır. Bu, uzun basma menüsünde yeni bir bildirim geldiğinde gösterilen sayıyı artırmaktır.
İmza:
notificationCount?: number;
AndroidBildirimi önceliği
Bu bildirim için göreli önceliği ayarlar. Düşük öncelikli bildirimler belirli durumlarda kullanıcıdan gizlenebilir. Bu önceliğin AndroidMessagePriority
değerinden farklı olduğunu unutmayın. Bu öncelik, ileti teslim edildikten sonra istemci tarafından işlenir. AndroidMessagePriority
ise mesajın ne zaman teslim edileceğini kontrol eden bir FCM kavramıdır.
İmza:
priority?: ('min' | 'low' | 'default' | 'high' | 'max');
AndroidBildirimi.sound
Cihaz bildirimi aldığında çalınacak sesin dosya adı.
İmza:
sound?: string;
AndroidBildirimi.Sabit
false
değerine ayarlanır veya ayarlanmadan bırakılırsa kullanıcı panelde tıkladığında bildirim otomatik olarak kapatılır. true
olarak ayarlandığında kullanıcı tıklasa bile bildirim gösterilmeye devam eder.
İmza:
sticky?: boolean;
AndroidBildirimi.etiketi
Bildirim etiketi. Bu, bildirim çekmecesindeki mevcut bildirimlerin yerine kullanılan bir tanımlayıcıdır. Belirtilmezse her istek yeni bir bildirim oluşturur.
İmza:
tag?: string;
AndroidNotification.ticker
"Sohbet şeridi"ni ayarlar erişilebilirlik hizmetlerine gönderilir. API düzeyi 21'den (Lollipop) önce, bildirim ilk geldiğinde durum çubuğunda görüntülenen metni ayarlar.
İmza:
ticker?: string;
AndroidBildirimi başlığı
Android bildiriminin başlığı. Bu değer sağlandığında admin.messaging.Notification
aracılığıyla ayarlanan başlığı geçersiz kılar.
İmza:
title?: string;
AndroidBildirimi.titleLocArgs
titleLocKey
öğesindeki biçim belirteçlerin yerine kullanılacak bir kaynak anahtarları dizisi.
İmza:
titleLocArgs?: string[];
AndroidBildirimi.titleLocKey
Başlık metnini yerelleştirmek için kullanılacak uygulamanın dize kaynağındaki başlık dizesinin anahtarı.
İmza:
titleLocKey?: string;
AndroidBildirimi.vibrateTimingsMillis
Kullanılacak titreşim modelini ayarlar. Titreşimi açmak veya kapatmak için milisaniye cinsinden bir değer girin. İlk değer, titreşimi açmadan önce beklenecek süreyi gösterir. Sonraki değer, titreşimin açık kalacağı süreyi gösterir. Sonraki değerler, titreşimi kapatma ve açma için süre arasında değişir. vibrate_timings
ayarlanır ve default_vibrate_timings
, true
olarak ayarlanırsa kullanıcı tarafından belirtilen vibrate_timings
yerine varsayılan değer kullanılır.
İmza:
vibrateTimingsMillis?: number[];
AndroidBildirimi.görünürlük
Bildirimin görünürlüğünü ayarlar. private
, public
veya secret
olmalıdır. Belirtilmemişse varsayılan olarak private
olur.
İmza:
visibility?: ('private' | 'public' | 'secret');