Saat memulai aktivitas dari notifikasi, Anda harus mempertahankan pengalaman navigasi yang diharapkan. Mengetuk tombol Kembali harus membawa pengguna kembali melalui alur kerja normal aplikasi ke layar Beranda, dan membuka harus menampilkan aktivitas sebagai tugas terpisah. Untuk mempertahankan navigasi ini pengalaman yang sama, mulailah aktivitas dengan tugas baru.
Pendekatan dasar untuk mengatur perilaku ketuk untuk notifikasi Anda dijelaskan dalam
Membuat konfigurasi dasar
notifikasi.
Halaman ini menjelaskan cara menyiapkan
PendingIntent
untuk
tindakan notifikasi sehingga membuat tugas baru dan kembali
Stack. Cara melakukannya
bergantung pada jenis aktivitas yang Anda mulai:
- Aktivitas rutin
- Ini adalah aktivitas yang ada sebagai bagian dari alur UX normal aplikasi Anda. Kapan pengguna masuk dalam aktivitas dari notifikasi, tugas baru harus menyertakan data sebelumnya yang lengkap, memungkinkan pengguna mengetuk tombol Kembali untuk menavigasi hierarki aplikasi.
- Aktivitas khusus
- Pengguna hanya melihat aktivitas ini jika dimulai dari notifikasi. Di aktivitas ini memperluas UI notifikasi dengan menyediakan informasi yang sulit untuk ditampilkan dalam notifikasi itu sendiri. Aktivitas ini tidak memerlukan data sebelumnya.
Menyiapkan PendingIntent aktivitas rutin
Untuk memulai aktivitas rutin dari notifikasi Anda, siapkan PendingIntent
menggunakan TaskStackBuilder
sehingga dapat membuat data sebelumnya seperti berikut.
Menentukan hierarki Aktivitas aplikasi Anda
Definisikan hierarki alami untuk aktivitas Anda dengan menambahkan atribut
android:parentActivityName
ke setiap <activity>
di file manifes aplikasi Anda. Lihat contoh berikut:
<activity android:name=".MainActivity" android:label="@string/app_name" > <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> <!-- MainActivity is the parent for ResultActivity. --> <activity android:name=".ResultActivity" android:parentActivityName=".MainActivity" /> ... </activity>
Membuat PendingIntent dengan back stack
Untuk memulai aktivitas yang menyertakan data sebelumnya aktivitas, buat aktivitas
instance TaskStackBuilder
dan memanggil
addNextIntentWithParentStack()
,
meneruskan Intent
untuk atribut
aktivitas yang ingin Anda mulai.
Selama Anda menentukan aktivitas induk untuk setiap aktivitas seperti yang dijelaskan
Sebelumnya, Anda dapat memanggil
getPendingIntent()
untuk menerima PendingIntent
yang menyertakan seluruh data sebelumnya.
Kotlin
// Create an Intent for the activity you want to start. val resultIntent = Intent(this, ResultActivity::class.java) // Create the TaskStackBuilder. val resultPendingIntent: PendingIntent? = TaskStackBuilder.create(this).run { // Add the intent, which inflates the back stack. addNextIntentWithParentStack(resultIntent) // Get the PendingIntent containing the entire back stack. getPendingIntent(0, PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE) }
Java
// Create an Intent for the activity you want to start. Intent resultIntent = new Intent(this, ResultActivity.class); // Create the TaskStackBuilder and add the intent, which inflates the back // stack. TaskStackBuilder stackBuilder = TaskStackBuilder.create(this); stackBuilder.addNextIntentWithParentStack(resultIntent); // Get the PendingIntent containing the entire back stack. PendingIntent resultPendingIntent = stackBuilder.getPendingIntent(0, PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE);
Jika perlu, Anda dapat menambahkan argumen ke objek Intent
dalam stack dengan memanggil
TaskStackBuilder.editIntentAt()
.
Hal ini terkadang diperlukan untuk memastikan bahwa suatu aktivitas di data sebelumnya
menampilkan data yang bermakna ketika
pengguna menavigasi ke sana.
Kemudian, Anda dapat meneruskan PendingIntent
ke notifikasi seperti biasa:
Kotlin
val builder = NotificationCompat.Builder(this, CHANNEL_ID).apply { setContentIntent(resultPendingIntent) ... } with(NotificationManagerCompat.from(this)) { notify(NOTIFICATION_ID, builder.build()) }
Java
NotificationCompat.Builder builder = new NotificationCompat.Builder(this, CHANNEL_ID); builder.setContentIntent(resultPendingIntent); ... NotificationManagerCompat notificationManager = NotificationManagerCompat.from(this); notificationManager.notify(NOTIFICATION_ID, builder.build());
Menyiapkan PendingIntent aktivitas khusus
Karena aktivitas khusus yang dimulai dari notifikasi tidak perlu kembali
Anda dapat membuat PendingIntent
dengan memanggil
getActivity()
.
Akan tetapi, tentukan opsi tugas yang sesuai dalam manifes.
-
Dalam manifes, tambahkan atribut berikut ke
Elemen
<activity>
.-
android:taskAffinity=""
-
Dikombinasikan dengan
FLAG_ACTIVITY_NEW_TASK
yang Anda gunakan dalam kode, kosongkan atribut ini untuk memastikan aktivitas ini tidak masuk ke tugas {i>default<i} aplikasi. Apa saja tugas yang ada yang memiliki afinitas default aplikasinya tidak terdampak. -
android:excludeFromRecents="true"
- Mengecualikan tugas baru dari layar Terbaru sehingga pengguna tidak bisa secara tidak sengaja menavigasi kembali ke sana.
Hal ini ditunjukkan dalam contoh berikut:
<activity android:name=".ResultActivity" android:launchMode="singleTask" android:taskAffinity="" android:excludeFromRecents="true"> </activity>
-
-
Buat dan keluarkan notifikasi:
-
Buat
Intent
yang memulaiActivity
. -
Setel
Activity
untuk memulai tugas baru yang kosong dengan meneleponsetFlags()
dengan flagFLAG_ACTIVITY_NEW_TASK
danFLAG_ACTIVITY_CLEAR_TASK
. -
Buat
PendingIntent
dengan memanggilgetActivity()
.
Hal ini ditunjukkan dalam contoh berikut:
Kotlin
val notifyIntent = Intent(this, ResultActivity::class.java).apply { flags = Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TASK } val notifyPendingIntent = PendingIntent.getActivity( this, 0, notifyIntent, PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE )
Java
Intent notifyIntent = new Intent(this, ResultActivity.class); // Set the Activity to start in a new, empty task. notifyIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TASK); // Create the PendingIntent. PendingIntent notifyPendingIntent = PendingIntent.getActivity( this, 0, notifyIntent, PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE );
-
Buat
- Teruskan
PendingIntent
ke notifikasi seperti biasa:Kotlin
val builder = NotificationCompat.Builder(this, CHANNEL_ID).apply { setContentIntent(notifyPendingIntent) ... } with(NotificationManagerCompat.from(this)) { notify(NOTIFICATION_ID, builder.build()) }
Java
NotificationCompat.Builder builder = new NotificationCompat.Builder(this, CHANNEL_ID); builder.setContentIntent(notifyPendingIntent); ... NotificationManagerCompat notificationManager = NotificationManagerCompat.from(this); notificationManager.notify(NOTIFICATION_ID, builder.build());
Untuk informasi selengkapnya tentang berbagai opsi tugas dan cara data sebelumnya berfungsi, lihat Tugas dan data sebelumnya.