Tentang notifikasi

Notifikasi adalah pesan yang ditampilkan oleh Android di luar UI aplikasi Anda untuk memberikan pengingat, komunikasi dari orang lain, atau informasi tepat waktu lainnya dari aplikasi.

Halaman ini memberikan ringkasan tempat munculnya notifikasi dan fitur yang tersedia. Untuk mulai membuat notifikasi, baca Membuat notifikasi.

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

Tampilan di perangkat

Notifikasi secara otomatis ditampilkan kepada pengguna dalam lokasi dan format yang berbeda-beda. Notifikasi muncul sebagai ikon di status bar, entri yang lebih mendetail di panel samping notifikasi, dan badge di 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 khusus untuk notifikasi Wear OS, lihat Panduan notifikasi Wear OS.

Status bar dan panel samping notifikasi

Saat dikeluarkan, notifikasi terlebih dahulu muncul di status bar sebagai ikon.

Gambar 1. Ikon notifikasi muncul di sisi kiri status bar.

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

Gambar 2. Notifikasi di panel samping 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 di Android 13, tampilan yang diperluas ini menyertakan tombol yang memungkinkan pengguna untuk 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 floating yang disebut notifikasi pendahuluan. Perilaku ini biasanya untuk notifikasi penting yang harus segera diketahui oleh pengguna dan muncul hanya jika perangkat terbuka kuncinya.

Gambar 3. Notifikasi pendahuluan muncul di depan aplikasi latar depan.

Notifikasi pendahuluan muncul saat aplikasi Anda mengeluarkan notifikasi. Notifikasi ini menghilang tidak lama kemudian, tetapi tetap terlihat di panel samping notifikasi seperti biasa.

Kondisi yang mungkin memicu notifikasi pendahuluan mencakup berikut ini:

  • Aktivitas pengguna sedang 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 lebih lama.

  • Saluran notifikasi memiliki nilai penting yang tinggi di perangkat yang menjalankan Android 8.0 (API level 26) dan lebih baru.

Layar kunci

Mulai Android 5.0, notifikasi dapat muncul di layar kunci.

Anda dapat secara terprogram menyetel apakah notifikasi yang dikeluarkan oleh aplikasi Anda ditampilkan di layar kunci 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 tiap saluran notifikasi.

Gambar 4. Notifikasi di layar kunci dengan konten sensitif disembunyikan.

Untuk mempelajari lebih lanjut, lihat Menyetel visibilitas layar kunci.

Badge ikon aplikasi

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

Pengguna dapat menekan lama ikon aplikasi untuk melihat notifikasi aplikasi tersebut. Pengguna kemudian dapat menutup atau menindaklanjuti notifikasi dari menu tersebut, serupa dengan panel samping notifikasi.

Gambar 5. Badge notifikasi dan menu tekan lama.

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

Perangkat Wear OS

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

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

Gambar 6. Notifikasi muncul otomatis di perangkat Wear OS yang tersambung.

Anatomi notifikasi

Desain notifikasi ditentukan oleh template sistem, dan aplikasi Anda menentukan konten untuk tiap porsi template. Beberapa detail notifikasi hanya muncul dalam tampilan yang diluaskan.

Gambar 7. Notifikasi dengan detail dasar.

Bagian paling umum dari notifikasi ditunjukkan dalam gambar 7 sebagai berikut:

  1. Ikon kecil: wajib; ditetapkan menggunakan setSmallIcon().
  2. Nama aplikasi: disediakan oleh sistem.
  3. Stempel waktu: disediakan oleh sistem, tetapi Anda dapat menggantinya menggunakan setWhen() atau menyembunyikannya menggunakan setShowWhen(false).
  4. Ikon besar: opsional; biasanya hanya digunakan untuk foto kontak. Jangan gunakan untuk ikon aplikasi Anda. Ditetapkan menggunakan setLargeIcon().
  5. Judul: opsional; ditetapkan menggunakan setContentTitle().
  6. Teks: opsional; ditetapkan menggunakan setContentText().

Sebaiknya gunakan template sistem untuk kompatibilitas desain yang tepat di semua perangkat. Jika perlu, Anda dapat membuat tata letak notifikasi kustom.

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

Tindakan notifikasi

Meskipun tidak diwajibkan, sebaiknya setiap notifikasi membuka aktivitas aplikasi yang sesuai saat di-tap. Selain tindakan notifikasi default ini, Anda dapat menambahkan tombol tindakan yang menyelesaikan tugas terkait aplikasi dari notifikasi—biasanya tanpa membuka aktivitas—seperti ditampilkan di gambar 8.

Gambar 8. Notifikasi dengan tombol tindakan.

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

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

Menambahkan 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 baru, Anda dapat mengonfigurasi tindakan notifikasi sehingga perangkat harus dibuka kuncinya agar aplikasi Anda dapat memanggil tindakan tersebut, terlepas dari alur kerja tindakan yang diluncurkan. Opsi ini menambahkan lapisan keamanan tambahan pada notifikasi di perangkat yang terkunci.

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

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();

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 diluaskan dengan menerapkan template tambahan, seperti ditampilkan di gambar 9.

Gambar 9. Notifikasi yang dapat diluaskan untuk teks besar.

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

Update dan grup notifikasi

Untuk menghindari mengirimkan notifikasi yang berlebihan jika ada update tambahan, perbarui notifikasi yang sudah ada daripada mengeluarkan notifikasi baru atau gunakan notifikasi dengan gaya kotak masuk untuk menampilkan update percakapan.

Namun, jika perlu mengirim beberapa notifikasi, sebaiknya pertimbangkan untuk mengelompokkan notifikasi terpisah tersebut menjadi grup, yang tersedia di Android 7.0 dan lebih tinggi.

Grup notifikasi memungkinkan Anda menciutkan beberapa notifikasi menjadi satu postingan di panel samping notifikasi, dengan ringkasannya. Pengguna dapat secara bertahap meluaskan grup notifikasi dan tiap notifikasi di dalamnya untuk melihat detail selengkapnya, seperti yang ditunjukkan pada gambar 10.

Gambar 10. Grup notifikasi yang diciutkan dan diluaskan.

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

Saluran notifikasi

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

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

Gambar 11. Setelan notifikasi untuk aplikasi Jam dan salah satu salurannya.

Aplikasi dapat memiliki saluran terpisah untuk tiap jenis notifikasi yang dikeluarkan oleh aplikasi. Aplikasi juga dapat membuat saluran notifikasi sebagai tanggapan atas pilihan yang dibuat oleh pengguna. Misalnya, Anda bisa menyiapkan saluran notifikasi yang terpisah untuk setiap grup percakapan yang dibuat oleh pengguna dalam aplikasi pesan.

Saluran Anda juga menentukan tingkat nilai penting notifikasi di Android 8.0 dan lebih baru, 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 nilai penting notifikasi untuk menentukan tingkat interupsi notifikasi tersebut bagi pengguna secara visual dan audio. Semakin tinggi nilai penting notifikasi, semakin mengganggu notifikasi tersebut.

Di Android 7.1 (API level 25) dan lebih lama, nilai penting notifikasi ditentukan oleh notifikasi's priority.

Di Android 8.0 (API level 26) dan lebih baru, nilai penting notifikasi ditentukan oleh importance saluran notifikasi. Pengguna dapat mengubah nilai penting saluran notifikasi di setelan sistem, seperti yang ditunjukkan pada gambar 12.

Gambar 12. Pengguna dapat mengubah nilai penting tiap saluran di Android 8.0 dan lebih baru.

Kemungkinan tingkat nilai penting dan perilaku notifikasi terkait adalah sebagai berikut:

  • Mendesak: berbunyi dan muncul sebagai notifikasi pendahuluan.

  • Tinggi: berbunyi

  • Sedang: tidak ada bunyi

  • Rendah: tidak ada bunyi 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 di ikon peluncur. Namun, Anda dapat mengubah tampilan badge notifikasi.

Untuk mengetahui informasi selengkapnya, baca tentang cara menyetel nilai penting.

Mode Jangan Ganggu

Mulai di Android 5.0 (API level 21), pengguna dapat mengaktifkan mode Jangan Ganggu, yang menonaktifkan suara dan getaran untuk semua notifikasi. Notifikasi tetap muncul di UI sistem seperti biasa, kecuali 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.
  • Khusus prioritas: pengguna dapat mengonfigurasi kategori tingkat sistem mana saja yang dapat mengganggu pengguna, seperti hanya alarm, pengingat, acara, panggilan telepon, atau pesan. Untuk pesan dan panggilan telepon, pengguna dapat memfilter berdasarkan pengirim atau penelepon, seperti yang ditunjukkan pada gambar 13.

Gambar 13. Pengguna dapat mengizinkan notifikasi muncul berdasarkan kategori tingkat sistem (kiri) dan pengirim atau penelepon (kanan).

Di Android 8.0 (API level 26) dan lebih baru, pengguna juga dapat mengizinkan notifikasi muncul untuk kategori khusus aplikasi—juga disebut saluran—dengan mengganti mode Jangan Ganggu per saluran. Misalnya, aplikasi pembayaran mungkin memiliki saluran untuk notifikasi yang terkait dengan penarikan dan penyetoran. Pengguna dapat mengizinkan notifikasi penarikan, notifikasi penyetoran, atau keduanya saat dalam mode prioritas.

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

Guna mengonfigurasi notifikasi untuk setelan pengguna ini, Anda harus menyetel kategori tingkat sistem.

Notifikasi untuk layanan latar depan

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

Untuk mengetahui informasi selengkapnya, baca Layanan latar depan. Jika Anda sedang 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 sejumlah kecil notifikasi turunan

Android 15.0, API level 35

Periode tunggu

Android 15 memperkenalkan fitur periode tunggu notifikasi yang bertujuan untuk meningkatkan pengalaman notifikasi yang tiba secara berurutan. 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 periode tunggu. Pengguna dapat menonaktifkan periode tunggu notifikasi di Setelan.

Gambar 9. Setelan periode tunggu notifikasi.

Berikut adalah contoh cara menemukan setelan periode tunggu notifikasi:

Kotlin

val intent = Intent(Settings.ACTION_MANAGE_ADAPTIVE_NOTIFICATIONS)
val pendingIntent =
            PendingIntent.getActivity(context, 0, intent, PendingIntent.FLAG_IMMUTABLE)

Java

Intent intent = new Intent(Settings.ACTION_MANAGE_ADAPTIVE_NOTIFICATIONS)
PendingIntent pendingIntent =
            PendingIntent.getActivity(context, 0, intent, PendingIntent.FLAG_IMMUTABLE)