Aplikasi Anda mungkin perlu segera mendapatkan perhatian pengguna dalam situasi tertentu, seperti alarm yang sedang berlangsung atau panggilan masuk. Di aplikasi yang menargetkan perangkat yang menjalankan Android 9 (level API 28) atau yang lebih lama, Anda dapat menangani ini dengan meluncurkan aktivitas saat aplikasi berada di latar belakang. Dokumen ini menunjukkan cara mencapai perilaku ini pada perangkat yang menjalankan Android 10 (API level 29) untuk Android 13 (level API 33).
Tambahkan izin POST_NOTIFICATIONS
Mulai Android 13, tambahkan baris berikut ke
File AndroidManifest.xml
:
<manifest ...> <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/> <application ...> ... </application> </manifest>
Setelah memilikinya, Anda dapat membuat saluran notifikasi.
Membuat saluran notifikasi
Buat saluran notifikasi untuk menampilkan notifikasi Anda dengan benar dan pengguna mengelola notifikasi di pengaturan aplikasi. Untuk mengetahui informasi selengkapnya tentang saluran notifikasi, lihat Membuat dan mengelola notifikasi saluran.
Buat saluran notifikasi di kelas Application
Anda
Metode onCreate
:
Kotlin
class DACapp : Application() { override fun onCreate() { super.onCreate() val channel = NotificationChannel( CHANNEL_ID, "High priority notifications", NotificationManager.IMPORTANCE_HIGH ) val notificationManager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager notificationManager.createNotificationChannel(channel) } }
Saat pengguna menjalankan aplikasi Anda untuk pertama kalinya, mereka melihat sesuatu seperti gambar 1 di layar sistem Info aplikasi aplikasi Anda:
![Gambar yang menampilkan layar Info Aplikasi dan Notifikasi aplikasi Anda.](https://developer.android.google.cn/static/images/ui/notifications/time-sensitive_notification_channel_empty.png?authuser=0&hl=id)
Mengelola izin notifikasi
Mulai Android 13, minta izin notifikasi sebelum Anda menampilkan notifikasi kepada pengguna.
Implementasi minimum terlihat seperti ini:
Kotlin
val permissionLauncher = rememberLauncherForActivityResult( contract = ActivityResultContracts.RequestPermission(), onResult = { hasNotificationPermission = it } ) ... Button( onClick = { if (!hasNotificationPermission) { if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) { permissionLauncher.launch(Manifest.permission.POST_NOTIFICATIONS) } } }, ) { Text(text = "Request permission") }
Jika perangkat menjalankan Android 13, mengetuk tombol Request
permission
akan memicu dialog yang ditampilkan pada gambar 2:
![Gambar yang menampilkan dialog permintaan izin](https://developer.android.google.cn/static/images/ui/notifications/time-sensitive_notification_permission_request_dialog.png?authuser=0&hl=id)
Jika pengguna menyetujui permintaan izin, bagian Info aplikasi pada aplikasi akan terlihat seperti gambar 3:
![Gambar yang menampilkan layar Info Aplikasi setelah permintaan izin notifikasi dikabulkan](https://developer.android.google.cn/static/images/ui/notifications/time-sensitive_notification_permission_granted.png?authuser=0&hl=id)
Membuat notifikasi prioritas tinggi
Saat membuat notifikasi, sertakan judul dan pesan yang deskriptif.
Contoh berikut berisi notifikasi:
Kotlin
private fun showNotification() { val notificationManager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager val notificationBuilder = NotificationCompat.Builder(this, CHANNEL_ID) .setSmallIcon(R.drawable.baseline_auto_awesome_24) .setContentTitle("HIGH PRIORITY") .setContentText("Check this dog puppy video NOW!") .setPriority(NotificationCompat.PRIORITY_HIGH) .setCategory(NotificationCompat.CATEGORY_RECOMMENDATION) notificationManager.notify(666, notificationBuilder.build()) }
Menampilkan notifikasi kepada pengguna
Memanggil fungsi showNotification()
akan memicu notifikasi sebagai berikut:
Kotlin
Button(onClick = { showNotification() }) { Text(text = "Show notification") }
Notifikasi dalam contoh ini terlihat seperti gambar 4:
![Gambar yang menampilkan notifikasi prioritas tinggi](https://developer.android.google.cn/static/images/ui/notifications/time-sensitive_notification.png?authuser=0&hl=id)
Notifikasi yang sedang berlangsung
Ketika Anda menampilkan notifikasi kepada pengguna, mereka dapat mengonfirmasi atau mengabaikan pemberitahuan atau pengingat aplikasi Anda. Misalnya, pengguna dapat menerima atau menolak panggilan telepon masuk.
Jika notifikasi Anda adalah notifikasi yang sedang berlangsung, seperti panggilan telepon masuk, hubungkan notifikasi dengan latar depan layanan. Cuplikan kode berikut menunjukkan cara menampilkan notifikasi yang terkait dengan layanan latar depan:
Kotlin
// Provide a unique integer for the "notificationId" of each notification. startForeground(notificationId, notification)
Java
// Provide a unique integer for the "notificationId" of each notification. startForeground(notificationId, notification);