Crea una notificación con estilo de métrica

Android 17 presenta la plantilla de notificaciones MetricStyle para admitir apps de salud y fitness, temporizadores y casos de uso de apps de viajes.

Ejemplo de temporizador con MetricStyle
Figura 1: Una plantilla de notificación de MetricStyle y novedades en tiempo real para una app de reloj

Funciones

Las notificaciones de estilo de métrica tienen las siguientes capacidades:

  • Admite el uso del método setContentTitle.
  • No muestra el texto de contexto.
  • Admite hasta 3 botones de acción.
  • Admite la medición de hasta 3 métricas.
    • Cada Notification.Metric requiere una etiqueta, un valor y una unidad opcional.
    • La apariencia del diseño expandido varía según la cantidad de métricas que se toman.
La plantilla MetricStyle en varios estados
Figura 2: Ejemplos de la plantilla MetricStyle en varios estados. De izquierda a derecha, pantalla siempre activa (AOD), promocionada como una actualización en tiempo real, predeterminada/expandida y predeterminada/contraída.

Comportamiento

La notificación de estilo de métrica cambia de comportamiento según su estado:

  • Las unidades de métricas se agregan a la etiqueta en el estado expandido.
  • En la segunda línea del estado contraído, se muestra el contenido de las métricas concatenado en una sola línea. La segunda y la tercera métrica solo aparecen si caben por completo cuando se concatenan.
  • La unidad se omite en el estado contraído.
  • Cada métrica recibe el mismo espacio horizontal, independientemente de su contenido.

Como una actualización en tiempo real

Cuando una notificación de estilo de métrica se promociona a novedades en tiempo real, ten en cuenta las siguientes consideraciones:

  • No es necesario proporcionar Notification.Builder#setContentTitle porque, en su lugar, se usa el valor de la métrica. Si no se proporciona ningún título, se muestra el nombre de la app.
  • Si se proporciona Notification.Builder#setSubtext, se muestra en la línea del encabezado, en lugar de moverse a una línea nueva, como en otros estilos promocionados.
  • Los botones de acción tienen el mismo tratamiento visual de píldora.

Puntos clave sobre el código

Consulta también