AndroidConfig'e eklenebilecek Android'e özgü bildirim seçeneklerini temsil eder .
İmza:
export interface AndroidNotification
Özellikler
Mülk | Tip | Tanım |
---|---|---|
vücut | sicim | Android bildiriminin gövdesi. Sağlandığında admin.messaging.Notification aracılığıyla ayarlanan gövdeyi geçersiz kılar. |
bodyLocArgs | sicim[] | bodyLocKey içindeki biçim belirticilerin yerine kullanılacak kaynak anahtarlarının dizisi. |
vücut kilidi anahtarı | sicim | Gövde metnini yerelleştirmek için kullanılacak uygulamanın dize kaynağındaki gövde dizesinin anahtarı. |
kanal kimliği | sicim | Android bildirim kanalı kimliği (Android O'da yeni). Bu kanal kimliğine sahip herhangi bir bildirimin alınabilmesi için uygulamanın bu kanal kimliğine sahip 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 manifestinde belirtilen kanal kimliğini kullanır. |
tıklamaEylemi | sicim | Bir kullanıcının bildirime tıklamasıyla ilişkili eylem. Belirtilmişse, kullanıcı bildirimi tıkladığında eşleşen Amaç Filtresine sahip bir etkinlik başlatılır. |
renk | sicim | #rrggbb biçiminde bildirim simgesi rengi. |
varsayılanIşıkAyarları | 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 ayarlanmışsa ve light_settings de ayarlanmışsa, varsayılan değer yerine kullanıcı tarafından belirlenen light_settings kullanılır. |
varsayılanSes | 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 . |
varsayılanTitreşimZamanlamaları | boolean | true olarak ayarlanırsa bildirim için Android çerçevesinin varsayılan titreşim modelini kullanın. Varsayılan değerler config.xml dosyasında belirtilmiştir . default_vibrate_timings true olarak ayarlanmışsa ve vibrate_timings de ayarlanmışsa, kullanıcı tarafından belirlenen vibrate_timings yerine varsayılan değer kullanılır. |
olayZaman damgası | Tarih | Kullanıcıları mutlak zaman referansıyla olaylar hakkında bilgilendiren bildirimler için, bildirimdeki olayın gerçekleştiği zamanı ayarlar. Paneldeki bildirimler bu zamana göre sıralanır. |
simge | sicim | Android bildirimi için simge kaynağı. |
resimUrl'si | sicim | Bildirimde görüntülenecek resmin URL'si. |
ışıkAyarları | IşıkAyarları | Cihazda LED varsa, bildirimin LED'inin yanıp sönme hızını ve rengini kontrol etmeye yönelik ayarlar. Toplam yanıp sönme süresi işletim sistemi tarafından kontrol edilir. |
Sadece yerel | boolean | Bu bildirimin yalnızca geçerli cihazla ilgili olup olmayacağını ayarlar. Bazı bildirimler, Wear OS saati gibi uzaktan görüntülenmek üzere diğer cihazlara köprülenebilir. Bu ipucu, bu bildirimin köprülenmemesini önerecek şekilde ayarlanabilir. Wear OS kılavuzlarına bakın . |
bildirimSayısı | sayı | Bu bildirimin temsil ettiği öğe sayısını ayarlar. Rozetlemeyi destekleyen Başlatıcılar için rozet sayısı olarak görüntülenebilir. NotificationBadge'a bakın . Örneğin, birden fazla yeni iletiyi temsil etmek 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, kimlik doğrulamayı destekleyen sistemler varsayılanı kullanır; bu, her yeni bildirim geldiğinde uzun basılan menüde görüntülenen sayının artırılmasıdır. |
öncelik | ('min' | 'düşük' | 'varsayılan' | 'yüksek' | 'maks') | Bu bildirimin göreceli önceliğini ayarlar. Düşük öncelikli bildirimler belirli durumlarda kullanıcıdan gizlenebilir. Bu önceliğin AndroidMessagePriority farklı olduğunu unutmayın. Bu öncelik, mesaj teslim edildikten sonra müşteri tarafından işlenir. AndroidMessagePriority ise mesajın ne zaman teslim edildiğini kontrol eden bir FCM konseptidir. |
ses | sicim | Cihaz bildirimi aldığında çalınacak sesin dosya adı. |
yapışkan | boolean | false olarak ayarlandığında veya ayarlanmadan kaldırıldığında, kullanıcı panelde tıkladığında bildirim otomatik olarak kapatılır. true olarak ayarlandığında, kullanıcı tıklasa bile bildirim devam eder. |
etiket | sicim | Bildirim etiketi. Bu, bildirim çekmecesindeki mevcut bildirimleri değiştirmek için kullanılan bir tanımlayıcıdır. Belirtilmediği takdirde her istek yeni bir bildirim oluşturur. |
şerit şeridi | sicim | Erişilebilirlik hizmetlerine gönderilen "ticker" metnini ayarlar. API düzeyi 21'den (Lollipop) önce, bildirim ilk geldiğinde durum çubuğunda görüntülenen metni ayarlar. |
başlık | sicim | Android bildiriminin başlığı. Sağlandığında admin.messaging.Notification aracılığıyla ayarlanan başlığı geçersiz kılar. |
titleLocArgs | sicim[] | titleLocKey içindeki biçim belirticilerin yerine kullanılacak kaynak anahtarları dizisi. |
titleLocKey | sicim | Başlık metnini yerelleştirmek için kullanılacak uygulamanın dize kaynağındaki başlık dizesinin anahtarı. |
titreşimZamanlamalarMillis | sayı[] | Kullanılacak titreşim modelini ayarlar. Titreşimi açmak veya kapatmak için bir dizi milisaniyeyi iletin. İlk değer vibratörü çalıştırmadan önce beklenecek süreyi gösterir. Bir sonraki değer vibratörün açık tutulacağı süreyi gösterir. Sonraki değerler, vibratörü kapatma ve vibratörü açma süresi arasında geçiş yapar. vibrate_timings ayarlanmışsa ve default_vibrate_timings true olarak ayarlanmışsa, kullanıcı tarafından belirlenen vibrate_timings yerine varsayılan değer kullanılır. |
görünürlük | ('özel' | 'genel' | 'gizli') | Bildirimin görünürlüğünü ayarlar. private , public veya secret olmalıdır. Belirtilmezse varsayılan olarak private olur. |
AndroidNotification.body
Android bildiriminin gövdesi. Sağlandığında admin.messaging.Notification
aracılığıyla ayarlanan gövdeyi geçersiz kılar .
İmza:
body?: string;
AndroidNotification.bodyLocArgs
bodyLocKey
format belirticilerin yerine kullanılacak kaynak anahtarları dizisi .
İmza:
bodyLocArgs?: string[];
AndroidNotification.bodyLocKey
Gövde metnini yerelleştirmek için kullanılacak uygulamanın dize kaynağındaki gövde dizesinin anahtarı.
İmza:
bodyLocKey?: string;
AndroidNotification.channelId
Android bildirim kanalı kimliği (Android O'da yeni). Bu kanal kimliğine sahip herhangi bir bildirimin alınabilmesi için uygulamanın bu kanal kimliğine sahip 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 manifestinde belirtilen kanal kimliğini kullanır.
İmza:
channelId?: string;
AndroidNotification.clickAction
Bir kullanıcının bildirime tıklamasıyla ilişkili eylem. Belirtilmişse, kullanıcı bildirimi tıkladığında eşleşen Amaç Filtresine sahip bir etkinlik başlatılır.
İmza:
clickAction?: string;
AndroidNotification.color
#rrggbb
biçiminde bildirim simgesi rengi.
İmza:
color?: string;
AndroidNotification.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 ayarlanmışsa ve light_settings
de ayarlanmışsa, varsayılan değer yerine kullanıcı tarafından belirlenen light_settings
kullanılır.
İmza:
defaultLightSettings?: boolean;
AndroidNotification.defaultSound
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;
AndroidNotification.defaultVibrateTimings
true
olarak ayarlanırsa bildirim için Android çerçevesinin varsayılan titreşim modelini kullanın. Varsayılan değerler config.xml dosyasında belirtilmiştir . default_vibrate_timings
true
olarak ayarlanmışsa ve vibrate_timings
de ayarlanmışsa kullanıcı tarafından belirlenen vibrate_timings
yerine varsayılan değer kullanılır .
İmza:
defaultVibrateTimings?: boolean;
AndroidNotification.eventTimestamp
Kullanıcıları mutlak zaman referansıyla olaylar hakkında bilgilendiren bildirimler için, bildirimdeki olayın gerçekleştiği zamanı ayarlar. Paneldeki bildirimler bu zamana göre sıralanır.
İmza:
eventTimestamp?: Date;
AndroidNotification.icon
Android bildirimi için simge kaynağı.
İmza:
icon?: string;
AndroidNotification.imageUrl
Bildirimde görüntülenecek resmin URL'si.
İmza:
imageUrl?: string;
AndroidNotification.lightSettings
Cihazda LED varsa, bildirimin LED'inin yanıp sönme hızını ve rengini kontrol etmeye yönelik ayarlar. Toplam yanıp sönme süresi işletim sistemi tarafından kontrol edilir.
İmza:
lightSettings?: LightSettings;
AndroidNotification.localOnly
Bu bildirimin yalnızca geçerli cihazla ilgili olup olmayacağını ayarlar. Bazı bildirimler, Wear OS saati gibi uzaktan görüntülenmek üzere diğer cihazlara köprülenebilir. Bu ipucu, bu bildirimin köprülenmemesini önerecek şekilde ayarlanabilir. Wear OS kılavuzlarına bakın .
İmza:
localOnly?: boolean;
AndroidNotification.notificationCount
Bu bildirimin temsil ettiği öğe sayısını ayarlar. Rozetlemeyi destekleyen Başlatıcılar için rozet sayısı olarak görüntülenebilir. NotificationBadge'a bakın . Örneğin, birden fazla yeni iletiyi temsil etmek 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, kimlik doğrulamayı destekleyen sistemler varsayılanı kullanır; bu, her yeni bildirim geldiğinde uzun basılan menüde görüntülenen sayının artırılmasıdır.
İmza:
notificationCount?: number;
AndroidNotification.priority
Bu bildirimin göreceli önceliğini ayarlar. Düşük öncelikli bildirimler belirli durumlarda kullanıcıdan gizlenebilir. Bu önceliğin AndroidMessagePriority
farklı olduğunu unutmayın . Bu öncelik, mesaj teslim edildikten sonra müşteri tarafından işlenir. AndroidMessagePriority
ise mesajın ne zaman teslim edildiğini kontrol eden bir FCM konseptidir.
İmza:
priority?: ('min' | 'low' | 'default' | 'high' | 'max');
AndroidNotification.sound
Cihaz bildirimi aldığında çalınacak sesin dosya adı.
İmza:
sound?: string;
AndroidNotification.sticky
false
olarak ayarlandığında veya ayarlanmadan kaldırıldığında, kullanıcı panelde tıkladığında bildirim otomatik olarak kapatılır. true
olarak ayarlandığında , kullanıcı tıkladığında bile bildirim devam eder.
İmza:
sticky?: boolean;
AndroidNotification.tag
Bildirim etiketi. Bu, bildirim çekmecesindeki mevcut bildirimleri değiştirmek için kullanılan bir tanımlayıcıdır. Belirtilmediği takdirde her istek yeni bir bildirim oluşturur.
İmza:
tag?: string;
AndroidNotification.ticker
Erişilebilirlik hizmetlerine gönderilen "ticker" metnini ayarlar. API düzeyi 21'den (Lollipop) önce, bildirim ilk geldiğinde durum çubuğunda görüntülenen metni ayarlar.
İmza:
ticker?: string;
AndroidNotification.title
Android bildiriminin başlığı. Sağlandığında admin.messaging.Notification
aracılığıyla ayarlanan başlığı geçersiz kılar .
İmza:
title?: string;
AndroidNotification.titleLocArgs
titleLocKey
format belirticilerin yerine kullanılacak kaynak anahtarları dizisi .
İmza:
titleLocArgs?: string[];
AndroidNotification.titleLocKey
Başlık metnini yerelleştirmek için kullanılacak uygulamanın dize kaynağındaki başlık dizesinin anahtarı.
İmza:
titleLocKey?: string;
AndroidNotification.vibrateTimingsMillis
Kullanılacak titreşim modelini ayarlar. Titreşimi açmak veya kapatmak için bir dizi milisaniyeyi iletin. İlk değer vibratörü çalıştırmadan önce beklenecek süreyi gösterir. Bir sonraki değer vibratörün açık tutulacağı süreyi gösterir. Sonraki değerler, vibratörü kapatma ve vibratörü açma süresi arasında geçiş yapar. vibrate_timings
ayarlanmışsa ve default_vibrate_timings
true
olarak ayarlanmışsa kullanıcı tarafından belirlenen vibrate_timings
yerine varsayılan değer kullanılır .
İmza:
vibrateTimingsMillis?: number[];
AndroidNotification.visibility
Bildirimin görünürlüğünü ayarlar. private
olmalı , public
veya secret
. Belirtilmezse varsayılan olarak private
olur .
İmza:
visibility?: ('private' | 'public' | 'secret');