Tworzenie powiadomienia o stylu wskaźnika

Android 17 wprowadza szablon powiadomień MetricStyle, który obsługuje przypadki użycia aplikacji do treningu i dbania o zdrowie, minutników i aplikacji podróżniczych.

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

Uprawnienia

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

  • Obsługuje metodę setContentTitle.
  • Nie wyświetla tekstu kontekstowego.
  • Obsługuje maksymalnie 3 przyciski działania.
  • Obsługuje pomiar maksymalnie 3 rodzajów danych.
    • Każdy element Notification.Metric wymaga etykiety, wartości i opcjonalnej jednostki.
    • Wygląd rozwiniętego układu różni się w zależności od liczby uwzględnionych 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.

Zachowanie

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

  • Jednostki miary 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 mieszczą się w całości.
  • W stanie zwiniętym jednostka jest pomijana.
  • Każdy wskaźnik otrzymuje taką samą przestrzeń poziomą, niezależnie od zawartości.

Jako aktualizacja na żywo

Gdy powiadomienie w stylu danych zostanie przekształcone w aktualizację na żywo, pamiętaj o tych kwestiach:

  • Nie musisz podawać parametru Notification.Builder#setContentTitle, ponieważ zamiast niego używana jest wartość danych. Jeśli nie podano tytułu, wyświetlana jest nazwa aplikacji.
  • Jeśli podano Notification.Builder#setSubtext, jest on wyświetlany w wierszu nagłówka, a nie przenoszony do nowego wiersza, jak w przypadku innych promowanych stylów.
  • Przyciski poleceń mają taki sam wygląd jak przyciski w kształcie pigułki.

Najważniejsze informacje o kodzie

Zobacz też