Crea una notificación centrada en el progreso

Notificación centrada en el progreso de la parte superior de la persiana
Figura 1. Una notificación centrada en el progreso en la parte superior del panel.

Android 16 presenta una nueva plantilla de notificación para ayudar a los usuarios a hacer un seguimiento sin problemas de los recorridos de extremo a extremo que inician. Estas notificaciones tienen una visibilidad mejorada en las superficies del sistema y una clasificación superior en el panel lateral de notificaciones.

Usa Notification.ProgressStyle para estilizar las notificaciones centradas en el progreso. Entre los casos de uso clave, se incluyen el uso compartido de viajes, la entrega y la navegación. Dentro de esa clase, puedes indicar estados y etapas importantes en un recorrido del usuario con puntos y segmentos.

Clases pertinentes

Las siguientes clases contienen las diferentes APIs que usas para construir una notificación ProgressStyle:

Anatomía y personalización

En las siguientes imágenes, se muestran las diferentes partes que componen las notificaciones ProgressStyle:

Figura 2.

A. Encabezado: Subtexto

Notification.Builder#setSubText()

B. Encabezado: Hora

Notification.Builder#setWhen()

C. Título del contenido

Notification.Builder#setContentTitle()

D. Texto del contenido

Notification.Builder#setContentText()

E. Barra de progreso

Notification.ProgressStyle

F. Botón de acción

Notification.Builder#addAction()
Figura 3. Las apps pueden establecer una imagen del vehículo para el ícono de la herramienta de seguimiento y usar segmentos y puntos para indicar la experiencia de uso compartido de viajes y las etapas importantes.

Prácticas recomendadas

Usa las APIs adecuadas y sigue las prácticas recomendadas para proporcionar la mejor experiencia del usuario para las actualizaciones de progreso.

  • Establece los campos correctos para cumplir con la visibilidad promocionada en el panel lateral de notificaciones.
  • Usa los elementos visuales adecuados para guiar a los usuarios. Por ejemplo, las apps de uso compartido de viajes deben establecer una imagen del vehículo y usar el color más preciso del vehículo en la notificación con Notification#setLargeIcon.
  • Usa un lenguaje claro y conciso para definir el progreso del recorrido del usuario. La hora de llegada, el nombre del conductor y el estado del viaje son textos importantes que la notificación debe comunicar.
  • Proporciona acciones útiles y pertinentes en la notificación que optimicen el recorrido del usuario. Por ejemplo, proporcionar "Dar propina" y "Agregar plato" a un pedido de comida a domicilio recién iniciado son acciones útiles antes de la entrega.
  • Usa segmentos y puntos para indicar estados. Por ejemplo, los segmentos pueden colorear el estado y la duración del tráfico en un viaje de uso compartido. Los puntos representan estados para etapas importantes, como la preparación de alimentos, la entrega y la recogida de pasajeros.
  • Actualiza la experiencia de progreso para reflejar con precisión el progreso real del viaje. Por ejemplo, los cambios en las condiciones del tráfico se pueden reflejar en los cambios en los colores de los segmentos y las actualizaciones en el texto.

En el siguiente fragmento de código, se muestra cómo se podría usar una notificación ProgressStyle para un contexto de uso compartido de viajes:

var ps =
    Notification.ProgressStyle()
        .setStyledByProgress(false)
        .setProgress(456)
        .setProgressTrackerIcon(Icon.createWithResource(appContext, R.drawable.ic_car_red))
        .setProgressSegments(
            listOf(
                Notification.ProgressStyle.Segment(41).setColor(Color.BLACK),
                Notification.ProgressStyle.Segment(552).setColor(Color.YELLOW),
                Notification.ProgressStyle.Segment(253).setColor(Color.WHITE),
                Notification.ProgressStyle.Segment(94).setColor(Color.BLUE)
            )
        )
        .setProgressPoints(
            listOf(
                Notification.ProgressStyle.Point(60).setColor(Color.RED),
                Notification.ProgressStyle.Point(560).setColor(Color.GREEN)
            )
        )

Consulta la app de ejemplo para experimentar con estas APIs.