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 du modèle MetricStyle dans différents états. 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 style de notification de métrique modifie les comportements en fonction de son état :

  • Les unités de métrique 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 ne s'affichent que si elles tiennent entièrement lorsqu'elles sont 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, au lieu 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