Tworzenie powiadomienia o stylu wskaźnika

Android 17 wprowadza szablon powiadomień MetricStyle, który obsługuje aplikacje związane ze zdrowiem i aktywnością fizyczną, timery i aplikacje podróżnicze.

Przykład timera z użyciem stylu MetricStyle
Rysunek 1. Szablon powiadomienia MetricStyle i aktualizacja na żywo w przypadku aplikacji zegara

Uprawnienia

Powiadomienia o stylu danych mają te funkcje:

  • Obsługuje metodę setContentTitle.
  • Nie wyświetla tekstu kontekstowego.
  • Obsługuje maksymalnie 3 przyciski działań.
  • Obsługuje pomiar maksymalnie 3 rodzajów danych.
    • Każda Notification.Metric wymaga etykiety, wartości i opcjonalnej jednostki.
    • Wygląd rozwiniętego układu zależy od liczby zebranych danych.
Szablon MetricStyle w różnych stanach
Ilustracja 2. Przykłady szablonu MetricStyle w różnych stanach. Od lewej do prawej: zawsze aktywny wyświetlacz (AOD) promowany jako aktualizacja na żywo, domyślny/rozwinięty i domyślny/zwinięty.

Działanie

Powiadomienie w stylu danych zmienia swoje działanie w zależności od stanu:

  • Jednostki metryczne są dołączane do etykiety w stanie rozwiniętym.
  • W drugim wierszu stanu zwiniętego wyświetlana jest zawartość danych połączona w jeden wiersz. Drugi i trzeci wskaźnik pojawiają się tylko wtedy, gdy po połączeniu w całości mieszczą się w polu.
  • W stanie zwiniętym jednostka jest pomijana.
  • Każdy rodzaj danych zajmuje tyle samo miejsca w poziomie, niezależnie od jego zawartości.

jako aktualizacja na żywo.

Gdy powiadomienie o stylu danych jest promowane do aktualizacji na żywo, pamiętaj o tych kwestiach:

  • Nie musisz podawać wartości Notification.Builder#setContentTitle, ponieważ zamiast niej używana jest wartość danych. Jeśli nie podano tytułu, wyświetlana jest nazwa aplikacji.
  • Jeśli podano wartość Notification.Builder#setSubtext, jest ona wyświetlana w wierszu nagłówka, a nie przenoszona do nowego wiersza, jak w przypadku innych stylów promowanych.
  • Przyciski działania mają ten sam wygląd pigułki.

Najważniejsze informacje o kodzie

Zobacz również