Bildirim, Android'in kullanıcıya hatırlatıcıları, diğer kişilerin iletişimlerini veya uygulamanızdaki diğer güncel bilgileri sağlamak için uygulamanızın kullanıcı arayüzü dışında görüntülediği bir mesajdır. Kullanıcılar uygulamanızı açmak için bildirime dokunabilir veya doğrudan bildirimden işlem yapabilirler.
Bu sayfada, bildirimlerin göründüğü yerler ve kullanılabilen özellikler hakkında genel bir bakış sunulur. 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çimlerdeki kullanıcılara otomatik olarak gösterilir. Bildirim, durum çubuğunda bir simge, bildirim çekmecesinde daha ayrıntılı bir giriş ve uygulamanın simgesinde bir rozet olarak görünür. Bildirimler, eşlenmiş giyilebilir cihazlarda da görünür.
Durum çubuğu ve bildirim çekmecesi
Yayınladığınız bir bildirim ilk olarak durum çubuğunda bir simge olarak görünür.
Kullanıcılar, daha fazla ayrıntı görüntüleyebilecekleri ve bildirimle işlem yapabilecekleri bildirim çekmecesini açmak için durum çubuğunu aşağı kaydırabilirler.
Kullanıcılar, sağlanan ek içerik ve işlem düğmelerini gösteren genişletilmiş görünümü açmak için çekmecedeki bir bildirimi aşağı doğru sürükleyebilirler. Android 13'ten itibaren bu genişletilmiş görünümde, kullanıcıların ön plan hizmetleri devam eden bir uygulamayı durdurmasını sağlayan bir düğme bulunmaktadır.
Bir bildirim, uygulama veya kullanıcı tarafından kapatılana kadar bildirim çekmecesinde görünür.
Uyarı bildirimi
Android 5.0 sürümünden itibaren bildirimler, uyarı bildirimi adı verilen kayan bir pencerede kısa bir süreliğine görünebilir. Bu davranış, normalde kullanıcının hemen bilmesi gereken önemli bildirimler için geçerlidir ve yalnızca cihazın kilidi açıksa görünür.
Uygulamanız bildirimi yayınladığında uyarı bildirimi görünür. 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 (ör. uygulama
fullScreenIntent
kullanırken).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 tarafından yayınlanan bildirimlerin güvenli bir kilit ekranında gösterilip gösterilmeyeceğini ve gösteriliyorsa görünür ayrıntı düzeyini programatik olarak ayarlayabilirsiniz.
Kullanıcılar, kilit ekranı bildirimlerinde görünecek 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 sürümünden başlayarak, kullanıcılar her bir bildirim kanalı için kilit ekranı bildirimlerini devre dışı bırakabilir veya etkinleştirebilirler.
Daha fazla bilgi edinmek için Kilit ekranı görünürlüğünü ayarlama konusuna 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, ilgili uygulama başlatıcı simgesi üzerinde bildirim noktası olarak bilinen renkli bir rozetle belirtir.
Kullanıcılar, bir uygulamanın bildirimlerini görmek için uygulama simgesine dokunup basılı tutabilirler. Kullanıcılar, bildirim çekmecesine benzer şekilde bu menüden bildirimleri kapatabilir veya bildirimlerle ilgili işlem yapabilir.
Rozetlerin işleyiş şekli hakkında daha fazla bilgi edinmek için Bildirim rozetini değiştirme konusunu 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 dahil tüm bildirimleriniz burada otomatik olarak görünür.
Giyilebilir cihazlarda bildirimlerinizin görünümünü özelleştirebilir, önerilen yanıtlar ve ses girişi yanıtları da dahil olmak üzere farklı işlemler sağlayarak deneyimi geliştirebilirsiniz. Daha fazla bilgi için bildiriminize giyilebilir cihazlara özgü özellikleri nasıl ekleyebileceğinizi öğrenin.
Bildirim anatomisi
Bir bildirimin tasarımı, sistem şablonlarına göre belirlenir ve uygulamanız şablonun her 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.
Bildirimlerin en yaygın kısımları Şekil 7'de aşağıdaki gibi belirtilmiştir:
- Küçük simge: Zorunlu;
setSmallIcon()
ile ayarlayın. - Uygulama adı: Sistem tarafından sağlanır.
- Zaman damgası: sistem tarafından sağlanır ancak
setWhen()
kullanarak geçersiz kılabilir veyasetShowWhen(false)
ile gizleyebilirsiniz. - Büyük simge: isteğe bağlı; genellikle yalnızca kişi fotoğrafları için kullanılır.
Uygulama simgeniz için kullanmayın.
setLargeIcon()
kullanarak ayarlayın. - Başlık: İsteğe bağlı;
setContentTitle()
ile ayarlayın. - Metin: isteğe bağlı;
setContentText()
ile ayarlayın.
Tüm cihazlarda doğru tasarım uyumluluğu için sistem şablonlarını kullanmanızı önemle tavsiye ederiz. 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 dokunduğunuzda uygun bir uygulama etkinliğini açması iyi bir uygulamadır. Bu varsayılan bildirim işlemine ek olarak, uygulama ile ilgili bir görevi bildirimden (genellikle bir etkinlik açmadan) tamamlayan işlem düğmelerini Şekil 8'de gösterildiği gibi ekleyebilirsiniz.
Android 7.0 (API düzeyi 24) sürümünden itibaren, doğrudan bildirimden mesajları yanıtlamak veya başka bir metin girmek için bir işlem ekleyebilirsiniz.
Platform, Android 10'dan (API düzeyi 29) başlayarak, önerilen amaca dayalı işlemleri içeren işlem düğmelerini otomatik olarak oluşturabilir.
İşlem düğmelerinin eklenmesi Bildirim oluşturma konusunda daha ayrıntılı bir şekilde açıklanmaktadır.
Kilidi açılmış cihazı zorunlu kılma
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 kullanıcıların cihazın kilidini açması gerekir.
Android 12 (API düzeyi 31) ve sonraki sürümlerde, işlemin başlattığı iş akışından bağımsız olarak, uygulamanızın bu işlemi çağırması için cihazın kilidinin açılması gerektiğine dair bir bildirim işlemi yapılandırabilirsiniz. Bu seçenek, kilitli cihazlardaki bildirimlere ekstra 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:
Kotlin
val moreSecureNotification = Notification.Action.Builder(...) // This notification always requests authentication when invoked // from a lock screen. .setAuthenticationRequired(true) .build()
Java
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ı isterseniz Şekil 9'da gösterildiği gibi, ek bir şablon uygulayarak genişletilebilir, daha büyük bir metin alanını etkinleştirebilirsiniz.
Ayrıca, gelen kutusu stilinde, resim içeren, sohbet görüşmesi içeren veya medya oynatma kontrollerine sahip genişletilebilir bir bildirim de 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.
Bununla birlikte, birden fazla bildirim gönderilmesi gerekiyorsa Android 7.0 ve sonraki sürümlerde kullanılabilen bu ayrı bildirimleri bir grup halinde gruplandırmayı düşünebilirsiniz.
Bildirim grubu, bildirim çekmecesinde birden fazla bildirimi özet içeren tek bir yayın olacak şekilde daraltmanıza olanak tanır. Kullanıcı, şekil 10'da gösterildiği gibi, daha fazla ayrıntı için bildirim grubunu ve içindeki her bir bildirimi kademeli olarak genişletebilir.
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 itibaren, tüm bildirimlerin bir kanala atanması gerekir. Aksi takdirde bildirimler gösterilmez. Bu sayede kullanıcılar, tüm bildirimlerinizi devre dışı bırakmak yerine uygulamanız için belirli bildirim kanallarını devre dışı bırakabilir. Kullanıcılar, Şekil 11'de gösterildiği gibi her bir kanal için görsel ve işitsel seçenekleri Android sistem ayarlarından kontrol edebilirler. Kullanıcılar, bir bildirime dokunup basılı tutarak ilişkilendirilmiş kanalın davranışlarını da değiştirebilir.
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. Her uygulamanın Android 7.1 ve önceki sürümlerinde fiilen tek bir kanalı vardır.
Bir uygulamanın, uygulamanın yayınladığı her bildirim türü için ayrı kanalları olabilir. Uygulamalar, kullanıcıların seçimlerine yanıt olarak bildirim kanalları da oluşturabilir. Örneğin, bir kullanıcı tarafından bir mesajlaşma uygulamasında oluşturulan her görüşme grubu için ayrı bildirim kanalları oluşturabilirsiniz.
Android 8.0 ve sonraki sürümlerde, kanal, aynı zamanda bildirimlerinizin önem düzeyini belirttiğiniz yerdir. Böylece aynı bildirim kanalında yayınlanan tüm bildirimler aynı davranışa sahip olur. Bu, aşağıdaki bölümde açıklanmıştır.
Daha fazla bilgi için Bildirim kanalları oluşturma ve yönetme konusuna bakın.
Bildirimlerin önemi
Android, bir bildirimin kullanıcıyı görsel ve işitsel olarak ne kadar rahatsız ettiğini belirlemek için bildirimin önem değerini kullanır. Bir bildirimin önem derecesi ne kadar yüksekse bildirim o kadar rahatsız edici olur.
Android 7.1 (API düzeyi 25) ve önceki sürümlerde bir bildirimin önemi, bildirimdeki priority
ile 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, Şekil 12'de gösterildiği gibi, sistem ayarlarında
bildirim kanalının önemini değiştirebilirler.
Olası önem düzeyleri ve ilişkili bildirim davranışları aşağıdaki gibidir:
Acil: Ses çıkar 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.
Önem derecelerinden bağımsız olarak tüm bildirimler, bildirim çekmecesi ve başlatıcı simgesinde bir rozet gibi kesintiye uğramayan sistem kullanıcı arayüzü konumlarında görünür. Ancak bildirim rozetinin görünümünü değiştirebilirsiniz.
Daha fazla bilgi için önemi ayarlama bölümünü 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:
- Tam sessizlik: 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 (ör. alarmlar, hatırlatıcılar, etkinlikler, aramalar veya mesajlar) çalışmasını kesintiye uğratabileceğini yapılandırabilir. Mesajlar ve çağrılar için kullanıcılar, Şekil 13'te gösterildiği gibi gönderene veya arayana göre filtreleme yapabilir.
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 özgü kategoriler (kanallar olarak da bilinir) aracılığıyla 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 birden 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ı için bildirimlerinizi yapılandırmak üzere sistem genelinde bir kategori ayarlamanız gerekir.
Ön plan hizmetleri için bildirimler
Uygulamanız bir ön plan hizmetini (ör. medya oynatıcı gibi) arka planda uzun süre çalışan ve kullanıcının fark edebileceği bir Service
çalıştırırken bildirim gerekir. 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 Arka planda medya oynatma bölümünü de okuyun.
Yayın sınırları
Android 8.1 (API düzeyi 27) sürümünden itibaren, uygulamalar saniyede bir defadan fazla bildirim sesi çıkaramaz. Uygulamanız bir saniyede birden fazla bildirim yayınlarsa bunların tümü beklendiği gibi görünür ancak saniyede yalnızca ilk bildirim bir ses çıkarır.
Bununla birlikte, Android bir bildirimi güncellerken hız sınırlaması da uygular. Tek bir bildirim için çok sık güncelleme yayınlarsanız (örneğin, bir saniyeden kısa bir süre içinde çok sayıda) sistem güncellemeleri bırakabilir.
Bildirim uyumluluğu
Android bildirim sistemi kullanıcı arayüzü ve bildirimle ilgili API'ler sürekli olarak
değişir. Eski cihazları desteklerken en yeni bildirim API özelliklerini kullanmak için Support Library bildirim API'si NotificationCompat
, alt sınıfları ile NotificationManagerCompat
'ı kullanın.
Böylece, API düzeylerini kontrol etmek için koşullu kod yazmak zorunda kalmazsınız, çünkü bu API'ler bunu halleder.
NotificationCompat
, platform en yeni yöntemleri içerecek şekilde geliştikçe güncellenir. Ancak bir yöntemin NotificationCompat
bölgesinde 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 herhangi bir işlemin yapılmamasına neden olur.
Aşağıda, Android bildirimleri için API düzeyine göre en dikkat çekici davranış değişikliklerinin bir özeti verilmiştir.
Android 5.0, API düzeyi 21
Kilit ekranı ve uyarı bildirimleri sunar.
Kullanıcının telefonu Rahatsız Etmeyin moduna ayarlamasına ve cihaz yalnızca öncelikli moddayken hangi bildirimlerin onları kesintiye uğratmasına izin verileceğini yapılandırmasına olanak tanır.
Bir bildirimin kilit ekranında görüntülenip görüntülenmeyeceğini (ör.
setVisibility()
) ayarlama ve bildirim metninin "herkese açık" sürümünü belirtme yöntemleri ekler.Sisteme bildirimin ne kadar kesintiye uğradığını bildiren
setPriority()
yöntemi ekler. Örneğin, önceliğin yüksek olarak ayarlanması, bildirimin uyarı bildirimi olarak görünmesini sağlar.Android Wear (artık Wear OS olarak adlandırılıyor) cihazlarına bildirim yığınları desteği ekler.
setGroup()
kullanarak bildirimleri bir gruba 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
Lokomotif resmi ve avatarı vurgulamak için bildirim şablonlarını yeniden biçimlendirir.
Üç bildirim şablonu ekler: biri mesajlaşma uygulamaları, diğer ikisi genişletilebilir ürün ve diğer sistem süslemeleriyle özel içerik görünümlerini süslemek.
Bildirim grupları için telefon ve tablet gibi avuç içi cihazlara destek ekler. Android 5.0'da (API düzeyi 21) 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 bildirim içinde yanıt vermesine olanak tanır. Kullanıcılar metin girebilir. Bu metin daha sonra bildirimin üst uygulamasına yönlendirilir.
Android 8.0, API düzeyi 26
Bağımsız bildirimlerin belirli bir kanala yerleştirilmesini sağlar.
Kullanıcıların bir uygulamadan gelen tüm bildirimleri kapatmak yerine bildirimleri kanal bazında 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 ayarlayabilmenizi sağlar.
Bildirim davranışlarıyla ilgili bazı API'leri
Notification
yerineNotificationChannel
olarak taşır. Örneğin, Android 8.0 ve sonraki sürümlerdeNotificationCompat.Builder.setPriority()
yerineNotificationChannel.setImportance()
değerini 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ının uygulamanıza bu izni vermesi gerekir.
Android 14.0, API düzeyi 34
Tam ekran intent bildirimlerini, arama 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. İzin verilmezse uygulamanız, kullanıcıların izin verebileceği ayarlar sayfasını başlatmak içinACTION_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 kapatmasına izin vererek kullanıcıların kapatılamayan bildirimler kullanma şeklini değiştirir. Bu,Notification.FLAG_ONGOING_EVENT
işareti ayarlanmışsaCallStyle
bildirimleri veya Cihaz politikası denetleyici (DPC) ve kuruluş için destek paketleri için geçerli değildir. Bu durum, telefon kilitliyken veya kullanıcı Tümünü temizle'yi seçtiğinde de geçerli değildir.