Создайте уведомление в стиле метрики.

В Android 17 представлен шаблон уведомлений MetricStyle , поддерживающий приложения для здоровья и фитнеса, таймеры и приложения для путешествий.

Пример использования таймера с помощью MetricStyle.
Рисунок 1: Шаблон уведомления MetricStyle и функция Live Update для приложения «Часы».

Возможности

Уведомления в виде метрик обладают следующими возможностями:

  • Поддерживается использование метода setContentTitle .
  • Контекстный текст не отображается.
  • Поддерживает до 3 кнопок действий .
  • Поддерживает измерение до 3 показателей.
    • Для каждого Notification.Metric требуется указать метку, значение и, при желании, единицу измерения.
    • Внешний вид расширенного макета зависит от количества используемых метрик.
Шаблон MetricStyle в различных состояниях
Рисунок 2: Примеры шаблона MetricStyle в различных состояниях. Слева направо: постоянно включенный экран (AOD), режим обновления в реальном времени, состояние по умолчанию/развернутое и состояние по умолчанию/свернутое.

Поведение

Стиль уведомления, отображаемый в виде метрики, изменяет свое поведение в зависимости от своего состояния:

  • Метрические единицы добавляются к метке в развернутом виде.
  • Во второй строке свернутого состояния содержимое метрик объединено в одну строку. Вторая и третья метрики отображаются только в том случае, если они полностью помещаются в свернутом виде.
  • В сложенном состоянии этот элемент отсутствует.
  • Каждому показателю отводится равное горизонтальное пространство, независимо от его содержания.

Обновление в режиме реального времени

При преобразовании уведомления в формате метрики в уведомление в режиме реального времени следует учитывать следующие моменты:

  • Нет необходимости указывать Notification.Builder#setContentTitle , поскольку вместо него используется значение метрики. Если заголовок не указан, отображается название приложения.
  • Если указан параметр Notification.Builder#setSubtext , он отображается в строке заголовка, а не переносится на новую строку, как для других продвигаемых стилей.
  • Кнопки действий имеют такое же визуальное оформление в виде таблеток.

Основные моменты, касающиеся кода.

См. также