Bildirimlere genel bakış

Bildirim, Android'in kullanıcıya hatırlatıcılar, diğer kullanıcıların iletişimleri veya uygulamanızdan başka zaman bilgileri sağlamak için uygulamanızın kullanıcı arayüzü dışında gösterdiği mesajdır. Kullanıcılar, uygulamanızı açmak için bildirime dokunabilir veya doğrudan bildirimden bir işlem gerçekleştirebilirler.

Bu sayfada, bildirimlerin nerede göründüğüne ve kullanılabilir özelliklere genel bir bakış sunulmaktadır. Bildirim oluşturmaya başlamak için Bildirim oluşturma konusunu okuyun.

Bildirim tasarımı ve etkileşim kalıpları hakkında daha fazla bilgi için Bildirim tasarım kılavuzuna bakın.

Cihazlardaki görünümler

Bildirimler, farklı konum ve biçimlerde kullanıcılara otomatik olarak gösterilir. Durum çubuğunda bir simge, bildirim çekmecesinde daha ayrıntılı bir giriş ve uygulamanın simgesinde bir rozet şeklinde bir bildirim görünür. Bildirimler, eşlenmiş giyilebilir cihazlarda da görünür.

Durum çubuğu ve bildirim çekmecesi

Bir bildirim gönderdiğinizde, bu bildirim öncelikle durum çubuğunda bir simge olarak görünür.

Şekil 1. Bildirim simgeleri durum çubuğunun sol tarafında görünür.

Kullanıcılar, durum çubuğunu aşağı kaydırarak bildirim çekmecesini açabilir. Burada daha fazla ayrıntı görebilir ve bildirimle işlem gerçekleştirebilirler.

Şekil 2. Bildirimler'i tıklayın.

Kullanıcılar, ek içerik ve işlem düğmeleri (varsa) gösteren genişletilmiş görünümü açmak için çekmecedeki bir bildirimi aşağı sürükleyebilirler. Android 13'ten itibaren bu genişletilmiş görünüm, kullanıcıların devam eden ön plan hizmetleri olan bir uygulamayı durdurmasına olanak tanıyan bir düğme içerir.

Bir bildirim, uygulama veya kullanıcı tarafından kapatılana kadar bildirim çekmecesinde görünür.

Uyarı bildirimi

Android 5.0'dan itibaren bildirimler, uyarı bildirimi adı verilen kayan bir pencerede kısa süreliğine gösterilebilir. Bu davranış normalde kullanıcının hemen bilmesi gereken önemli bildirimler için gerçekleştirilir ve yalnızca cihazın kilidi açıkken görünür.

3. Şekil. Ön plan uygulamasının önünde bir uyarı bildirimi görünür.

Uyarı bildirimi, uygulamanız bildirim gönderdiğinde görünür. Kısa bir süre sonra kaybolur, ancak bildirim çekmecesinde her zamanki gibi görünür olmaya devam eder.

Uyarı bildirimlerini tetikleyebilecek koşullar şunlardır:

• Kullanıcının etkinliği tam ekran modundadır (örneğin, uygulama fullScreenIntent kullandığında).

• Bildirim yüksek önceliğe sahiptir ve Android 7.1 (API düzeyi 25) ve önceki sürümleri çalıştıran cihazlarda zil sesleri veya titreşimler kullanır.

• Bildirim kanalı, Android 8.0 (API düzeyi 26) ve sonraki sürümleri çalıştıran cihazlarda yüksek öneme sahiptir.

Kilit ekranı

Android 5.0 sürümünden itibaren bildirimler kilit ekranında görünebilir.

Uygulamanızın yayınladığı bildirimlerin güvenli bir kilit ekranında gösterilip gösterilmeyeceğini ve gösterilecekse ayrıntı düzeyini programatik olarak ayarlayabilirsiniz.

Kullanıcılar, kilit ekranı bildirimlerinde görünen ayrıntı düzeyini seçmek veya tüm kilit ekranı bildirimlerini devre dışı bırakmak için sistem ayarlarını kullanabilirler. Android 8.0'dan itibaren kullanıcılar her bir bildirim kanalı için kilit ekranı bildirimlerini devre dışı bırakabilir veya etkinleştirebilirler.

4. Şekil. Kilit ekranında hassas içeriğin gizlendiği bildirimler.

Daha fazla bilgi edinmek için Kilit ekranı görünürlüğünü ayarlama başlıklı makaleye bakın.

Uygulama simgesi rozeti

Android 8.0 (API düzeyi 26) ve sonraki sürümleri çalıştıran cihazlardaki desteklenen başlatıcılarda, uygulama simgeleri yeni bildirimleri, karşılık gelen uygulama başlatıcı simgesinde bildirim noktası olarak bilinen renkli bir rozet ile belirtir.

Kullanıcılar bir uygulama simgesine dokunup basılı tutarak bir uygulamanın bildirimlerini görebilir. Kullanıcılar, bildirim çekmecesine benzer şekilde bu menüden gelen bildirimleri kapatabilir veya bildirimlerle ilgili işlem yapabilirler.

5.Şekil Bildirim rozetleri ile dokunup basılı tutma menüsü.

Rozetlerin işleyiş şekli hakkında daha fazla bilgi edinmek için Bildirim rozetini değiştirme bölümünü okuyun.

Wear OS cihazlar

Kullanıcının eşlenmiş bir Wear OS cihazı varsa genişletilebilir ayrıntılar ve işlem düğmeleri de dahil olmak üzere tüm bildirimleriniz burada otomatik olarak görünür.

Giyilebilir cihazlarda bildirimlerinizin görünümünü özelleştirerek ve önerilen yanıtlar ve ses girişi yanıtları gibi farklı işlemler sağlayarak daha iyi bir deneyim oluşturabilirsiniz. Daha fazla bilgi için bildiriminize giyilebilir cihazlara özgü özellikleri nasıl ekleyebileceğinizi öğrenin.

6.Şekil Bildirimler, eşlenmiş bir Wear OS cihazda otomatik olarak görünür.

Bildirim anatomisi

Bildirimin tasarımı, sistem şablonlarına göre belirlenir ve uygulamanız şablonun her bir bölümünün içeriğini tanımlar. Bildirimin bazı ayrıntıları yalnızca genişletilmiş görünümde görünür.

7. Şekil. Temel ayrıntıların bulunduğu bir bildirim.

Bildirimlerin en yaygın kısımları Şekil 7'de şu şekilde belirtilmiştir:

1. Küçük simge: zorunlu. setSmallIcon() kullanılarak ayarlayın.
2. Uygulama adı: Sistem tarafından sağlanır.
3. Zaman damgası: Sistem tarafından sağlanır ancak setWhen() ile geçersiz kılabilir veya setShowWhen(false) aracılığıyla gizleyebilirsiniz.
4. Büyük simge: İsteğe bağlıdır. Genellikle yalnızca kişi fotoğrafları için kullanılır. Uygulama simgeniz için kullanmayın. setLargeIcon() ile ayarlayın.
5. Başlık: İsteğe bağlı. setContentTitle() kullanılarak ayarlanır.
6. Metin: İsteğe bağlı. setContentText() kullanılarak ayarlayın.

Tüm cihazlarda uygun tasarım uyumluluğu için sistem şablonlarını kullanmanızı kesinlikle öneririz. Gerekirse özel bir bildirim düzeni oluşturabilirsiniz.

Bu özelliklerle bildirim oluşturma ve daha fazlası hakkında bilgi edinmek için Bildirim oluşturma konusunu okuyun.

Bildirim işlemleri

Zorunlu olmamakla birlikte, her bildirimin dokunulduğunda uygun bir uygulama etkinliği açması iyi bir uygulamadır. Bu varsayılan bildirim işlemine ek olarak, uygulama ile ilgili bir görevi (genellikle bir etkinlik açmadan) bildirimden tamamlayan işlem düğmelerini Şekil 8'de gösterildiği gibi ekleyebilirsiniz.

Şekil 8. İşlem düğmelerine sahip bir bildirim.

Android 7.0 (API düzeyi 24) sürümünden başlayarak, doğrudan bildirimden mesajları yanıtlamak veya başka bir metin girmek için bir işlem ekleyebilirsiniz.

Android 10'dan (API düzeyi 29) itibaren platform, önerilen amaca dayalı işlemleri içeren işlem düğmelerini otomatik olarak oluşturabilir.

İşlem düğmelerinin eklenmesi Bildirim oluşturma bölümünde daha ayrıntılı bir şekilde açıklanmıştır.

Kilidi açık cihaz iste

Kullanıcılar cihazın kilit ekranında bildirim işlemleri görebilir. Bir bildirim işlemi, uygulamanın bir etkinlik başlatmasına veya doğrudan yanıt göndermesine neden oluyorsa uygulamanın bu bildirim işlemini çağırabilmesi için önce kullanıcıların cihazın kilidini açması gerekir.

Android 12 (API düzeyi 31) ve sonraki sürümlerde, uygulamanızın bu işlemi başlatması için cihazın kilidinin açılması gereken ve işlemin hangi iş akışını başlattığı fark etmeksizin bir bildirim işlemi yapılandırabilirsiniz. Bu seçenek, kilitli cihazlardaki bildirimlere fazladan bir güvenlik katmanı ekler.

Uygulamanız belirli bir bildirim işlemini çağırmadan önce bir cihazın kilidinin açılmasını zorunlu kılmak için bildirim işleminizi oluştururken aşağıdaki kod snippet'inde gösterildiği gibi true öğesini setAuthenticationRequired() öğesine iletin:

val moreSecureNotification = Notification.Action.Builder(...)

    // This notification always requests authentication when invoked
    // from a lock screen.
    .setAuthenticationRequired(true)
    .build()

Notification moreSecureNotification = new Notification.Action.Builder(...)

    // This notification always requests authentication when invoked
    // from a lock screen.
    .setAuthenticationRequired(true)
    .build();

Genişletilebilir bildirim

Varsayılan olarak, bildirimin metin içeriği bir satıra sığacak şekilde kesilir. Bildiriminizin daha uzun olmasını istiyorsanız Şekil 9'da gösterildiği gibi ek bir şablon uygulayarak genişletilebilir, daha büyük bir metin alanını etkinleştirebilirsiniz.

Şekil 9. Büyük metin için genişletilebilir bir bildirim.

Ayrıca gelen kutusu stilinde, resim içeren, sohbet ileti dizisi veya medya oynatma denetimleriyle genişletilebilir bir bildirim oluşturabilirsiniz. Daha fazla bilgi için Genişletilebilir bildirim oluşturma bölümünü okuyun.

Bildirim güncellemeleri ve grupları

Ek güncellemeleriniz olduğunda kullanıcılarınızı birden fazla veya gereksiz bildirimle doldurmamak için yeni bir bildirim yayınlamak yerine mevcut bir bildirimi güncelleyin veya ileti dizisi güncellemelerini göstermek için gelen kutusu stilindeki bildirimi kullanın.

Ancak, birden fazla bildirim göndermeniz gerekiyorsa bildirimleri ayrı ayrı, Android 7.0 ve sonraki sürümlerde bir grup altında toplayabilirsiniz.

Bildirim grubu, birden fazla bildirimi, bildirim çekmecesinde özet içeren tek bir yayında daraltmanıza olanak tanır. Şekil 10'da gösterildiği gibi kullanıcı, daha fazla ayrıntı için bildirim grubunu ve içindeki her bildirimi kademeli olarak genişletebilir.

Şekil 10. Daraltılmış ve genişletilmiş bir bildirim grubu.

Bir gruba nasıl bildirim ekleyeceğinizi öğrenmek için Bildirim grubu oluşturma konusuna bakın.

Bildirim kanalları

Android 8.0 (API düzeyi 26) sürümünden başlayarak, tüm bildirimlerin bir kanala atanması gerekir; aksi takdirde, bildirimler görünmez. Bu, kullanıcıların tüm bildirimlerinizi devre dışı bırakmak yerine uygulamanız için belirli bildirim kanallarını devre dışı bırakmasına olanak tanır. Kullanıcılar, Şekil 11'de gösterildiği gibi, her bir kanalın görsel ve işitsel seçeneklerini Android sistem ayarlarından kontrol edebilir. Kullanıcılar, ilişkili kanalın davranışlarını değiştirmek için bir bildirime dokunup basılı da tutabilirler.

Android 7.1 (API düzeyi 25) ve önceki sürümleri çalıştıran cihazlarda kullanıcılar bildirimleri yalnızca uygulama bazında yönetebilir. Android 7.1 ve önceki sürümlerde her uygulamanın etkin bir şekilde yalnızca bir kanalı vardır.

Şekil 11. Saat uygulaması ve kanallarından biri için bildirim ayarları.

Bir uygulamanın, uygulamanın yayınladığı her bildirim türü için ayrı kanalları olabilir. Uygulamalar, kullanıcıların yaptığı seçimlere yanıt olarak bildirim kanalları da oluşturabilir. Örneğin, bir kullanıcının bir mesajlaşma uygulamasında oluşturduğu her görüşme grubu için ayrı bildirim kanalları oluşturabilirsiniz.

Kanal, aynı zamanda Android 8.0 ve sonraki sürümlerde bildirimlerin önem düzeyini belirttiğiniz yerdir. Bu nedenle, aynı bildirim kanalında yayınlanan tüm bildirimler aynı davranışa sahiptir. Bu, aşağıdaki bölümde açıklanmıştır.

Daha fazla bilgi için Bildirim kanalları oluşturma ve yönetme başlıklı makaleyi inceleyin.

Bildirimlerin önemi

Android, bir bildirimin kullanıcının çalışmasını ne kadar görsel ve işitsel olarak kesintiye uğrattığını belirlemek için bildirimin önem değerini kullanır. Bir bildirimin önem düzeyi ne kadar yüksek olursa bildirim o kadar kesintiye uğrar.

Android 7.1 (API düzeyi 25) ve önceki sürümlerde bir bildirimin önemi, bildirimin priority değerine göre belirlenir.

Android 8.0 (API düzeyi 26) ve sonraki sürümlerde bir bildirimin önemi, bildirimin yayınlandığı kanalın importance ayarına göre belirlenir. Kullanıcılar, sistem ayarlarından bildirim kanalının önemini Şekil 12'de gösterildiği gibi değiştirebilir.

Şekil 12. Kullanıcılar, Android 8.0 ve sonraki sürümlerde her bir kanalın önemini değiştirebilir.

Olası önem düzeyleri ve ilişkili bildirim davranışları aşağıdaki gibidir:

• Acil: Bir ses çıkarır ve uyarı bildirimi olarak görünür.

• Yüksek: Ses çıkarır.

• Orta: Ses çıkarmaz.

• Düşük: Ses çıkarmaz ve durum çubuğunda görünmez.

Önemlerine bakılmaksızın, tüm bildirimler sistem tarafından bölünmeyen kullanıcı arayüzü konumlarında, örneğin bildirim çekmecesinde ve başlatıcı simgesinde rozet olarak görünür. Ancak bildirim rozetinin görünümünü değiştirebilirsiniz.

Daha fazla bilgi için önemi ayarlama konulu makaleyi okuyun.

Rahatsız Etmeyin modu

Android 5.0 (API düzeyi 21) sürümünden başlayarak, kullanıcılar tüm bildirimler için sesi ve titreşimi kapatan Rahatsız Etmeyin modunu etkinleştirebilirler. Kullanıcı aksini belirtmedikçe, bildirimler sistem kullanıcı arayüzünde normal şekilde görünmeye devam eder.

Rahatsız Etmeyin modunda üç düzey vardır:

• Tamamen sessiz: Alarmlar, müzik, videolar ve oyunlar da dahil olmak üzere tüm sesleri ve titreşimleri engeller.
• Yalnızca alarmlar: Alarmlar dışındaki tüm sesleri ve titreşimleri engeller.
• Yalnızca öncelikliler: Kullanıcılar, sistem genelinde hangi kategorilerin (yalnızca alarmlar, hatırlatıcılar, etkinlikler, çağrılar veya mesajlar gibi) çalışmalarını kesintiye uğratabileceğini yapılandırabilir. Mesajlar ve aramalar için kullanıcılar, Şekil 13'te gösterildiği gibi gönderene veya arayana göre filtreleme yapabilir.

Şekil 13. Kullanıcılar, sistem genelindeki kategorilere (solda) ve gönderen veya arayana (sağda) göre bildirimlere izin verebilir.

Android 8.0 (API düzeyi 26) ve sonraki sürümlerde kullanıcılar, Rahatsız Etmeyin modunu kanal bazında geçersiz kılarak uygulamaya özel kategoriler (kanal olarak da bilinir) için bildirimlere izin verebilirler. Örneğin, bir ödeme uygulamasında para çekme ve para yatırma işlemleriyle ilgili bildirimler için kanallar bulunabilir. Kullanıcı, öncelikli modda para çekme bildirimlerine, para yatırma bildirimlerine veya her ikisine de izin verebilir.

Android 7.1 (API düzeyi 25) ve önceki sürümleri çalıştıran cihazlarda, kullanıcılar bildirimlere kanal bazında değil, uygulama bazında izin verebilirler.

Bu kullanıcı ayarlarıyla ilgili bildirimlerinizi yapılandırmak için sistem genelinde bir kategori ayarlamanız gerekir.

Ön plan hizmetleri için bildirimler

Uygulamanız bir ön plan hizmetini çalıştırırken bir bildirim gerekir. Bu hizmet, medya oynatıcı gibi arka planda uzun ömürlü ve kullanıcının fark edebileceği bir Service öğesidir. Bu bildirim, diğer bildirimler gibi kapatılamaz. Bildirimi kaldırmak için hizmetin durdurulması veya ön plan durumundan kaldırılması gerekir.

Daha fazla bilgi için Ön plan hizmetleri bölümünü okuyun. Medya oynatıcı oluşturuyorsanız Ön plan hizmetiyle MediaStyle bildirimlerini kullanma konusunu da okuyun.

Yayın sınırları

Android 8.1 (API düzeyi 27) sürümünden itibaren uygulamalar bildirim sesini saniyede bir defadan fazla çıkaramaz. Uygulamanız bir saniyede birden fazla bildirim yayınlarsa tüm bildirimler beklendiği gibi görünür ancak her saniye için yalnızca ilk bildirim ses çıkarır.

Bununla birlikte, Android bir bildirimi güncellerken hız sınırlaması da uygular. Tek bir bildirime çok sık güncelleme yayınlar (ör. bir saniyeden kısa sürede çok sayıda güncelleme) sistem güncellemeleri düşürebilir.

Bildirim uyumluluğu

Android bildirim sistemi kullanıcı arayüzü ve bildirimle ilgili API'ler sürekli olarak gelişir. Eski cihazları desteklerken en yeni Notification API özelliklerini kullanmak için Support Library bildirim API'sini NotificationCompat ve alt sınıflarının yanı sıra NotificationManagerCompat'ı kullanın. Bu, API'ler tarafından işlendiği için API düzeylerini kontrol etmek için koşullu kod yazmaktan kaçınmanızı sağlar.

Platform geliştikçe NotificationCompat, en yeni yöntemleri içerecek şekilde güncellenir. Ancak bir yöntemin NotificationCompat için kullanılabilir olması, ilgili özelliğin daha eski cihazlarda sağlanacağını garanti etmez. Bazı durumlarda, yeni kullanıma sunulan bir API'nin çağrılması, eski cihazlarda hiçbir işlemin yapılmamasına neden olur.

Aşağıda, Android bildirimleri için API düzeyi bazında en önemli davranış değişikliklerinin bir özeti bulunmaktadır.

Android 5.0, API düzeyi 21

• Kilit ekranı ve uyarı bildirimlerini kullanıma sunar.

• Kullanıcının telefonu Rahatsız Etmeyin moduna ayarlamasına ve cihaz "yalnızca öncelikli" modundayken hangi bildirimlerin çalışmasını kesmesine izin verileceğini yapılandırmasına olanak tanır.

• Kilit ekranında bir bildirimin görüntülenip görüntülenmeyeceğini (setVisibility() gibi) ayarlamak ve bildirim metninin "herkese açık" sürümünü belirtmek için yöntemler ekler.

• Bildirimin ne kadar kesintiye uğradığını sisteme bildiren setPriority() yöntemini ekler. Örneğin, önceliğin yüksek olarak ayarlanması bildirimi uyarı bildirimi olarak gösterir.

• Android Wear (yeni adıyla Wear OS) cihazlara bildirim grubu desteği eklendi. setGroup() kullanarak bildirimleri bir yığına yerleştirin. Daha sonra grup veya paket olarak bilinen bildirim yığınları, Android 7.0 (API düzeyi 24) sürümüne kadar tabletlerde veya telefonlarda desteklenmez.

Android 7.0, API düzeyi 24

• Bildirim şablonlarını, hero resmi ve avatarı vurgulayacak şekilde yeniden biçimlendirir.

• Biri mesajlaşma uygulamaları, diğeri de özel içerik görünümlerini genişletilebilir ekleme ve diğer sistem süslemeleriyle süslemek için olmak üzere üç bildirim şablonu ekler.

• Telefon ve tablet gibi elde kullanılan cihazlara bildirim grupları için destek ekler. Android 5.0 (API düzeyi 21) sürümünde kullanıma sunulan Android Wear (yeni adıyla Wear OS) bildirim yığınlarıyla aynı API'yi kullanır.

• Kullanıcıların satır içi yanıt kullanarak bir bildirimin içinde yanıt vermesine olanak tanır. Kullanıcı metin girebilir. Ardından bu metin, bildirimin üst uygulamasına yönlendirilir.

Android 8.0, API düzeyi 26

• Bildirimlerin belirli bir kanala yerleştirilmesini sağlar.

• Kullanıcıların bir uygulamadan gelen tüm bildirimleri kapatmak yerine, kanal başına bildirimleri kapatmasına olanak tanır.

• Etkin bildirimleri olan uygulamaların, ana ekran veya başlatıcı ekranında uygulama simgesinin üzerinde bir bildirim rozeti görüntülemesini sağlar.

• Kullanıcıların çekmecedeki bir bildirimi ertelemesine olanak tanır. Bir bildirim için otomatik zaman aşımı ayarlayabilirsiniz.

• Bildirimin arka plan rengini ayarlamanızı sağlar.

• Bildirim davranışlarıyla ilgili bazı API'leri Notification'ten NotificationChannel'e taşır. Örneğin, Android 8.0 ve sonraki sürümlerde NotificationCompat.Builder.setPriority() yerine NotificationChannel.setImportance() kullanın.

Android 13.0, API düzeyi 33

• Çalışma zamanı izni ekler. Uygulamanızın muaf olmayan bildirimler göndermesi için kullanıcı bu izni uygulamanıza vermelidir.

Android 14.0, API düzeyi 34

• Tam ekran intent bildirimlerini, çağrı ve alarm sağlayan uygulamalarla sınırlandırır. Uygulamanızın izni olup olmadığını kontrol etmek için NotificationManager.canUseFullScreenIntent API'yi kullanın. Aksi takdirde uygulamanız, kullanıcıların izin verebileceği ayarlar sayfasını başlatmak için ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT aracını kullanabilir.

• Notification.FLAG_ONGOING_EVENT işareti ayarlanmış olsa bile kullanıcıların bildirim işlemini kapatmalarına izin vererek kapatılamayan bildirimlerle ilgili deneyimi değiştirir. Notification.FLAG_ONGOING_EVENT işareti ayarlanmışsa veya Cihaz politikası denetleyici (DPC) ve kuruluşlar için desteklenen paketlerdeki CallStyle bildirimleri için bu geçerli değildir. Bu durum, telefon kilitliyken veya kullanıcı Tümünü temizle'yi seçtiğinde de geçerli olmaz.