Tampilkan notifikasi sesuai-waktu

Aplikasi Anda mungkin perlu segera mendapatkan perhatian pengguna dalam situasi tertentu, seperti alarm yang sedang berbunyi atau panggilan masuk. Pada perangkat yang menjalankan Android 9 (level API 28) atau yang lebih rendah, Anda dapat menangani hal ini dengan meluncurkan aktivitas saat aplikasi berada di latar belakang. Dokumen ini menunjukkan cara mencapai perilaku ini di perangkat yang menjalankan Android 10 (level API 29) (level API 29) dan yang lebih tinggi.

Menambahkan izin POST_NOTIFICATIONS

Mulai Android 13 (API level 33), deklarasikan izin POST_NOTIFICATIONS dalam file AndroidManifest.xml:

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

Setelah mendeklarasikan izin, buat saluran notifikasi.

Membuat saluran notifikasi

Buat saluran notifikasi untuk menampilkan notifikasi dan memungkinkan pengguna mengelola kategori notifikasi di setelan sistem. Untuk mengetahui informasi selengkapnya tentang saluran notifikasi, lihat Membuat dan mengelola saluran notifikasi.

Buat saluran notifikasi di metode onCreate dari class Application:

class MyApplication : 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)
    }
}
TimeSensitive.kt

Saat pengguna menjalankan aplikasi untuk pertama kalinya, sistem akan menampilkan saluran di layar Info aplikasi, seperti yang ditunjukkan pada Gambar 1:

Mengelola izin notifikasi

Mulai Android 13, minta izin notifikasi sebelum Anda menampilkan notifikasi kepada pengguna.

Contoh kode berikut menunjukkan cara meminta izin notifikasi runtime di Jetpack Compose:

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")
}
TimeSensitive.kt

Pada perangkat yang menjalankan Android 13 dan yang lebih tinggi, mengetuk tombol Minta izin akan menampilkan dialog sistem yang ditampilkan dalam Gambar 2:

Saat pengguna memberikan izin, sistem akan memperbarui layar Info aplikasi, seperti yang ditunjukkan pada Gambar 3:

Membuat notifikasi prioritas tinggi

Saat Anda membuat notifikasi prioritas tinggi, berikan judul dan teks pesan yang jelas. Tetapkan juga saluran dan tingkat prioritas yang sangat penting.

Contoh kode berikut mengonfigurasi dan membuat notifikasi prioritas tinggi:

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(0, notificationBuilder.build())
}
TimeSensitive.kt

Menampilkan notifikasi kepada pengguna

Memanggil fungsi showNotification akan memicu notifikasi sebagai berikut:

Button(onClick = { showNotification() }) {
    Text(text = "Show notification")
}
TimeSensitive.kt

Gambar 4 menunjukkan notifikasi prioritas tinggi yang ditampilkan oleh sistem:

Notifikasi yang sedang berlangsung

Saat Anda menampilkan notifikasi kepada pengguna, mereka dapat mengonfirmasi atau menutup pemberitahuan atau pengingat aplikasi Anda. Misalnya, pengguna dapat menerima atau menolak panggilan telepon masuk.

Jika notifikasi Anda mewakili tugas latar belakang yang sedang berlangsung, seperti panggilan telepon aktif, kaitkan notifikasi dengan layanan latar depan. Cuplikan kode berikut menunjukkan cara menampilkan notifikasi yang terkait dengan layanan latar depan:

// Provide a unique integer for the "notificationId" of each notification.
startForeground(notificationId, notification)
TimeSensitive.kt

Pertimbangkan untuk menggunakan Live Update

Notifikasi berkelanjutan yang mendesak dapat memperoleh manfaat dari peningkatan visibilitas. Pertimbangkan untuk mempromosikan notifikasi berkelanjutan sebagai Live Update untuk menampilkan informasi status di seluruh platform UI sistem.