Membuat notifikasi info terbaru

Live update memberikan ringkasan info terbaru yang penting sehingga pengguna dapat melacak progres tanpa membuka aplikasi. Sistem akan mempromosikan notifikasi Live Update meskipun pengguna dapat menutup atau menurunkan peringkat notifikasi live update untuk sementara, menjadi notifikasi standar. Notifikasi yang dipromosikan muncul lebih jelas di platform sistem, termasuk di bagian atas panel samping notifikasi dan layar kunci, serta sebagai chip di status bar. Notifikasi live update harus mengikuti prinsip notifikasi untuk menyampaikan informasi yang singkat, tepat waktu, dan relevan.

Kartu notifikasi yang dipromosikan memiliki karakteristik tampilan berikut:

• Diperluas secara default
• Tidak dapat diciutkan

Notifikasi Anda harus memenuhi persyaratan berikut agar memenuhi syarat sebagai live update:

• Harus berupa Gaya Standar, BigTextStyle, CallStyle, ProgressStyle, atau MetricStyle.
• Harus meminta izin non-runtime berikut dalam manifes android android.permission.POST_PROMOTED_NOTIFICATIONS.
• Harus meminta promosi menggunakan EXTRA_REQUEST_PROMOTED_ONGOING atau NotificationCompat.Builder#setRequestPromotedOngoing.
• Harus berupa ongoing (tetapkan FLAG_ONGOING_EVENT).
• Harus memiliki kumpulan contentTitle.
• TIDAK boleh memiliki customContentView yang ditetapkan (tidak ada RemoteViews).
• TIDAK boleh menjadi ringkasan grup yang menggunakan setGroupSummary.
• TIDAK boleh setColorized ke TRUE.
• Saluran notifikasi TIDAK boleh memiliki IMPORTANCE_MIN.

Karakteristik promosi

API berikut membantu Anda menentukan apakah sistem akan mempromosikan notifikasi Anda:

• Notification.FLAG_PROMOTED_ONGOING menunjukkan apakah notifikasi dipromosikan.
• Notification.hasPromotableCharacteristics() memvalidasi apakah sistem dapat mempromosikan notifikasi. Metode ini tidak mempertimbangkan apakah pengguna menonaktifkan Live Update untuk aplikasi di setelan.
• NotificationManager.canPostPromotedNotifications() memeriksa apakah aplikasi Anda dapat memposting notifikasi promosi, misalnya, jika pengguna mengaktifkan atau menonaktifkannya di setelan.
• Settings.ACTION_MANAGE_APP_PROMOTED_NOTIFICATIONS adalah tindakan intent yang memungkinkan aplikasi mengarahkan pengguna ke Setelan untuk mengaktifkan fitur ini.

Kriteria penggunaan

Gunakan Live Update untuk aktivitas yang sedang berlangsung, dimulai oleh pengguna, dan sensitif terhadap waktu.

Sedang berlangsung

Live Update harus merepresentasikan aktivitas yang sedang berlangsung secara aktif, dengan awal dan akhir yang jelas. Jika aktivitas terjadi di masa lalu, jangan gunakan Live Update. Sebagai gantinya, gunakan notifikasi standar. Hal ini juga berlaku untuk acara yang belum dimulai, meskipun acara yang akan dimulai dapat menggunakan Live Update.

Live Update mewakili aktivitas berkelanjutan. Jangan gunakan Live Update untuk menawarkan akses yang dipercepat ke fungsi aplikasi. Jika Anda ingin melakukannya, gunakan widget aplikasi atau kartu Setelan Cepat kustom.

• Penggunaan yang sesuai: Navigasi aktif, panggilan telepon yang sedang berlangsung, pelacakan layanan transportasi online aktif, dan pelacakan pengiriman makanan aktif.
• Penggunaan yang tidak sesuai: Iklan, promosi, pesan chat, pemberitahuan, acara kalender mendatang, dan akses cepat ke fitur aplikasi.

Dimulai oleh pengguna

Sebagian besar Live Update harus mewakili aktivitas yang secara eksplisit dipicu oleh pengguna, seperti memulai olahraga, memulai navigasi mengemudi, atau memesan layanan transportasi online. Jangan tampilkan informasi sekitar, seperti informasi tentang lingkungan, minat, atau acara mendatang pengguna, di Live Update. Jangan izinkan aktivitas yang dipicu oleh pihak lain untuk membuat Live Update.

Terkadang, pengguna mungkin melakukan tindakan yang memulai aktivitas untuk beberapa waktu ke depan. Misalnya, jika pengguna membeli tiket penerbangan atau konser, mendaftar untuk turnamen, atau menunjukkan kehadiran mereka di masa mendatang pada acara yang sensitif terhadap waktu. Dalam kasus ini, sebaiknya tampilkan Live Update secara otomatis saat acara terjadwal dimulai. Namun, aplikasi harus menyesuaikan pemicunya agar hanya muncul saat aktivitas akan segera terjadi. Jika pengguna secara eksplisit menunjukkan bahwa mereka ingin mulai memantau peristiwa latar belakang seperti pertandingan olahraga, Anda dapat mulai memposting Live Update untuk peristiwa tersebut. Namun, Anda juga harus menyertakan tindakan Lepaskan dalam notifikasi terkait.

Mendesak

Tampilkan Live Update hanya jika memerlukan perhatian pengguna selama aktivitas. Kasus penggunaan utama untuk Live Update adalah pemantauan, saat pengguna mendapatkan manfaat signifikan dari melihat Live Update untuk memantau status aktivitas yang terus berkembang.

Live Update sering kali sesuai untuk aktivitas yang bertransisi antara Live Update dan notifikasi normal. Misalnya, menampilkan notifikasi boarding pass sesuai beberapa jam sebelum penerbangan pengguna, tetapi notifikasi tersebut harus menjadi Pembaruan Live hanya saat pengguna memiliki kebutuhan mendesak, seperti saat mereka telah tiba di bandara atau tempat atau setelah boarding dimulai. Sebaliknya, Live Update tidak sesuai untuk melacak paket karena pengguna tidak perlu terus-menerus memantaunya.

Praktik UX

Gunakan ikon pelacak untuk memvisualisasikan status. Hal ini dapat diperbarui secara dinamis.

Saat PWT sedang dihitung atau belum tersedia, jangan tampilkan status kosong. Berikan teks placeholder aktif seperti "Berpikir..." atau "Mengubah rute..." untuk menunjukkan bahwa sistem sedang bekerja, seperti yang ditunjukkan dalam contoh.

Chip Status

Chip status memungkinkan pengguna memantau live update saat notifikasi tidak terlihat. Gunakan setShortCriticalText atau setWhen untuk menyampaikan informasi status penting terkait notifikasi yang berfokus pada progres.

Jika waktu

Waktu "kapan" memicu hitung mundur untuk masa aktif notifikasi, kecuali jika notifikasi ditutup atau diperbarui. Butir berikut menjelaskan cara kerja waktu dalam berbagai situasi:

• Waktu "when" setidaknya 2 menit di masa mendatang: Jika waktu saat ini adalah pukul 10.05 dan waktu "when" ditetapkan ke pukul 10.10, chip akan menampilkan 5min.
• Jika waktu "when" sudah berlalu: Teks tidak ditampilkan.
• Timer dalam chip dapat ditampilkan saat menggunakan Chronometer untuk waktu. Lihat setUsesChronometer dan setChronometerCountdown. Timer Chronometer ditampilkan di chip selama nilainya positif.
• Anda tidak ingin waktu kapan ditampilkan di notifikasi: Gunakan setShowWhen ke FALSE.

Tampilan chip status

Chip status selalu menyertakan ikon, dan dapat menyertakan teks. Chip memiliki lebar maksimum 96 dp. Teks hanya akan ditampilkan jika seluruh teks dapat muat dalam chip. Teks ditampilkan bergantung pada kriteria berikut:

• Jika kurang dari 7 karakter, tampilkan seluruh teks.
• Jika kurang dari setengah teks akan ditampilkan, tampilkan ikon saja.
• Jika lebih dari separuh teks akan ditampilkan, tampilkan teks sebanyak mungkin.

Wear OS

Live Update dihubungkan ke beberapa perangkat Wear OS yang terhubung. Untuk panduan tentang perilaku penghubung ini, serta panduan tentang cara membuat Live Update lokal untuk Wear OS, lihat panduan Live Update Wear OS.

Dismissal

Pengguna dapat mengontrol visibilitas notifikasi di menu notifikasi. Memposting Live Update yang tidak diinginkan dapat menyebabkan pengguna mencabut izin postingan aplikasi.

Agar pengguna tidak sepenuhnya menonaktifkan Live Update, hindari memposting update yang mungkin ditutup oleh pengguna. Jangan memposting ulang Info Terbaru Langsung yang ditutup oleh pengguna. Gunakan setDeleteIntent untuk mendeteksi update yang ditutup.

Lihat aplikasi contoh untuk bereksperimen dengan API ini.

FAQ

Pertanyaan: Apa arti titik putih di akhir status progres?

Jawaban: Titik putih di akhir status progres secara visual menandai akhir status progres.

Pertanyaan: Mengapa notifikasi kustom tidak didukung untuk Live Update?

Jawaban: Notifikasi kustom mempersulit pengujian dan UX yang konsisten karena perilakunya sangat berbeda di berbagai versi Android dan produsen perangkat. Hindari notifikasi kustom menggunakan RemoteViews.