Tentang notifikasi

Notifikasi adalah pesan yang ditampilkan Android di luar UI aplikasi untuk memberikan pengingat, komunikasi dari orang lain, atau informasi tepat waktu lainnya dari aplikasi Anda kepada pengguna. Pengguna dapat mengetuk notifikasi untuk membuka aplikasi atau melakukan tindakan langsung dari notifikasi.

Halaman ini memberikan ringkasan tempat munculnya notifikasi dan fitur yang tersedia.

Panduan penerapan

Panduan berikut menunjukkan cara menerapkan berbagai fitur notifikasi di aplikasi Anda:

• Membuat notifikasi: pelajari cara membuat dan mengeluarkan notifikasi dasar.
• Izin notifikasi: pelajari cara menangani izin runtime POST_NOTIFICATIONS.
• Saluran notifikasi: memungkinkan pengguna mengontrol perilaku notifikasi.
• Notifikasi yang dapat diperluas: menampilkan lebih banyak konten menggunakan gaya seperti BigTextStyle atau MessagingStyle.
• Balon: menggunakan overlay mengambang yang dapat diperluas untuk percakapan.
• Notifikasi yang berfokus pada progres: melacak perjalanan yang dimulai pengguna seperti transportasi online dan pengiriman.
• Notifikasi gaya panggilan: membedakan panggilan masuk dan panggilan yang sedang berlangsung dari jenis notifikasi lainnya.
• Notifikasi live update: memantau progres untuk aktivitas yang sedang berlangsung.
• Panduan notifikasi khusus tampilan: panduan untuk menerapkan notifikasi di aplikasi berbasis View.

Untuk informasi selengkapnya tentang pola desain dan interaksi notifikasi, lihat Panduan desain notifikasi.

Tampilan di perangkat

Notifikasi akan otomatis muncul kepada pengguna di berbagai lokasi dan format. Notifikasi muncul sebagai ikon di status bar, entri yang lebih mendetail di panel samping notifikasi, dan badge pada ikon aplikasi.

Perilaku lintas perangkat

Notifikasi juga muncul di perangkat wearable yang tersambung secara default. Dalam skenario saat konten notifikasi hanya relevan dengan perangkat sumber, gunakan setLocalOnly(). Contohnya adalah notifikasi yang mengonfirmasi bahwa download media telah selesai. Untuk panduan selengkapnya yang khusus untuk notifikasi Wear OS, lihat panduan notifikasi Wear OS.

Status bar dan panel samping notifikasi

Saat Anda mengeluarkan notifikasi, notifikasi tersebut akan muncul pertama kali sebagai ikon di status bar.

Pengguna dapat menggeser status bar ke bawah untuk membuka panel samping notifikasi, tempat mereka dapat melihat detail selengkapnya dan mengambil tindakan dengan notifikasi.

Pengguna dapat menarik notifikasi di panel samping ke bawah untuk membuka tampilan yang diluaskan, yang menampilkan konten dan tombol tindakan tambahan, jika ada. Mulai Android 13, tampilan yang diperluas ini menyertakan tombol yang memungkinkan pengguna menghentikan aplikasi yang memiliki layanan latar depan yang sedang berlangsung.

Notifikasi tetap terlihat di panel samping notifikasi hingga ditutup oleh aplikasi atau pengguna.

Notifikasi pendahuluan

Mulai Android 5.0, notifikasi dapat muncul sebentar di jendela mengambang yang disebut notifikasi peringatan dini. Perilaku ini biasanya untuk notifikasi penting yang perlu segera diketahui pengguna, dan hanya muncul jika perangkat tidak terkunci.

Notifikasi peringatan dini muncul saat aplikasi Anda mengeluarkan notifikasi. Notifikasi ini akan menghilang setelah beberapa saat, tetapi tetap terlihat di panel samping notifikasi seperti biasa.

Kondisi yang dapat memicu notifikasi peringatan dini meliputi:

• Aktivitas pengguna dalam mode layar penuh, seperti saat aplikasi menggunakan fullScreenIntent.

• Notifikasi memiliki prioritas tinggi dan menggunakan nada dering atau getaran di perangkat yang menjalankan Android 7.1 (API level 25) dan yang lebih rendah.

• Saluran notifikasi memiliki tingkat kepentingan yang tinggi di perangkat yang menjalankan Android 8.0 (level API 26) dan yang lebih tinggi.

Layar kunci

Mulai Android 5.0, notifikasi dapat muncul di layar kunci.

Anda dapat menetapkan secara terprogram apakah notifikasi yang diposting oleh aplikasi akan ditampilkan di layar kunci yang aman dan, jika ya, tingkat detail yang terlihat.

Pengguna dapat menggunakan setelan sistem untuk memilih tingkat detail yang terlihat di notifikasi layar kunci atau untuk menonaktifkan semua notifikasi layar kunci. Mulai Android 8.0, pengguna dapat menonaktifkan atau mengaktifkan notifikasi layar kunci untuk setiap saluran notifikasi.

Untuk mempelajari lebih lanjut, lihat Menyetel visibilitas layar kunci.

Badge ikon aplikasi

Di peluncur yang didukung pada perangkat yang menjalankan Android 8.0 (level API 26) dan yang lebih tinggi, ikon aplikasi menunjukkan notifikasi baru dengan badge berwarna yang dikenal sebagai titik notifikasi pada ikon peluncur aplikasi yang sesuai.

Pengguna dapat menyentuh lama ikon aplikasi untuk melihat notifikasi aplikasi tersebut. Pengguna dapat menutup atau menindaklanjuti notifikasi dari menu tersebut, mirip dengan panel samping notifikasi.

Untuk mempelajari lebih lanjut cara kerja badge, baca Mengubah badge notifikasi.

Perangkat Wear OS

Jika pengguna memiliki perangkat Wear OS yang disambungkan, semua notifikasi Anda akan muncul di sana secara otomatis, termasuk detail yang dapat diluaskan dan tombol tindakan.

Anda dapat meningkatkan pengalaman dengan menyesuaikan tampilan notifikasi di perangkat wearable dan dengan memberikan berbagai tindakan, termasuk balasan yang disarankan dan balasan input suara. Untuk informasi selengkapnya, lihat cara menambahkan fitur khusus perangkat wearable ke notifikasi.

Anatomi notifikasi

Desain notifikasi ditentukan oleh template sistem, dan aplikasi Anda menentukan konten untuk setiap bagian template. Beberapa detail notifikasi hanya muncul dalam tampilan yang diperluas.

Bagian notifikasi yang paling umum ditunjukkan pada gambar 7, sebagai berikut:

Kami sangat menyarankan penggunaan template sistem untuk kompatibilitas desain yang tepat di semua perangkat. Jika perlu, Anda dapat membuat tata letak notifikasi kustom.

Untuk informasi selengkapnya tentang cara membuat notifikasi dengan fitur ini dan lainnya, baca Membuat notifikasi.

Tindakan notifikasi

Meskipun tidak wajib, sebaiknya setiap notifikasi membuka aktivitas aplikasi yang sesuai saat diketuk. Selain tindakan notifikasi default ini, Anda dapat menambahkan tombol tindakan yang menyelesaikan tugas terkait aplikasi dari notifikasi—sering kali tanpa membuka aktivitas—seperti yang ditunjukkan pada gambar 8.

Mulai Android 7.0 (level API 24), Anda dapat menambahkan tindakan untuk membalas pesan atau memasukkan teks lain langsung dari notifikasi.

Mulai dari Android 10 (API level 29), platform dapat otomatis menghasilkan tombol tindakan dengan tindakan berbasis intent yang disarankan.

Penambahan tombol tindakan dijelaskan lebih lanjut di Membuat notifikasi.

Memerlukan perangkat yang tidak terkunci

Pengguna mungkin melihat tindakan notifikasi di layar kunci perangkat. Jika tindakan notifikasi menyebabkan aplikasi meluncurkan aktivitas atau mengirim balasan langsung, pengguna harus membuka kunci perangkat sebelum aplikasi dapat memanggil tindakan notifikasi tersebut.

Di Android 12 (API level 31) dan yang lebih tinggi, Anda dapat mengonfigurasi tindakan notifikasi sehingga perangkat harus dibuka kuncinya agar aplikasi Anda dapat memanggil tindakan tersebut, apa pun alur kerja yang diluncurkan tindakan tersebut. Opsi ini menambahkan lapisan keamanan tambahan pada notifikasi di perangkat yang terkunci.

Untuk mewajibkan perangkat dibuka kuncinya sebelum aplikasi memanggil tindakan notifikasi tertentu, teruskan true ke setAuthenticationRequired() saat membuat tindakan notifikasi, seperti yang ditunjukkan dalam cuplikan kode berikut:

val intent = Intent(
    context, null
    /** Replace with a valid target activity */
)
val moreSecureNotification = NotificationCompat.Action.Builder(
    0, "Reply",
    PendingIntentCompat.getActivity(context, 0, intent, PendingIntent.FLAG_NO_CREATE, false)
)
    // This notification always requests authentication when invoked
    // from a lock screen.
    .setAuthenticationRequired(true)
    .build()
NotificationsSnippets.kt

Notifikasi yang dapat diluaskan

Secara default, konten teks notifikasi dipotong agar pas dalam satu baris. Jika ingin notifikasi lebih panjang, Anda dapat mengaktifkan area teks yang lebih besar yang dapat diperluas dengan menerapkan template tambahan, seperti yang ditunjukkan pada gambar 9.

Anda juga dapat membuat notifikasi yang dapat diluaskan dengan gambar, dalam gaya kotak masuk, dengan percakapan chat, atau dengan kontrol pemutaran media. Untuk informasi selengkapnya, baca Membuat notifikasi yang dapat diperluas.

Update dan grup notifikasi

Agar pengguna tidak dibanjiri dengan beberapa notifikasi atau notifikasi yang berlebihan saat Anda memiliki update tambahan, perbarui notifikasi yang ada, bukan mengeluarkan notifikasi baru atau menggunakan notifikasi gaya kotak masuk untuk menampilkan update percakapan.

Namun, jika perlu mengirimkan beberapa notifikasi, pertimbangkan untuk mengelompokkan notifikasi terpisah ke dalam satu grup, yang tersedia di Android 7.0 dan yang lebih tinggi.

Grup notifikasi memungkinkan Anda menciutkan beberapa notifikasi menjadi satu postingan di panel samping notifikasi dengan ringkasan. Pengguna dapat memperluas grup notifikasi dan setiap notifikasi di dalamnya secara progresif untuk mengetahui detail selengkapnya, seperti yang ditunjukkan pada gambar 10.

Untuk mempelajari cara menambahkan notifikasi ke grup, lihat Membuat grup notifikasi.

Saluran notifikasi

Mulai Android 8.0 (level API 26), semua notifikasi harus ditetapkan ke saluran atau tidak akan muncul. Dengan begitu, pengguna dapat menonaktifkan saluran notifikasi tertentu untuk aplikasi Anda, bukan menonaktifkan semua notifikasi. Pengguna dapat mengontrol opsi visual dan audio untuk setiap saluran dari setelan sistem Android, seperti yang ditunjukkan pada gambar 11. Pengguna juga dapat menyentuh lama notifikasi untuk mengubah perilaku saluran terkait.

Di perangkat yang menjalankan Android 7.1 (API level 25) dan yang lebih rendah, pengguna hanya dapat mengelola notifikasi per aplikasi. Setiap aplikasi secara efektif hanya memiliki satu saluran di Android 7.1 dan yang lebih rendah.

Aplikasi dapat memiliki saluran terpisah untuk setiap jenis notifikasi yang dikeluarkan aplikasi. Aplikasi juga dapat membuat saluran notifikasi sebagai respons terhadap pilihan yang dibuat oleh pengguna. Misalnya, Anda dapat menyiapkan saluran notifikasi terpisah untuk setiap grup percakapan yang dibuat oleh pengguna di aplikasi pesan.

Saluran juga merupakan tempat Anda menentukan tingkat kepentingan untuk notifikasi di Android 8.0 dan yang lebih tinggi, sehingga semua notifikasi yang diposting ke saluran notifikasi yang sama memiliki perilaku yang sama. Hal ini dijelaskan di bagian berikut.

Untuk informasi selengkapnya, lihat Membuat dan mengelola saluran notifikasi.

Nilai penting notifikasi

Android menggunakan tingkat kepentingan notifikasi untuk menentukan seberapa besar notifikasi mengganggu pengguna secara visual dan audio. Makin tinggi tingkat kepentingan notifikasi, makin mengganggu notifikasi tersebut.

Di Android 7.1 (level API 25) dan yang lebih rendah, tingkat kepentingan notifikasi ditentukan oleh priority notifikasi.

Di Android 8.0 (level API 26) dan yang lebih tinggi, tingkat kepentingan notifikasi ditentukan oleh importance saluran tempat notifikasi diposting. Pengguna dapat mengubah tingkat kepentingan saluran notifikasi di setelan sistem, seperti yang ditunjukkan pada gambar 12.

Tingkat kepentingan yang mungkin dan perilaku notifikasi terkait adalah sebagai berikut:

• Mendesak: mengeluarkan suara dan muncul sebagai notifikasi peringatan dini.

• Tinggi: mengeluarkan suara.

• Sedang: tidak mengeluarkan suara.

• Rendah: tidak mengeluarkan suara dan tidak muncul di status bar.

Semua notifikasi, terlepas dari tingkat kepentingannya, akan muncul di lokasi UI sistem yang tidak mengganggu, seperti di panel samping notifikasi dan sebagai badge pada ikon peluncur. Namun, Anda dapat mengubah tampilan badge notifikasi.

Untuk mengetahui informasi selengkapnya, baca cara menetapkan tingkat kepentingan.

Mode Jangan Ganggu

Mulai Android 5.0 (level API 21), pengguna dapat mengaktifkan mode Jangan Ganggu, yang akan menonaktifkan suara dan getaran untuk semua notifikasi. Notifikasi masih muncul di UI sistem seperti biasa, kecuali jika pengguna menentukan sebaliknya.

Ada tiga tingkat yang tersedia dalam mode Jangan Ganggu:

• Senyap total: memblokir semua suara dan getaran, termasuk dari alarm, musik, video, dan game.
• Hanya alarm: memblokir semua suara dan getaran, kecuali dari alarm.
• Prioritas saja: pengguna dapat mengonfigurasi kategori di seluruh sistem yang dapat mengganggu mereka, seperti hanya alarm, pengingat, acara, panggilan, atau pesan. Untuk pesan dan panggilan, pengguna dapat memfilter berdasarkan pengirim atau penelepon, seperti yang ditunjukkan pada gambar 13.

Di Android 8.0 (API level 26) dan yang lebih tinggi, pengguna juga dapat mengizinkan notifikasi untuk kategori khusus aplikasi—yang juga dikenal sebagai saluran—dengan mengganti mode Jangan Ganggu di setiap saluran. Misalnya, aplikasi pembayaran mungkin memiliki saluran untuk notifikasi yang terkait dengan penarikan dan setoran. Pengguna dapat mengizinkan notifikasi penarikan, notifikasi setoran, atau keduanya saat dalam mode prioritas.

Di perangkat yang menjalankan Android 7.1 (API level 25) dan yang lebih rendah, pengguna dapat mengizinkan notifikasi berdasarkan aplikasi, bukan berdasarkan saluran.

Untuk mengonfigurasi notifikasi untuk setelan pengguna ini, Anda harus menetapkan kategori di seluruh sistem.

Notifikasi untuk layanan latar depan

Notifikasi diperlukan saat aplikasi Anda menjalankan layanan latar depan—Service yang berjalan di latar belakang yang berjalan lama dan terlihat oleh pengguna, seperti pemutar media. Notifikasi ini tidak dapat ditutup seperti notifikasi lainnya. Untuk menghapus notifikasi, layanan harus dihentikan atau dihapus dari status latar depan.

Untuk mengetahui informasi selengkapnya, baca Layanan latar depan. Jika Anda membuat pemutar media, baca juga Memutar media di latar belakang.

Perilaku notifikasi

Android 16.0, API level 36

Notifikasi kini dikelompokkan secara otomatis atas nama aplikasi.

Notifikasi berikut dikelompokkan secara otomatis:

• Notifikasi tanpa ringkasan
• Notifikasi tanpa notifikasi turunan
• Notifikasi dengan satu atau sedikit notifikasi turunan

Android 15.0, API level 35

Periode tunggu

Android 15 memperkenalkan fitur pengurangan suara dan getaran notifikasi yang bertujuan untuk meningkatkan pengalaman notifikasi yang datang berturut-turut dengan cepat. Fitur ini mengurangi tampilan, volume suara, dan intensitas getaran untuk notifikasi berulang hingga dua menit.

Notifikasi penting yang memerlukan audio dan haptik untuk mendapatkan perhatian tidak tunduk pada jeda. Pengguna dapat menonaktifkan pengurangan suara dan getaran notifikasi di Setelan.