Créer une notification de style métrique

Android 17 introduit le modèle de notifications MetricStyle pour prendre en charge les cas d'utilisation des applications de santé et de remise en forme, des minuteurs et des applications de voyage.

Exemple de minuteur utilisant MetricStyle
Figure 1 : Modèle de notification MetricStyle et mise à jour en direct pour une application d'horloge

Fonctionnalités

Les notifications de style métrique présentent les fonctionnalités suivantes :

  • Permet d'utiliser la méthode setContentTitle.
  • Le texte de contexte ne s'affiche pas.
  • Accepte jusqu'à trois boutons d'action.
  • Permet de mesurer jusqu'à trois métriques.
    • Chaque Notification.Metric nécessite un libellé, une valeur et une unité facultative.
    • L'apparence de la mise en page développée varie en fonction du nombre de métriques collectées.
Modèle MetricStyle dans différents états
Figure 2 : Exemples de l'état du modèle MetricStyle. De gauche à droite : mode Always-on (AOD), présenté comme une mise à jour en direct, mode par défaut/développé et mode par défaut/réduit.

Comportement

Le comportement des notifications de style métrique varie en fonction de leur état :

  • Les unités métriques sont ajoutées au libellé à l'état développé.
  • La deuxième ligne de l'état réduit affiche le contenu des métriques concaténé sur une seule ligne. Les deuxième et troisième métriques n'apparaissent que si elles tiennent entièrement une fois concaténées.
  • L'unité est omise lorsque l'état est réduit.
  • Chaque métrique reçoit le même espace horizontal, quel que soit son contenu.

En tant qu'info en direct

Lorsque vous transformez une notification de style métrique en info en direct, tenez compte des points suivants :

  • Il n'est pas nécessaire de fournir Notification.Builder#setContentTitle, car la valeur de la métrique est utilisée à la place. Si aucun titre n'est fourni, le nom de l'application est affiché.
  • Si Notification.Builder#setSubtext est fourni, il s'affiche sur la ligne d'en-tête, plutôt que d'être déplacé sur une nouvelle ligne comme pour les autres styles mis en avant.
  • Les boutons d'action ont le même traitement visuel en forme de pilule.

Points clés concernant le code

Voir aussi