Crea una notificación con estilo de métrica

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

Ejemplo de temporizador con MetricStyle
Figura 1: Una plantilla de notificación de MetricStyle y una actualización en vivo 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.
    • El aspecto 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 vivo, predeterminada/expandida y predeterminada/contraída.

Comportamiento

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

  • Las unidades métricas se agregan a la etiqueta en el estado expandido.
  • La segunda línea del estado contraído 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 actualización en vivo

Cuando una notificación de estilo de métrica se promueve a una actualización en vivo, ten en cuenta las siguientes consideraciones:

  • No es necesario proporcionar Notification.Builder#setContentTitle porque se usa el valor de la métrica. Si no se proporciona un 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 pasar 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