Membuat notifikasi gaya metrik

Android 17 memperkenalkan template notifikasi MetricStyle untuk mendukung kasus penggunaan aplikasi kesehatan dan kebugaran, timer, dan aplikasi perjalanan.

Contoh timer menggunakan MetricStyle
Gambar 1: Template notifikasi MetricStyle dan Update Langsung 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.Metric memerlukan label, nilai, dan unit opsional.
    • Tampilan tata letak yang diperluas bervariasi bergantung pada jumlah metrik yang diambil.
Template MetricStyle dalam berbagai status
Gambar 2: Contoh template MetricStyle dalam berbagai status. Dari kiri ke kanan, layar always-on (AOD), dipromosikan sebagai Update Live, default/diperluas, dan default/diciutkan.

Perilaku

Notifikasi gaya metrik mengubah perilaku berdasarkan statusnya:

  • Satuan metrik ditambahkan ke label dalam kondisi diperluas.
  • Baris kedua status diciutkan menampilkan konten metrik yang digabungkan menjadi satu baris. Metrik kedua dan ketiga hanya muncul jika cocok sepenuhnya saat digabungkan.
  • Unit dihilangkan dalam status diciutkan.
  • Setiap metrik menerima ruang horizontal yang sama, terlepas dari kontennya.

Sebagai Info Terbaru Langsung

Saat notifikasi gaya metrik dipromosikan menjadi Info Terbaru, perhatikan pertimbangan berikut:

  • Anda tidak perlu memberikan Notification.Builder#setContentTitle karena nilai metrik yang digunakan. Jika tidak ada judul yang diberikan, nama aplikasi akan ditampilkan.
  • Jika Notification.Builder#setSubtext diberikan, kode ini akan ditampilkan di baris header, bukan dipindahkan ke baris baru seperti gaya yang dipromosikan lainnya.
  • Tombol tindakan memiliki tampilan visual pil yang sama.

Poin penting tentang kode

Lihat juga