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 aplikacji zegara

Uprawnienia

Powiadomienia o stylu danych mają te możliwości:

  • 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świetlają się połączone w jeden wiersz treści danych. Drugi i trzeci wskaźnik pojawiają się tylko wtedy, gdy po połączeniu mieszczą się w całości.
  • W stanie zwiniętym jednostka jest pomijana.
  • Każdy rodzaj danych zajmuje taką samą przestrzeń 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 podasz wartość Notification.Builder#setSubtext, zostanie ona wyświetlona w wierszu nagłówka, a nie przeniesiona do nowego wiersza, jak w przypadku innych stylów promowanych.
  • Przyciski działania mają ten sam wygląd.

Najważniejsze informacje o kodzie

Zobacz również