Membuat notifikasi

Notifikasi memberikan informasi singkat dan tepat waktu tentang peristiwa di aplikasi Anda saat tidak digunakan. Dokumen ini menunjukkan cara membuat notifikasi dengan berbagai fitur. Untuk pengantar cara notifikasi muncul di Android, lihat Ringkasan notifikasi. Untuk kode contoh yang menggunakan notifikasi, lihat Contoh orang di GitHub.

Kode di halaman ini menggunakan NotificationCompat API dari Library AndroidX. API ini memungkinkan Anda menambahkan fitur yang hanya tersedia di versi Android yang lebih baru sambil tetap memberikan kompatibilitas ke Android 9 (API level 28). Namun, beberapa fitur, seperti tindakan balasan inline, mengakibatkan tidak adanya pengoperasian pada versi yang lebih lama.

Menambahkan AndroidX Core Library

Meskipun sebagian besar project yang dibuat dengan Android Studio menyertakan dependensi yang diperlukan untuk menggunakan NotificationCompat, pastikan file build.gradle level modul Anda menyertakan dependensi berikut:

Groovy

dependencies {
    implementation "androidx.core:core:2.2.0"
}

Kotlin

dependencies {
    implementation("androidx.core:core-ktx:2.2.0")
}

Membuat notifikasi dasar

Notifikasi dalam bentuk yang paling dasar dan ringkas—juga dikenal sebagai formulir yang diciutkan—menampilkan ikon, judul, dan sejumlah kecil konten teks. Bagian ini menunjukkan cara membuat notifikasi yang dapat diketuk pengguna untuk meluncurkan suatu aktivitas di aplikasi Anda.

Gambar 1. Notifikasi dengan ikon, judul, dan beberapa teks.

Untuk detail selengkapnya tentang setiap bagian dari notifikasi, baca anatomi notifikasi.

Mendeklarasikan izin runtime

Android 13 (API level 33) dan yang lebih baru mendukung izin runtime untuk memposting notifikasi yang tidak dikecualikan (termasuk Layanan Latar Depan (FGS)) dari aplikasi.

Izin yang perlu Anda deklarasikan dalam file manifes aplikasi akan muncul dalam cuplikan kode berikut:

<manifest ...>
    <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
    <application ...>
        ...
    </application>
</manifest>

Untuk detail selengkapnya tentang izin runtime, lihat Izin runtime notifikasi.

Menetapkan konten notifikasi

Untuk memulai, tetapkan konten dan saluran notifikasi menggunakan objek NotificationCompat.Builder. Contoh berikut menunjukkan cara membuat notifikasi dengan hal berikut:

  • Ikon kecil, yang ditetapkan oleh setSmallIcon(). Ini adalah satu-satunya konten yang dapat dilihat pengguna yang diperlukan.

  • Judul, ditetapkan oleh setContentTitle().

  • Teks isi, ditetapkan oleh setContentText().

  • Prioritas notifikasi, ditetapkan oleh setPriority(). Prioritas tersebut menentukan seberapa mengganggu notifikasi di Android 7.1 dan yang lebih lama. Untuk Android 8.0 dan yang lebih baru, setel nilai penting saluran seperti yang ditunjukkan di bagian berikutnya.

Kotlin

var builder = NotificationCompat.Builder(this, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setContentTitle(textTitle)
        .setContentText(textContent)
        .setPriority(NotificationCompat.PRIORITY_DEFAULT)

Java

NotificationCompat.Builder builder = new NotificationCompat.Builder(this, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setContentTitle(textTitle)
        .setContentText(textContent)
        .setPriority(NotificationCompat.PRIORITY_DEFAULT);

Konstruktor NotificationCompat.Builder mengharuskan Anda memberikan ID saluran. Hal ini diperlukan untuk kompatibilitas dengan Android 8.0 (API level 26) dan yang lebih baru, tetapi diabaikan oleh versi sebelumnya.

Secara default, konten teks notifikasi dipotong agar pas dalam satu baris. Anda dapat menampilkan informasi tambahan dengan membuat notifikasi yang dapat diluaskan.

Gambar 2. Notifikasi yang dapat diluaskan dalam bentuk yang diciutkan dan diluaskan.

Jika ingin notifikasi lebih panjang, Anda dapat mengaktifkan notifikasi yang dapat diperluas dengan menambahkan template gaya dengan setStyle(). Misalnya, kode berikut akan membuat area teks yang lebih besar:

Kotlin

var builder = NotificationCompat.Builder(this, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setContentTitle("My notification")
        .setContentText("Much longer text that cannot fit one line...")
        .setStyle(NotificationCompat.BigTextStyle()
                .bigText("Much longer text that cannot fit one line..."))
        .setPriority(NotificationCompat.PRIORITY_DEFAULT)

Java

NotificationCompat.Builder builder = new NotificationCompat.Builder(this, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setContentTitle("My notification")
        .setContentText("Much longer text that cannot fit one line...")
        .setStyle(new NotificationCompat.BigTextStyle()
                .bigText("Much longer text that cannot fit one line..."))
        .setPriority(NotificationCompat.PRIORITY_DEFAULT);

Untuk informasi selengkapnya tentang gaya notifikasi besar lainnya, termasuk cara menambahkan gambar dan kontrol pemutaran media, lihat Membuat notifikasi yang dapat diperluas.

Membuat saluran dan menetapkan kepentingannya

Sebelum dapat mengirimkan notifikasi di Android 8.0 dan yang lebih baru, daftarkan saluran notifikasi aplikasi Anda ke sistem dengan meneruskan instance NotificationChannel ke createNotificationChannel(). Kode berikut diblokir oleh suatu kondisi pada versi SDK_INT:

Kotlin

private fun createNotificationChannel() {
    // Create the NotificationChannel, but only on API 26+ because
    // the NotificationChannel class is not in the Support Library.
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        val name = getString(R.string.channel_name)
        val descriptionText = getString(R.string.channel_description)
        val importance = NotificationManager.IMPORTANCE_DEFAULT
        val channel = NotificationChannel(CHANNEL_ID, name, importance).apply {
            description = descriptionText
        }
        // Register the channel with the system.
        val notificationManager: NotificationManager =
            getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
        notificationManager.createNotificationChannel(channel)
    }
}

Java

private void createNotificationChannel() {
    // Create the NotificationChannel, but only on API 26+ because
    // the NotificationChannel class is not in the Support Library.
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        CharSequence name = getString(R.string.channel_name);
        String description = getString(R.string.channel_description);
        int importance = NotificationManager.IMPORTANCE_DEFAULT;
        NotificationChannel channel = new NotificationChannel(CHANNEL_ID, name, importance);
        channel.setDescription(description);
        // Register the channel with the system; you can't change the importance
        // or other notification behaviors after this.
        NotificationManager notificationManager = getSystemService(NotificationManager.class);
        notificationManager.createNotificationChannel(channel);
    }
}

Karena Anda harus membuat saluran notifikasi sebelum memposting notifikasi apa pun di Android 8.0 dan yang lebih baru, jalankan kode ini segera setelah aplikasi dimulai. Aman untuk memanggilnya berulang kali, karena membuat saluran notifikasi yang ada tidak akan menjalankan operasi apa pun.

Konstruktor NotificationChannel memerlukan importance, menggunakan salah satu konstanta dari class NotificationManager. Parameter ini menentukan cara menginterupsi pengguna untuk setiap notifikasi yang dimiliki saluran ini. Tetapkan prioritas dengan setPriority() untuk mendukung Android 7.1 dan yang lebih lama, seperti yang ditunjukkan dalam contoh sebelumnya.

Meskipun Anda harus menetapkan kepentingan atau prioritas notifikasi seperti yang ditunjukkan pada contoh berikut, sistem tidak menjamin perilaku pemberitahuan yang Anda dapatkan. Pada beberapa kasus, sistem mungkin mengubah tingkat kepentingan berdasarkan faktor lain, dan pengguna selalu dapat menentukan ulang tingkat kepentingan untuk saluran tertentu.

Untuk mengetahui informasi perbedaan tingkat selengkapnya, baca tingkat kepentingan notifikasi.

Menetapkan tindakan ketuk notifikasi

Setiap notifikasi harus merespons ketukan, biasanya untuk membuka aktivitas dalam aplikasi Anda yang sesuai dengan notifikasi tersebut. Untuk melakukannya, tentukan intent konten yang ditentukan dengan objek PendingIntent dan teruskan ke setContentIntent().

Cuplikan berikut ini menunjukkan cara membuat intent dasar untuk membuka aktivitas saat pengguna mengetuk notifikasi:

Kotlin

// Create an explicit intent for an Activity in your app.
val intent = Intent(this, AlertDetails::class.java).apply {
    flags = Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TASK
}
val pendingIntent: PendingIntent = PendingIntent.getActivity(this, 0, intent, PendingIntent.FLAG_IMMUTABLE)

val builder = NotificationCompat.Builder(this, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setContentTitle("My notification")
        .setContentText("Hello World!")
        .setPriority(NotificationCompat.PRIORITY_DEFAULT)
        // Set the intent that fires when the user taps the notification.
        .setContentIntent(pendingIntent)
        .setAutoCancel(true)

Java

// Create an explicit intent for an Activity in your app.
Intent intent = new Intent(this, AlertDetails.class);
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TASK);
PendingIntent pendingIntent = PendingIntent.getActivity(this, 0, intent, PendingIntent.FLAG_IMMUTABLE);

NotificationCompat.Builder builder = new NotificationCompat.Builder(this, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setContentTitle("My notification")
        .setContentText("Hello World!")
        .setPriority(NotificationCompat.PRIORITY_DEFAULT)
        // Set the intent that fires when the user taps the notification.
        .setContentIntent(pendingIntent)
        .setAutoCancel(true);

Kode ini memanggil setAutoCancel(), yang otomatis menghapus notifikasi saat pengguna mengetuknya.

Metode setFlags() yang ditunjukkan pada contoh sebelumnya mempertahankan pengalaman navigasi yang diharapkan pengguna setelah mereka membuka aplikasi menggunakan notifikasi. Anda dapat menggunakannya bergantung pada jenis aktivitas yang Anda mulai, yang dapat berupa salah satu hal berikut:

  • Aktivitas yang ada khusus untuk merespons notifikasi. Tidak ada alasan pengguna menavigasi ke aktivitas ini selama penggunaan aplikasi normal, sehingga aktivitas tersebut akan memulai tugas baru, bukan ditambahkan ke tugas dan data sebelumnya yang sudah ada pada aplikasi Anda. Ini adalah jenis intent yang dibuat dalam contoh sebelumnya.

  • Aktivitas yang ada dalam alur aplikasi reguler aplikasi Anda. Dalam hal ini, memulai aktivitas akan membuat data sebelumnya sehingga ekspektasi pengguna terhadap tombol Kembali dan Atas tetap dipertahankan.

Untuk informasi selengkapnya tentang berbagai cara mengonfigurasi intent notifikasi Anda, lihat Memulai Aktivitas dari Notifikasi.

Menampilkan notifikasi

Agar notifikasi muncul, panggil NotificationManagerCompat.notify(), dengan meneruskan ID unik untuk notifikasi tersebut dan hasil NotificationCompat.Builder.build(). Hal ini ditunjukkan dalam contoh berikut:

Kotlin

with(NotificationManagerCompat.from(this)) {
    if (ActivityCompat.checkSelfPermission(
            this@MainActivity,
            Manifest.permission.POST_NOTIFICATIONS
        ) != PackageManager.PERMISSION_GRANTED
    ) {
        // TODO: Consider calling
        // ActivityCompat#requestPermissions
        // here to request the missing permissions, and then overriding
        // public fun onRequestPermissionsResult(requestCode: Int, permissions: Array<out String>,
        //                                        grantResults: IntArray)
        // to handle the case where the user grants the permission. See the documentation
        // for ActivityCompat#requestPermissions for more details.

        return@with
    }
    // notificationId is a unique int for each notification that you must define.
    notify(NOTIFICATION_ID, builder.build())
}

Java

with(NotificationManagerCompat.from(this)) {
   if (ActivityCompat.checkSelfPermission(
           this@MainActivity,
           Manifest.permission.POST_NOTIFICATIONS
       ) != PackageManager.PERMISSION_GRANTED
   ) {
       // TODO: Consider calling
       // ActivityCompat#requestPermissions
       // here to request the missing permissions, and then overriding
       // public void onRequestPermissionsResult(int requestCode, String[] permissions,
       //                                        int[] grantResults)
       // to handle the case where the user grants the permission. See the documentation
       // for ActivityCompat#requestPermissions for more details.

       return
   }
   // notificationId is a unique int for each notification that you must define.
   notify(NOTIFICATION_ID, builder.build())
}

Simpan ID notifikasi yang Anda teruskan ke NotificationManagerCompat.notify(), karena Anda memerlukannya saat ingin memperbarui atau menghapus notifikasi.

Selain itu, untuk menguji notifikasi dasar di perangkat yang berjalan di Android 13 dan yang lebih baru, aktifkan notifikasi secara manual atau buat dialog untuk meminta notifikasi.

Menambahkan tombol tindakan

Notifikasi dapat menawarkan hingga tiga tombol tindakan yang memungkinkan pengguna merespons dengan cepat, seperti menunda pengingat atau membalas pesan teks. Namun, tombol tindakan ini tidak boleh menduplikasi tindakan yang dijalankan ketika pengguna mengetuk notifikasi.

Gambar 3. Notifikasi dengan satu tombol tindakan.

Untuk menambahkan tombol tindakan, teruskan PendingIntent ke metode addAction(). Cara ini mirip dengan menyiapkan tindakan ketuk default notifikasi. Namun, bukan meluncurkan aktivitas, Anda dapat melakukan hal lain seperti memulai BroadcastReceiver yang melakukan tugas di latar belakang sehingga tindakan tersebut tidak mengganggu aplikasi yang sudah terbuka.

Misalnya, kode berikut ini menunjukkan cara mengirim siaran ke penerima tertentu:

Kotlin


val ACTION_SNOOZE = "snooze"

val snoozeIntent = Intent(this, MyBroadcastReceiver::class.java).apply {
    action = ACTION_SNOOZE
    putExtra(EXTRA_NOTIFICATION_ID, 0)
}
val snoozePendingIntent: PendingIntent =
    PendingIntent.getBroadcast(this, 0, snoozeIntent, 0)
val builder = NotificationCompat.Builder(this, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setContentTitle("My notification")
        .setContentText("Hello World!")
        .setPriority(NotificationCompat.PRIORITY_DEFAULT)
        .setContentIntent(pendingIntent)
        .addAction(R.drawable.ic_snooze, getString(R.string.snooze),
                snoozePendingIntent)

Java


String ACTION_SNOOZE = "snooze"

Intent snoozeIntent = new Intent(this, MyBroadcastReceiver.class);
snoozeIntent.setAction(ACTION_SNOOZE);
snoozeIntent.putExtra(EXTRA_NOTIFICATION_ID, 0);
PendingIntent snoozePendingIntent =
        PendingIntent.getBroadcast(this, 0, snoozeIntent, 0);

NotificationCompat.Builder builder = new NotificationCompat.Builder(this, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setContentTitle("My notification")
        .setContentText("Hello World!")
        .setPriority(NotificationCompat.PRIORITY_DEFAULT)
        .setContentIntent(pendingIntent)
        .addAction(R.drawable.ic_snooze, getString(R.string.snooze),
                snoozePendingIntent);

Untuk mengetahui informasi selengkapnya tentang mem-build BroadcastReceiver guna menjalankan tugas latar belakang, lihat Ringkasan siaran.

Jika Anda mencoba membuat notifikasi dengan tombol pemutaran media, seperti untuk menjeda dan melewati lagu, lihat cara membuat notifikasi dengan kontrol media.

Menambahkan tindakan balasan langsung

Tindakan balasan langsung, yang diperkenalkan di Android 7.0 (API level 24), memungkinkan pengguna memasukkan teks langsung ke dalam notifikasi. Teks kemudian dikirimkan ke aplikasi Anda tanpa membuka aktivitas. Misalnya, Anda dapat menggunakan tindakan balasan langsung untuk memungkinkan pengguna membalas pesan teks atau memperbarui daftar tugas dari dalam notifikasi.

Gambar 4. Mengetuk tombol "Balas" akan membuka {i>input<i} teks.

Tindakan balasan langsung muncul sebagai tombol tambahan dalam notifikasi yang membuka input teks. Setelah pengguna selesai mengetik, sistem akan melampirkan respons teks ke intent yang Anda tentukan untuk tindakan notifikasi dan mengirimkan intent tersebut ke aplikasi Anda.

Menambahkan tombol balas

Untuk membuat tindakan notifikasi yang mendukung balasan langsung, ikuti langkah-langkah berikut:

  1. Buat instance RemoteInput.Builder yang dapat Anda tambahkan ke tindakan notifikasi. Konstruktor class ini menerima string yang digunakan sistem sebagai kunci untuk input teks. Aplikasi Anda nanti menggunakan kunci tersebut untuk mengambil teks input.

    Kotlin

      // Key for the string that's delivered in the action's intent.
      private val KEY_TEXT_REPLY = "key_text_reply"
      var replyLabel: String = resources.getString(R.string.reply_label)
      var remoteInput: RemoteInput = RemoteInput.Builder(KEY_TEXT_REPLY).run {
          setLabel(replyLabel)
          build()
      }
      

    Java

      // Key for the string that's delivered in the action's intent.
      private static final String KEY_TEXT_REPLY = "key_text_reply";
    
      String replyLabel = getResources().getString(R.string.reply_label);
      RemoteInput remoteInput = new RemoteInput.Builder(KEY_TEXT_REPLY)
              .setLabel(replyLabel)
              .build();
      
  2. Buat PendingIntent untuk tindakan balasan.

    Kotlin

      // Build a PendingIntent for the reply action to trigger.
      var replyPendingIntent: PendingIntent =
          PendingIntent.getBroadcast(applicationContext,
              conversation.getConversationId(),
              getMessageReplyIntent(conversation.getConversationId()),
              PendingIntent.FLAG_UPDATE_CURRENT)
      

    Java

      // Build a PendingIntent for the reply action to trigger.
      PendingIntent replyPendingIntent =
              PendingIntent.getBroadcast(getApplicationContext(),
                      conversation.getConversationId(),
                      getMessageReplyIntent(conversation.getConversationId()),
                      PendingIntent.FLAG_UPDATE_CURRENT);
      
  3. Lampirkan objek RemoteInput ke suatu tindakan menggunakan addRemoteInput().

    Kotlin

      // Create the reply action and add the remote input.
      var action: NotificationCompat.Action =
          NotificationCompat.Action.Builder(R.drawable.ic_reply_icon,
              getString(R.string.label), replyPendingIntent)
              .addRemoteInput(remoteInput)
              .build()
      

    Java

      // Create the reply action and add the remote input.
      NotificationCompat.Action action =
              new NotificationCompat.Action.Builder(R.drawable.ic_reply_icon,
                      getString(R.string.label), replyPendingIntent)
                      .addRemoteInput(remoteInput)
                      .build();
      
  4. Terapkan tindakan tersebut pada notifikasi dan keluarkan notifikasinya.

    Kotlin

      // Build the notification and add the action.
      val newMessageNotification = Notification.Builder(context, CHANNEL_ID)
              .setSmallIcon(R.drawable.ic_message)
              .setContentTitle(getString(R.string.title))
              .setContentText(getString(R.string.content))
              .addAction(action)
              .build()
    
      // Issue the notification.
      with(NotificationManagerCompat.from(this)) {
          notificationManager.notify(notificationId, newMessageNotification)
      }
      

    Java

      // Build the notification and add the action.
      Notification newMessageNotification = new Notification.Builder(context, CHANNEL_ID)
              .setSmallIcon(R.drawable.ic_message)
              .setContentTitle(getString(R.string.title))
              .setContentText(getString(R.string.content))
              .addAction(action)
              .build();
    
      // Issue the notification.
      NotificationManagerCompat notificationManager = NotificationManagerCompat.from(this);
      notificationManager.notify(notificationId, newMessageNotification);
      

Sistem akan meminta pengguna untuk memasukkan respons ketika mereka memicu tindakan notifikasi, seperti yang ditunjukkan pada gambar 4.

Mengambil input pengguna dari balasan

Untuk menerima input pengguna dari UI balasan notifikasi, panggil RemoteInput.getResultsFromIntent(), dengan meneruskan Intent yang diterima oleh BroadcastReceiver Anda:

Kotlin

private fun getMessageText(intent: Intent): CharSequence? {
    return RemoteInput.getResultsFromIntent(intent)?.getCharSequence(KEY_TEXT_REPLY)
}

Java

private CharSequence getMessageText(Intent intent) {
    Bundle remoteInput = RemoteInput.getResultsFromIntent(intent);
    if (remoteInput != null) {
        return remoteInput.getCharSequence(KEY_TEXT_REPLY);
    }
    return null;
 }

Setelah Anda memproses teks, perbarui notifikasi dengan memanggil NotificationManagerCompat.notify() menggunakan ID dan tag yang sama, jika digunakan. Langkah ini diperlukan untuk menyembunyikan UI balasan langsung dan mengonfirmasi kepada pengguna bahwa balasan mereka diterima dan diproses dengan benar.

Kotlin

// Build a new notification, which informs the user that the system
// handled their interaction with the previous notification.
val repliedNotification = Notification.Builder(context, CHANNEL_ID)
        .setSmallIcon(R.drawable.ic_message)
        .setContentText(getString(R.string.replied))
        .build()

// Issue the new notification.
NotificationManagerCompat.from(this).apply {
    notificationManager.notify(notificationId, repliedNotification)
}

Java

// Build a new notification, which informs the user that the system
// handled their interaction with the previous notification.
Notification repliedNotification = new Notification.Builder(context, CHANNEL_ID)
        .setSmallIcon(R.drawable.ic_message)
        .setContentText(getString(R.string.replied))
        .build();

// Issue the new notification.
NotificationManagerCompat notificationManager = NotificationManagerCompat.from(this);
notificationManager.notify(notificationId, repliedNotification);

Saat menangani notifikasi baru ini, gunakan konteks yang diteruskan ke metode onReceive() penerima.

Tambahkan balasan ke bagian bawah notifikasi dengan memanggil setRemoteInputHistory(). Namun, jika Anda mem-build aplikasi pesan, buat notifikasi gaya pesan dan tambahkan pesan baru ke percakapan.

Untuk saran notifikasi dari aplikasi pesan selengkapnya, lihat bagian tentang praktik terbaik untuk aplikasi pesan.

Menambahkan status progres

Notifikasi dapat menyertakan indikator progres beranimasi yang menampilkan status operasi yang sedang berlangsung kepada pengguna.

Gambar 5. Status progres selama operasi.

Jika Anda dapat memperkirakan jumlah operasi yang selesai setiap saat, gunakan bentuk indikator "pasti"—seperti yang ditunjukkan pada gambar 5—dengan memanggil setProgress(max, progress, false). Parameter pertama adalah berapa nilai "lengkap", seperti 100. Yang kedua adalah berapa banyak yang sudah selesai. Bagian terakhir menunjukkan bahwa ini adalah status progres yang pasti.

Selagi operasi Anda berlanjut, panggil terus setProgress(max, progress, false) dengan nilai yang diperbarui untuk progress dan keluarkan ulang notifikasi, seperti yang ditunjukkan pada contoh berikut.

Kotlin

val builder = NotificationCompat.Builder(this, CHANNEL_ID).apply {
    setContentTitle("Picture Download")
    setContentText("Download in progress")
    setSmallIcon(R.drawable.ic_notification)
    setPriority(NotificationCompat.PRIORITY_LOW)
}
val PROGRESS_MAX = 100
val PROGRESS_CURRENT = 0
NotificationManagerCompat.from(this).apply {
    // Issue the initial notification with zero progress.
    builder.setProgress(PROGRESS_MAX, PROGRESS_CURRENT, false)
    notify(notificationId, builder.build())

    // Do the job that tracks the progress here.
    // Usually, this is in a worker thread.
    // To show progress, update PROGRESS_CURRENT and update the notification with:
    // builder.setProgress(PROGRESS_MAX, PROGRESS_CURRENT, false);
    // notificationManager.notify(notificationId, builder.build());

    // When done, update the notification once more to remove the progress bar.
    builder.setContentText("Download complete")
            .setProgress(0, 0, false)
    notify(notificationId, builder.build())
}

Java

...
NotificationManagerCompat notificationManager = NotificationManagerCompat.from(this);
NotificationCompat.Builder builder = new NotificationCompat.Builder(this, CHANNEL_ID);
builder.setContentTitle("Picture Download")
        .setContentText("Download in progress")
        .setSmallIcon(R.drawable.ic_notification)
        .setPriority(NotificationCompat.PRIORITY_LOW);

// Issue the initial notification with zero progress.
int PROGRESS_MAX = 100;
int PROGRESS_CURRENT = 0;
builder.setProgress(PROGRESS_MAX, PROGRESS_CURRENT, false);
notificationManager.notify(notificationId, builder.build());

// Do the job that tracks the progress here.
// Usually, this is in a worker thread.
// To show progress, update PROGRESS_CURRENT and update the notification with:
// builder.setProgress(PROGRESS_MAX, PROGRESS_CURRENT, false);
// notificationManager.notify(notificationId, builder.build());

// When done, update the notification once more to remove the progress bar.
builder.setContentText("Download complete")
        .setProgress(0,0,false);
notificationManager.notify(notificationId, builder.build());

Di akhir operasi, progress harus sama dengan max. Anda dapat membiarkan status progres untuk menunjukkan bahwa operasi telah selesai atau menghapusnya. Dalam kedua kasus tersebut, perbarui teks notifikasi untuk menunjukkan bahwa operasi telah selesai. Untuk menghapus status progres, panggil setProgress(0, 0, false).

Untuk menampilkan status progres yang tidak tentu (status yang tidak menunjukkan persentase penyelesaian), panggil setProgress(0, 0, true). Hasilnya adalah indikator yang memiliki gaya yang sama dengan status progres sebelumnya, kecuali bahwa indikator tersebut berupa animasi berkelanjutan yang tidak menunjukkan penyelesaian. Animasi progres akan berjalan hingga Anda memanggil setProgress(0, 0, false), lalu perbarui notifikasi untuk menghapus indikator aktivitas.

Ingatlah untuk mengubah teks notifikasi agar menunjukkan bahwa operasi selesai.

Menetapkan kategori seluruh sistem

Android menggunakan kategori seluruh sistem yang telah ditentukan sebelumnya untuk menentukan apakah akan mengganggu pengguna dengan notifikasi tertentu ketika pengguna mengaktifkan mode Jangan Ganggu.

Jika notifikasi Anda termasuk dalam salah satu kategori notifikasi yang ditentukan dalam NotificationCompat—seperti CATEGORY_ALARM, CATEGORY_REMINDER, CATEGORY_EVENT, atau CATEGORY_CALL—deklarasikan demikian dengan meneruskan kategori yang sesuai ke setCategory():

Kotlin

var builder = NotificationCompat.Builder(this, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setContentTitle("My notification")
        .setContentText("Hello World!")
        .setPriority(NotificationCompat.PRIORITY_DEFAULT)
        .setCategory(NotificationCompat.CATEGORY_MESSAGE)

Java

NotificationCompat.Builder builder = new NotificationCompat.Builder(this, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setContentTitle("My notification")
        .setContentText("Hello World!")
        .setPriority(NotificationCompat.PRIORITY_DEFAULT)
        .setCategory(NotificationCompat.CATEGORY_MESSAGE);

Sistem menggunakan informasi tentang kategori notifikasi Anda untuk membuat keputusan tentang menampilkan notifikasi ketika perangkat dalam mode Jangan Disturb. Namun, Anda tidak harus menetapkan kategori untuk seluruh sistem. Hanya lakukan hal ini jika notifikasi Anda cocok dengan salah satu kategori yang ditentukan dalam NotificationCompat.

Menampilkan pesan penting

Aplikasi Anda mungkin perlu menampilkan pesan penting dan yang sensitif waktu, seperti panggilan telepon masuk atau alarm yang berdering. Dalam situasi ini, Anda dapat mengaitkan intent layar penuh dengan notifikasi Anda.

Saat notifikasi dipanggil, pengguna akan melihat salah satu dari yang berikut, bergantung pada status kunci perangkat:

  • Jika perangkat pengguna terkunci, aktivitas layar penuh muncul, menutupi layar kunci.
  • Jika perangkat pengguna tidak dikunci, notifikasi muncul dalam bentuk diperluas yang mencakup opsi untuk menangani atau mengabaikan notifikasi.

Cuplikan kode berikut menunjukkan cara mengaitkan notifikasi Anda dengan intent layar penuh:

Kotlin

val fullScreenIntent = Intent(this, ImportantActivity::class.java)
val fullScreenPendingIntent = PendingIntent.getActivity(this, 0,
    fullScreenIntent, PendingIntent.FLAG_UPDATE_CURRENT)

var builder = NotificationCompat.Builder(this, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setContentTitle("My notification")
        .setContentText("Hello World!")
        .setPriority(NotificationCompat.PRIORITY_DEFAULT)
        .setFullScreenIntent(fullScreenPendingIntent, true)

Java

Intent fullScreenIntent = new Intent(this, ImportantActivity.class);
PendingIntent fullScreenPendingIntent = PendingIntent.getActivity(this, 0,
        fullScreenIntent, PendingIntent.FLAG_UPDATE_CURRENT);

NotificationCompat.Builder builder = new NotificationCompat.Builder(this, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setContentTitle("My notification")
        .setContentText("Hello World!")
        .setPriority(NotificationCompat.PRIORITY_DEFAULT)
        .setFullScreenIntent(fullScreenPendingIntent, true);

Menetapkan visibilitas layar kunci

Untuk mengontrol tingkat detail yang terlihat dalam notifikasi dari layar kunci, panggil setVisibility() dan tentukan salah satu nilai berikut:

  • VISIBILITY_PUBLIC: konten lengkap notifikasi ditampilkan di layar kunci.

  • VISIBILITY_SECRET: tidak ada bagian notifikasi yang muncul di layar kunci.

  • VISIBILITY_PRIVATE: hanya informasi dasar, seperti ikon notifikasi dan judul konten, yang ditampilkan di layar kunci. Konten lengkap notifikasi tidak ditampilkan.

Saat menyetel VISIBILITY_PRIVATE, Anda juga dapat memberikan versi alternatif konten notifikasi yang menyembunyikan detail tertentu. Misalnya, aplikasi SMS mungkin menampilkan notifikasi yang menampilkan "Anda memiliki 3 pesan teks baru", tetapi menyembunyikan isi dan pengirim pesan. Untuk memberikan notifikasi alternatif ini, pertama-tama buat notifikasi alternatif dengan NotificationCompat.Builder seperti biasa. Kemudian, lampirkan notifikasi alternatif ke notifikasi normal dengan setPublicVersion().

Perhatikan bahwa pengguna selalu memiliki kontrol utama atas apakah notifikasi mereka terlihat di layar kunci dan dapat mengontrolnya berdasarkan saluran notifikasi aplikasi Anda.

Memperbarui notifikasi

Untuk memperbarui notifikasi setelah Anda mengeluarkannya, panggil NotificationManagerCompat.notify() lagi, dengan meneruskan ID yang sama dengan yang Anda gunakan sebelumnya. Jika notifikasi sebelumnya ditutup, notifikasi baru akan dibuat.

Anda memiliki pilihan untuk memanggil setOnlyAlertOnce() sehingga notifikasi mengganggu pengguna—dengan suara, getaran, atau petunjuk visual—hanya saat pertama kali notifikasi muncul dan tidak untuk update berikutnya.

Menghapus notifikasi

Notifikasi akan tetap terlihat hingga salah satu hal berikut terjadi:

  • Pengguna menutup notifikasi.
  • Pengguna mengetuk notifikasi jika Anda memanggil setAutoCancel() saat membuat notifikasi.
  • Anda memanggil cancel() untuk ID notifikasi tertentu. Metode ini juga menghapus notifikasi yang sedang berlangsung.
  • Anda memanggil cancelAll(), yang menghapus semua notifikasi yang dikeluarkan sebelumnya.
  • Durasi yang ditentukan akan berlalu, jika Anda menyetel waktu tunggu saat membuat notifikasi, menggunakan setTimeoutAfter(). Jika diperlukan, Anda dapat membatalkan notifikasi sebelum durasi waktu tunggu yang ditentukan berlalu.

Praktik terbaik untuk aplikasi pesan

Pertimbangkan praktik terbaik yang tercantum di sini saat membuat notifikasi untuk aplikasi pesan dan chat Anda.

Menggunakan MessagingStyle

Mulai Android 7.0 (API level 24), Android menyediakan template gaya notifikasi khusus untuk konten pesan. Dengan menggunakan class NotificationCompat.MessagingStyle, Anda dapat mengubah beberapa label yang ditampilkan pada notifikasi, termasuk judul percakapan, pesan tambahan, dan tampilan konten untuk notifikasi tersebut.

Cuplikan kode berikut menunjukkan cara menyesuaikan gaya notifikasi menggunakan class MessagingStyle.

Kotlin

val user = Person.Builder()
    .setIcon(userIcon)
    .setName(userName)
    .build()

val notification = NotificationCompat.Builder(this, CHANNEL_ID)
    .setContentTitle("2 new messages with $sender")
    .setContentText(subject)
    .setSmallIcon(R.drawable.new_message)
    .setStyle(NotificationCompat.MessagingStyle(user)
        .addMessage(messages[1].getText(), messages[1].getTime(), messages[1].getPerson())
        .addMessage(messages[2].getText(), messages[2].getTime(), messages[2].getPerson())
    )
    .build()

Java

Person user = new Person.Builder()
    .setIcon(userIcon)
    .setName(userName)
    .build();

Notification notification = new NotificationCompat.Builder(this, CHANNEL_ID)
    .setContentTitle("2 new messages with " + sender)
    .setContentText(subject)
    .setSmallIcon(R.drawable.new_message)
    .setStyle(new NotificationCompat.MessagingStyle(user)
        .addMessage(messages[1].getText(), messages[1].getTime(), messages[1].getPerson())
        .addMessage(messages[2].getText(), messages[2].getTime(), messages[2].getPerson())
    )
    .build();

Mulai Android 9.0 (API level 28), Anda juga harus menggunakan class Person untuk mendapatkan rendering notifikasi dan avatarnya yang optimal.

Saat menggunakan NotificationCompat.MessagingStyle, lakukan hal berikut:

  • Panggil MessagingStyle.setConversationTitle() untuk menetapkan judul chat grup dengan lebih dari dua orang. Judul percakapan yang baik dapat berupa nama chat grup atau daftar peserta dalam percakapan jika tidak memiliki nama. Tanpanya, pesan mungkin disalahartikan sebagai percakapan pribadi dengan pengirim pesan terbaru dalam percakapan tersebut.
  • Gunakan metode MessagingStyle.setData() untuk menyertakan pesan media seperti gambar. Jenis MIME dari image/* pola didukung.

Menggunakan Balasan Langsung

Balasan Langsung memungkinkan pengguna membalas langsung suatu pesan.

  • Setelah pengguna membalas dengan tindakan balasan inline, gunakan MessagingStyle.addMessage() untuk mengupdate notifikasi MessagingStyle, dan jangan mencabut atau membatalkan notifikasi. Tidak membatalkan notifikasi memungkinkan pengguna mengirim beberapa balasan dari notifikasi.
  • Agar tindakan balasan inline kompatibel dengan Wear OS, panggil Action.WearableExtender.setHintDisplayInlineAction(true).
  • Gunakan metode addHistoricMessage() untuk memberikan konteks ke percakapan balasan langsung dengan menambahkan pesan historis ke notifikasi.

Aktifkan Smart Reply

  • Untuk mengaktifkan Smart Reply, panggil setAllowGeneratedResponses(true) pada tindakan balas. Hal ini menyebabkan respons Smart Reply tersedia bagi pengguna saat notifikasi dihubungkan ke perangkat Wear OS. Respons Smart Reply dihasilkan oleh model machine learning yang sepenuhnya ada di smartwatch menggunakan konteks yang disediakan oleh notifikasi NotificationCompat.MessagingStyle, dan tidak ada data yang diupload ke internet untuk menghasilkan respons.

Menambahkan metadata notifikasi