Membuat notifikasi info terbaru

Info terbaru langsung memberikan ringkasan info terbaru penting sehingga pengguna dapat melacak progres tanpa membuka aplikasi. Sistem mempromosikan notifikasi Info Terbaru Langsung meskipun pengguna dapat menutup atau menurunkan notifikasi info terbaru langsung ke notifikasi standar untuk sementara. Notifikasi yang dipromosikan muncul lebih menonjol di platform sistem, termasuk di bagian atas panel notifikasi dan layar kunci, serta sebagai chip di status bar. Notifikasi info terbaru langsung harus mengikuti prinsip notifikasi untuk menyampaikan informasi 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 info terbaru langsung:

• 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 ongoing (tetapkan FLAG_ONGOING_EVENT).
• Harus memiliki contentTitle yang ditetapkan.
• **TIDAK** boleh memiliki customContentView yang ditetapkan (tidak ada RemoteViews).
• **TIDAK** boleh berupa ringkasan grup menggunakan setGroupSummary.
• **TIDAK** boleh setColorized kesetColorized TRUE.
• Channel 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 Info Terbaru Langsung untuk aplikasi di setelan.
• NotificationManager.canPostPromotedNotifications() memeriksa apakah aplikasi Anda dapat memposting notifikasi yang dipromosikan, misalnya, jika pengguna mengaktifkan atau menonaktifkannya di setelan.
• Settings.ACTION_MANAGE_APP_PROMOTED_NOTIFICATIONS adalah tindakan intent yang memungkinkan aplikasi mengirim pengguna ke Setelan untuk mengaktifkan fitur ini.

Kriteria penggunaan

Gunakan Info Terbaru Langsung untuk aktivitas yang sedang berlangsung, dimulai oleh pengguna, dan sensitif terhadap waktu.

Sedang berlangsung

Info Terbaru Langsung harus mewakili aktivitas yang sedang berlangsung secara aktif, dengan awal dan akhir yang berbeda. Jika aktivitas terjadi di masa lalu, jangan gunakan Info Terbaru Langsung. Sebagai gantinya, gunakan notifikasi standar. Hal ini juga berlaku untuk acara yang belum dimulai, meskipun acara yang akan segera dimulai dapat menggunakan Info Terbaru Langsung.

Info Terbaru Langsung mewakili aktivitas yang sedang berlangsung. Jangan gunakan Info Terbaru Langsung untuk menawarkan akses yang dipercepat ke fungsi aplikasi. Jika ingin melakukannya, gunakan widget aplikasi atau kartu Setelan Cepat kustom.

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

Dimulai oleh pengguna

Sebagian besar Info Terbaru Langsung harus mewakili aktivitas yang secara eksplisit dipicu oleh pengguna, seperti memulai olahraga, memulai navigasi mengemudi, atau memesan rideshare. Jangan tampilkan informasi lingkungan, seperti tentang lingkungan, minat, atau acara mendatang pengguna, di Info Terbaru Langsung. Jangan izinkan aktivitas yang dipicu oleh pihak lain untuk membuat Info Terbaru Langsung.

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

Sensitif terhadap Waktu

Tampilkan Info Terbaru Langsung hanya jika memerlukan perhatian pengguna selama aktivitas. Kasus penggunaan utama untuk Info Terbaru Langsung adalah pemantauan, saat pengguna mendapatkan manfaat signifikan dari melihat Info Terbaru Langsung untuk memantau status aktivitas yang terus berubah.

Info Terbaru Langsung sering kali sesuai untuk aktivitas yang bertransisi antara Info Terbaru Langsung dan notifikasi normal. Misalnya, menampilkan notifikasi boarding pass sesuai beberapa jam sebelum penerbangan pengguna, tetapi notifikasi harus menjadi Info Terbaru Langsung hanya jika pengguna memiliki kebutuhan mendesak, seperti saat mereka tiba di bandara atau tempat acara atau setelah boarding dimulai. Sebaliknya, Info Terbaru Langsung tidak sesuai untuk melacak paket karena pengguna tidak perlu terus memantaunya.

Praktik UX

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

Saat ETA sedang dihitung atau belum tersedia, jangan tampilkan status kosong. Berikan teks placeholder aktif seperti "Memikirkan..." atau "Mengalihkan rute..." untuk menunjukkan bahwa sistem sedang berfungsi, seperti yang ditunjukkan dalam contoh.

Chip Status

Chip status memungkinkan pengguna melacak Info Terbaru Langsung saat notifikasi tidak terlihat. Gunakan setShortCriticalText atau setWhen untuk menyampaikan informasi status penting terkait notifikasi yang berpusat pada progres Anda.

Waktu

Waktu memicu hitungan mundur untuk masa aktif notifikasi, kecuali jika notifikasi ditutup atau diperbarui. Poin-poin berikut menjelaskan cara kerja waktu dalam berbagai situasi:

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

Tampilan chip status

Chip status selalu menyertakan ikon, dan secara opsional menyertakan teks. Chip memiliki lebar maksimum 96 dp. Teks hanya akan ditampilkan jika seluruh teks dapat muat di 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 setengah teks akan ditampilkan, tampilkan teks sebanyak mungkin.

Dismissal

Pengguna dapat mengontrol visibilitas notifikasi di panel notifikasi. Memposting Info Terbaru Langsung yang tidak diinginkan dapat menyebabkan pengguna mencabut izin postingan aplikasi.

Untuk mencegah pengguna menonaktifkan Info Terbaru Langsung sepenuhnya, hindari memposting info terbaru yang mungkin ditutup oleh pengguna. Jangan posting ulang Info Terbaru Langsung yang ditutup oleh pengguna. Gunakan setDeleteIntent untuk mendeteksi info terbaru yang ditutup.

Lihat aplikasi contoh untuk bereksperimen dengan API ini.

FAQ

Pertanyaan: Apa titik putih di akhir progres bar?

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

Pertanyaan: Mengapa notifikasi kustom tidak didukung untuk Info Terbaru Langsung?

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