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.
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.Metricwymaga etykiety, wartości i opcjonalnej jednostki. - Wygląd rozwiniętego układu różni się w zależności od liczby uwzględnionych danych.
- Każdy element
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
- Poniżej znajdziesz listę odpowiednich klas i dokumentację referencyjną:
Notification.MetricStyleNotification.MetricStyle.setCriticalMetric(int)Notification.MetricNotification.Metric.FixedDateNotification.Metric.FixedFloatNotification.Metric.FixedIntNotification.Metric.FixedTextNotification.Metric.FixedTimeNotification.Metric.MetricValueNotification.Metric.TimeDifference
Zobacz też
- Dokumentacja interfejsu Notification.MetricStyle API
- Dokumentacja interfejsu Notification.Metric API
- Dokumentacja interfejsu Notification.Action API