Creare una notifica di stile della metrica

Android 17 introduce il modello di notifiche MetricStyle per supportare i casi d'uso di app per la salute e il fitness, timer e app di viaggio.

Esempio di timer che utilizza MetricStyle
Figura 1: un modello di notifica MetricStyle e un aggiornamento live per un'app orologio

Azioni consentite

Le notifiche di stile della metrica hanno le seguenti funzionalità:

  • Supporta l'utilizzo del metodo setContentTitle.
  • Non mostra il testo di contesto.
  • Supporta fino a tre pulsanti di azione.
  • Supporta la misurazione di un massimo di tre metriche.
    • Ogni Notification.Metric richiede un'etichetta, un valore e un'unità facoltativa.
    • L'aspetto del layout espanso varia in base al numero di metriche acquisite.
Il modello MetricStyle in vari stati
Figura 2: esempi del modello MetricStyle in vari stati. Da sinistra a destra, display sempre attivo (AOD), promosso come aggiornamento live, predefinito/espanso e predefinito/compresso.

Comportamento

La notifica di stile della metrica cambia comportamento in base al suo stato:

  • Le unità di misura vengono aggiunte all'etichetta nello stato espanso.
  • La seconda riga dello stato compresso mostra i contenuti delle metriche concatenati in una singola riga. La seconda e la terza metrica vengono visualizzate solo se si adattano completamente quando vengono concatenate.
  • L'unità viene omessa nello stato compresso.
  • Ogni metrica riceve uno spazio orizzontale uguale, indipendentemente dal suo contenuto.

Come aggiornamento in tempo reale

Quando una notifica di stile di una metrica viene promossa ad aggiornamento live, tieni presente quanto segue:

  • Non è necessario fornire Notification.Builder#setContentTitle perché viene utilizzato il valore della metrica. Se non viene fornito alcun titolo, viene visualizzato il nome dell'app.
  • Se viene fornito Notification.Builder#setSubtext, questo viene visualizzato nella riga di intestazione, anziché spostato su una nuova riga come per gli altri stili promossi.
  • I pulsanti di azione hanno lo stesso aspetto visivo a forma di pillola.

Punti chiave sul codice

Vedi anche