Android 17 memperkenalkan template notifikasi MetricStyle untuk mendukung
kasus penggunaan aplikasi kesehatan dan kebugaran, timer, dan aplikasi perjalanan.
MetricStyle dan Update Live untuk aplikasi jam
Kemampuan
Notifikasi gaya metrik memiliki kemampuan berikut:
- Mendukung penggunaan metode
setContentTitle. - Tidak menampilkan teks konteks.
- Mendukung hingga 3 tombol tindakan.
- Mendukung pengukuran hingga 3 metrik.
- Setiap
Notification.Metricmemerlukan label, nilai, dan unit opsional. - Tampilan tata letak yang diperluas bervariasi bergantung pada jumlah metrik yang diambil.
- Setiap
MetricStyle dalam berbagai
status. Dari kiri ke kanan, layar always-on (AOD), dipromosikan sebagai Live
Update, default/diperluas, dan default/diciutkan.
Perilaku
Notifikasi gaya metrik mengubah perilaku berdasarkan statusnya:
- Unit metrik ditambahkan ke label dalam status diperluas.
- Baris kedua status yang diciutkan menampilkan konten metrik yang digabungkan menjadi satu baris. Metrik kedua dan ketiga hanya muncul jika keduanya pas sepenuhnya saat digabungkan.
- Unit dihilangkan dalam status diciutkan.
- Setiap metrik menerima ruang horizontal yang sama, terlepas dari kontennya.
Sebagai Live Update
Saat notifikasi gaya metrik dipromosikan ke Live Update, perhatikan pertimbangan berikut:
- Anda tidak perlu memberikan
Notification.Builder#setContentTitlekarena nilai metrik akan digunakan. Jika tidak ada judul yang diberikan, nama aplikasi akan ditampilkan. - Jika
Notification.Builder#setSubtextdiberikan, gaya ini akan ditampilkan di baris header, bukan dipindahkan ke baris baru seperti gaya yang dipromosikan lainnya. - Tombol tindakan memiliki perlakuan visual berbentuk pil yang sama.
Poin penting tentang kode
- Berikut adalah daftar class dan dokumentasi referensi yang relevan:
Notification.MetricStyleNotification.MetricStyle.setCriticalMetric(int)Notification.MetricNotification.Metric.FixedDateNotification.Metric.FixedFloatNotification.Metric.FixedIntNotification.Metric.FixedTextNotification.Metric.FixedTimeNotification.Metric.MetricValueNotification.Metric.TimeDifference
Lihat juga
- Referensi API Notification.MetricStyle
- Referensi API Notification.Metric
- Referensi API Notification.Action