Benachrichtigung mit Messwertstil erstellen

Mit Android 17 wird die Benachrichtigungsvorlage MetricStyle eingeführt, um Anwendungsfälle für Gesundheits- und Fitness-Apps, Timer und Reise-Apps zu unterstützen.

Beispiel für einen Timer mit MetricStyle
Abbildung 1:Eine MetricStyle-Benachrichtigungsvorlage und ein Live-Update für eine Uhr-App

Rechte

Benachrichtigungen im Messwertstil haben die folgenden Funktionen:

  • Unterstützt die Verwendung der Methode setContentTitle.
  • Der Kontexttext wird nicht angezeigt.
  • Es werden bis zu drei Aktionsschaltflächen unterstützt.
  • Es können bis zu drei Messwerte analysiert werden.
    • Für jede Notification.Metric sind ein Label, ein Wert und eine optionale Einheit erforderlich.
    • Das erweiterte Layout wird je nach Anzahl der erfassten Messwerte unterschiedlich dargestellt.
Die Vorlage „MetricStyle“ in verschiedenen Status
Abbildung 2:Beispiele für die Vorlage MetricStyle in verschiedenen Status. Von links nach rechts: Always-On-Display (AOD), als Live-Update beworben, Standard/erweitert und Standard/minimiert.

Verhalten

Das Verhalten der Benachrichtigung im Messwertstil ändert sich je nach Status:

  • Im maximierten Zustand werden Maßeinheiten an das Label angehängt.
  • In der zweiten Zeile des minimierten Status werden die Inhalte der Messwerte in einer einzigen Zeile zusammengefasst. Der zweite und dritte Messwert werden nur angezeigt, wenn sie nach der Verkettung vollständig in die Zeile passen.
  • Die Einheit wird im minimierten Zustand weggelassen.
  • Jeder Messwert erhält unabhängig von seinem Inhalt den gleichen horizontalen Platz.

Als Live-Update

Wenn eine Benachrichtigung im Stil eines Messwerts zu einem Live-Update hochgestuft wird, sind die folgenden Aspekte zu berücksichtigen:

  • Sie müssen Notification.Builder#setContentTitle nicht angeben, da stattdessen der Messwert verwendet wird. Wenn kein Titel angegeben ist, wird der App-Name angezeigt.
  • Wenn Notification.Builder#setSubtext angegeben ist, wird es in der Kopfzeile angezeigt und nicht wie bei anderen hervorgehobenen Stilen in eine neue Zeile verschoben.
  • Aktionsschaltflächen haben dieselbe pillenförmige Darstellung.

Wichtige Punkte zum Code

Siehe auch