Notifikasi dasar biasanya mencakup judul, satu baris teks, dan tindakan yang dapat dilakukan pengguna sebagai respons. Untuk memberikan informasi selengkapnya, Anda dapat membuat notifikasi berukuran besar dan dapat diperluas dengan menerapkan salah satu dari beberapa template notifikasi seperti yang dijelaskan dalam dokumen ini.
Untuk memulai, buat notifikasi dengan semua konten dasar seperti yang dijelaskan dalam
Membuat notifikasi. Selanjutnya,
panggil
setStyle()
dengan objek gaya dan berikan informasi yang sesuai dengan setiap template, seperti
yang ditunjukkan pada contoh berikut.
Menambahkan gambar berukuran besar
Untuk menambahkan gambar dalam notifikasi, teruskan instance
NotificationCompat.BigPictureStyle
ke setStyle()
.
Kotlin
val notification = NotificationCompat.Builder(context, CHANNEL_ID) .setSmallIcon(R.drawable.new_post) .setContentTitle(imageTitle) .setContentText(imageDescription) .setStyle(NotificationCompat.BigPictureStyle() .bigPicture(myBitmap)) .build()
Java
Notification notification = new NotificationCompat.Builder(context, CHANNEL_ID) .setSmallIcon(R.drawable.new_post) .setContentTitle(imageTitle) .setContentText(imageDescription) .setStyle(new NotificationCompat.BigPictureStyle() .bigPicture(myBitmap)) .build();
Agar gambar hanya muncul sebagai thumbnail saat notifikasi
diciutkan, seperti yang ditunjukkan dalam gambar berikut, panggil
setLargeIcon()
dan teruskan gambar tersebut. Kemudian, panggil
BigPictureStyle.bigLargeIcon()
dan teruskan null
sehingga ikon besar akan menghilang saat notifikasi
diperluas:
Kotlin
val notification = NotificationCompat.Builder(context, CHANNEL_ID) .setSmallIcon(R.drawable.new_post) .setContentTitle(imageTitle) .setContentText(imageDescription) .setLargeIcon(myBitmap) .setStyle(NotificationCompat.BigPictureStyle() .bigPicture(myBitmap) .bigLargeIcon(null)) .build()
Java
Notification notification = new NotificationCompat.Builder(context, CHANNEL_ID) .setSmallIcon(R.drawable.new_post) .setContentTitle(imageTitle) .setContentText(imageDescription) .setLargeIcon(myBitmap) .setStyle(new NotificationCompat.BigPictureStyle() .bigPicture(myBitmap) .bigLargeIcon(null)) .build();
![Gambar yang menunjukkan notifikasi yang diciutkan dan notifikasi yang diperluas yang berisi gambar biru](https://developer.android.google.cn/static/images/ui/notifications/template-image_2x.png?authuser=19&hl=id)
NotificationCompat.BigPictureStyle
.
Menambahkan blok teks besar
Terapkan
NotificationCompat.BigTextStyle
untuk menampilkan teks di area konten yang diperluas pada notifikasi:
Kotlin
val notification = NotificationCompat.Builder(context, CHANNEL_ID) .setSmallIcon(R.drawable.new_mail) .setContentTitle(emailObject.getSenderName()) .setContentText(emailObject.getSubject()) .setLargeIcon(emailObject.getSenderAvatar()) .setStyle(NotificationCompat.BigTextStyle() .bigText(emailObject.getSubjectAndSnippet())) .build()
Java
Notification notification = new NotificationCompat.Builder(context, CHANNEL_ID) .setSmallIcon(R.drawable.new_mail) .setContentTitle(emailObject.getSenderName()) .setContentText(emailObject.getSubject()) .setLargeIcon(emailObject.getSenderAvatar()) .setStyle(new NotificationCompat.BigTextStyle() .bigText(emailObject.getSubjectAndSnippet())) .build();
![Gambar yang menampilkan notifikasi yang diciutkan dan notifikasi yang diperluas menggunakan BigTextStyle](https://developer.android.google.cn/static/images/ui/notifications/template-large-text_2x.png?authuser=19&hl=id)
NotificationCompat.BigTextStyle
.
Membuat notifikasi gaya kotak masuk
Terapkan
NotificationCompat.InboxStyle
ke notifikasi jika Anda ingin menambahkan beberapa baris ringkasan singkat, seperti
cuplikan dari email masuk. Hal ini memungkinkan Anda menambahkan beberapa bagian teks konten
yang masing-masing terpotong ke satu baris, bukan satu baris teks berkelanjutan
yang disediakan oleh NotificationCompat.BigTextStyle
.
Untuk menambahkan baris baru, panggil
addLine()
maksimal enam kali, seperti yang ditunjukkan dalam contoh berikut. Jika Anda menambahkan lebih dari enam
baris, hanya enam baris pertama yang akan terlihat.
Kotlin
val notification = NotificationCompat.Builder(context, CHANNEL_ID) .setSmallIcon(R.drawable.baseline_email_24) .setContentTitle("5 New mails from Frank") .setContentText("Check them out") .setLargeIcon(BitmapFactory.decodeResource(resources, R.drawable.logo)) .setStyle( NotificationCompat.InboxStyle() .addLine("Re: Planning") .addLine("Delivery on its way") .addLine("Follow-up") ) .build()
Java
Notification notification = NotificationCompat.Builder(context, CHANNEL_ID) .setSmallIcon(R.drawable.baseline_email_24) .setContentTitle("5 New mails from Frank") .setContentText("Check them out") .setLargeIcon(BitmapFactory.decodeResource(resources, R.drawable.logo)) .setStyle( NotificationCompat.InboxStyle() .addLine("Re: Planning") .addLine("Delivery on its way") .addLine("Follow-up") ) .build();
Hasilnya akan terlihat seperti gambar berikut:
![Gambar yang menampilkan notifikasi bergaya kotak masuk yang diluaskan](https://developer.android.google.cn/static/images/ui/notifications/expanded_inbox_style_2.png?authuser=19&hl=id)
Menampilkan percakapan dalam notifikasi
Terapkan
NotificationCompat.MessagingStyle
untuk menampilkan pesan berurutan di antara sejumlah orang. Cara ini ideal untuk aplikasi pesan karena menyediakan tata letak yang konsisten untuk setiap pesan dengan menangani nama pengirim dan teks pesan secara terpisah, dan setiap pesan dapat terdiri dari beberapa baris.
Untuk menambahkan pesan baru, panggil
addMessage()
,
dengan meneruskan teks pesan, waktu penerimaan, dan nama pengirim. Anda juga dapat
meneruskan informasi ini sebagai
objek NotificationCompat.MessagingStyle.Message
, seperti yang ditunjukkan pada contoh berikut:
Kotlin
val message1 = NotificationCompat.MessagingStyle.Message( messages[0].getText(), messages[0].getTime(), messages[0].getSender()) val message2 = NotificationCompat.MessagingStyle.Message( messages[1].getText(), messages[1].getTime(), messages[1].getSender()) val notification = NotificationCompat.Builder(context, CHANNEL_ID) .setSmallIcon(R.drawable.new_message) .setStyle( NotificationCompat.MessagingStyle(resources.getString(R.string.reply_name)) .addMessage(message1) .addMessage(message2)) .build()
Java
NotificationCompat.MessagingStyle.Message message1 = new NotificationCompat.MessagingStyle.Message(messages[0].getText(), messages[0].getTime(), messages[0].getSender()); NotificationCompat.MessagingStyle.Message message2 = new NotificationCompat.MessagingStyle.Message(messages[1].getText(), messages[1].getTime(), messages[1].getSender()); Notification notification = new NotificationCompat.Builder(context, CHANNEL_ID) .setSmallIcon(R.drawable.new_message) .setStyle(new NotificationCompat.MessagingStyle(resources.getString(R.string.reply_name)) .addMessage(message1) .addMessage(message2)) .build();
![Gambar yang menunjukkan notifikasi dalam gaya pesan](https://developer.android.google.cn/static/images/ui/notifications/template-messaging_2x.png?authuser=19&hl=id)
NotificationCompat.MessagingStyle
.
Saat menggunakan NotificationCompat.MessagingStyle
, nilai apa pun yang diberikan ke
setContentTitle()
dan
setContentText()
akan diabaikan.
Anda dapat memanggil
setConversationTitle()
untuk menambahkan judul yang muncul di atas percakapan. Hal ini dapat berupa
nama grup yang dibuat pengguna atau, jika tidak memiliki nama tertentu, daftar
peserta dalam percakapan. Jangan menetapkan judul percakapan untuk
chat pribadi karena sistem akan menggunakan keberadaan kolom ini sebagai petunjuk
bahwa percakapan tersebut adalah grup.
Gaya ini hanya berlaku pada perangkat yang menjalankan Android 7.0 (level API 24) dan yang lebih baru.
Saat menggunakan library kompatibilitas
(NotificationCompat
),
seperti yang ditunjukkan sebelumnya, notifikasi dengan MessagingStyle
akan otomatis kembali
ke gaya notifikasi yang diperluas yang didukung.
Saat membuat notifikasi seperti ini untuk percakapan chat, tambahkan tindakan balasan langsung.
Membuat notifikasi dengan kontrol media
Terapkan
MediaStyleNotificationHelper.MediaStyle
untuk menampilkan kontrol pemutaran media dan melacak informasi.
Tentukan
MediaSession
terkait di
konstruktor. Hal ini memungkinkan Android menampilkan informasi yang tepat tentang
media Anda.
Panggil
addAction()
hingga lima kali untuk menampilkan hingga lima tombol ikon. Panggil setLargeIcon()
untuk
menetapkan ilustrasi album.
Tidak seperti gaya notifikasi lainnya, MediaStyle
juga memungkinkan Anda mengubah
tampilan konten ukuran yang diciutkan dengan menentukan tiga tombol tindakan yang juga muncul
dalam tampilan yang diciutkan. Untuk melakukannya, berikan indeks tombol tindakan ke
setShowActionsInCompactView()
.
Contoh berikut menunjukkan cara membuat notifikasi dengan kontrol media:
Kotlin
val notification = NotificationCompat.Builder(context, CHANNEL_ID) // Show controls on lock screen even when user hides sensitive content. .setVisibility(NotificationCompat.VISIBILITY_PUBLIC) .setSmallIcon(R.drawable.ic_stat_player) // Add media control buttons that invoke intents in your media service .addAction(R.drawable.ic_prev, "Previous", prevPendingIntent) // #0 .addAction(R.drawable.ic_pause, "Pause", pausePendingIntent) // #1 .addAction(R.drawable.ic_next, "Next", nextPendingIntent) // #2 // Apply the media style template. .setStyle(MediaStyleNotificationHelper.MediaStyle(mediaSession) .setShowActionsInCompactView(1 /* #1: pause button \*/)) .setContentTitle("Wonderful music") .setContentText("My Awesome Band") .setLargeIcon(albumArtBitmap) .build()
Java
Notification notification = new NotificationCompat.Builder(context, CHANNEL_ID) // Show controls on lock screen even when user hides sensitive content. .setVisibility(NotificationCompat.VISIBILITY_PUBLIC) .setSmallIcon(R.drawable.ic_stat_player) // Add media control buttons that invoke intents in your media service .addAction(R.drawable.ic_prev, "Previous", prevPendingIntent) // #0 .addAction(R.drawable.ic_pause, "Pause", pausePendingIntent) // #1 .addAction(R.drawable.ic_next, "Next", nextPendingIntent) // #2 // Apply the media style template. .setStyle(new MediaStyleNotificationHelper.MediaStyle(mediaSession) .setShowActionsInCompactView(1 /* #1: pause button */)) .setContentTitle("Wonderful music") .setContentText("My Awesome Band") .setLargeIcon(albumArtBitmap) .build();
![Gambar yang menunjukkan notifikasi dengan gaya media](https://developer.android.google.cn/static/images/ui/notifications/template-media_2x.png?authuser=19&hl=id)
MediaStyleNotificationHelper.MediaStyle
.
Referensi lainnya
Lihat referensi berikut untuk informasi selengkapnya tentang MediaStyle
dan
notifikasi yang dapat diperluas.