Cómo crear una notificación de actualización en vivo

El sistema promociona las notificaciones de Novedades en tiempo real. Las notificaciones promocionadas aparecen de forma más destacada en las plataformas del sistema, como en la parte superior del panel lateral de notificaciones y la pantalla de bloqueo, y como un chip en la barra de estado.

Figura 1: Ejemplo de una notificación de actualización en vivo.

Las tarjetas de notificaciones promocionadas tienen las siguientes características de apariencia:

  • Expandido de forma predeterminada
  • No contraíble

Tu notificación debe cumplir con los siguientes requisitos para calificar como actualización en vivo:

  • Debe ser estándar/sin estilo, BigTextStyle, CallStyle o ProgressStyle.
  • Debes solicitar el siguiente permiso que no es de tiempo de ejecución en el manifiesto de Android android.permission.POST_PROMOTED_NOTIFICATIONS.
  • Debes solicitar el ascenso con EXTRA_REQUEST_PROMOTED_ONGOING o NotificationCompat.Builder#requestPromotedOngoing.
  • Debe ser ongoing (configura FLAG_ONGOING_EVENT).
  • Debe tener un contentTitle establecido.
  • NO debe tener ningún customContentView establecido (no RemoteViews).
  • NO debe ser el resumen de un grupo que usa setGroupSummary.
  • El canal de notificaciones NO debe tener IMPORTANCE_MIN.

Características de las promociones

Las siguientes APIs te ayudan a determinar si el sistema promocionará tu notificación:

  • Notification.FLAG_PROMOTED_ONGOING indica si la notificación se promociona.
  • Notification.hasPromotableCharacteristics() valida si el sistema puede ascender el nivel de la notificación. Este método no considera si el usuario inhabilitó las actualizaciones en vivo para la app en la configuración.
  • NotificationManager.canPostPromotedNotifications() verifica si tu app puede publicar una notificación promocionada, por ejemplo, si el usuario la habilitó o inhabilitó en la configuración.
  • Settings.ACTION_MANAGE_APP_PROMOTED_NOTIFICATIONS es la acción de intent que permite que las apps envíen a los usuarios a Configuración para habilitar esta función.

Criterios de uso

Usa las actualizaciones en vivo para las actividades en curso, que inicia el usuario y que son urgentes.

Continuo

Una actualización en vivo debe representar una actividad que esté en curso de forma activa, con un inicio y un final distintos. Si una actividad ocurre en el pasado, no uses una actualización en vivo. En su lugar, usa una notificación estándar. Esto también se aplica a los eventos que aún no comenzaron, aunque los eventos que están por comenzar pueden usar una actualización en vivo.

Las actualizaciones en tiempo real representan actividades en curso. No uses las actualizaciones en vivo para ofrecer acceso acelerado a la funcionalidad de la app. Si quieres hacerlo, usa un widget de la app o una tarjeta de Configuración rápida personalizada.

  • Usos adecuados: Navegación activa, llamadas telefónicas en curso, seguimiento activo de viajes compartidos y seguimiento activo de entrega de alimentos.
  • Usos inapropiados: Anuncios, promociones, mensajes de chat, alertas, eventos de calendario próximos y acceso rápido a las funciones de la app.

Iniciado por el usuario

La mayoría de las actualizaciones en vivo deben representar actividades que el usuario activa de forma explícita, como iniciar un entrenamiento, iniciar la navegación para conducir o solicitar un viaje compartido. No muestres información ambiental, como la que se refiere al entorno, los intereses o los próximos eventos del usuario, en una actualización en vivo. No permitas que las actividades activadas por otras partes generen actualizaciones en vivo.

A veces, un usuario puede realizar una acción que inicia una actividad en algún momento en el futuro. Por ejemplo, si el usuario compra boletos para un vuelo o un concierto, se registra en un torneo o indica de otra manera su asistencia futura a un evento con límite de tiempo. En estos casos, puede ser apropiado mostrar automáticamente una actualización en vivo cuando comience el evento programado. Sin embargo, las apps deben ajustar sus activadores para que solo aparezcan cuando la actividad sea inminente. Si el usuario indica de forma explícita que desea comenzar a supervisar un evento en segundo plano, como un partido deportivo, puedes comenzar a publicar actualizaciones en vivo para ese evento. Sin embargo, también debes incluir una acción para desfijar en la notificación asociada.

Urgente

Muestra una actualización en vivo solo si requiere la atención del usuario durante la actividad. Un caso de uso clave para las actualizaciones en vivo es la supervisión, cuando el usuario obtiene un beneficio significativo de mirar la actualización en vivo para vigilar el estado en evolución de la actividad.

A menudo, una actualización en vivo es apropiada para actividades que realizan la transición entre actualizaciones en vivo y notificaciones normales. Por ejemplo, mostrar una notificación de tarjeta de embarque es apropiado muchas horas antes del vuelo de un usuario, pero la notificación debe convertirse en una actualización en vivo solo cuando el usuario tenga una necesidad urgente, como cuando llega al aeropuerto o al lugar, o una vez que comienza el embarque. Por el contrario, una actualización en vivo no es adecuada para hacer un seguimiento de un paquete, ya que el usuario no necesita supervisarlo constantemente.

Chips de estado

Los chips de estado permiten a los usuarios hacer un seguimiento de las Novedades en tiempo real cuando la notificación no está a la vista. Usa setShortCriticalText o setWhen para transmitir información de estado importante sobre tu notificación centrada en el progreso.

chip de estado con ícono
Figura 2: El estado indeterminado muestra el ícono pequeño Notification.Builder#setSmallIcon.
chip de estado con la hora
Figura 3: Usa Notification.Builder#setShortCriticalText para mostrar la hora absoluta.
chip de estado con información
Figura 4: Usa Notification.Builder#setShortCriticalText para transmitir información importante.

Cuando sea la hora

El tiempo de when activa una cuenta regresiva para la duración de la notificación, a menos que se descarte o se actualice.

  • La hora de cuándo es, al menos, 2 minutos en el futuro: si la hora actual es 10:05 a.m. y la hora de cuándo está configurada en 10:10 a.m., el chip dirá "5min".
  • Si el tiempo de "cuándo" es superior a 1 minuto, no se muestra la notificación.
  • Usa setShowWhen para FALSE si no quieres que la notificación que se muestra en la sombra tenga una hora.

Aspecto del chip de estado

El chip de estado siempre incluye un ícono y, de manera opcional, texto. El chip tiene un ancho máximo de 96 dp. Muestra el texto según los siguientes criterios:

  • Si tiene menos de 7 caracteres, muestra todo el texto.
  • Si se mostrará menos de la mitad del texto, muestra solo el ícono.
  • Si se mostrará más de la mitad del texto, muestra la mayor cantidad posible.

Dismissal

Los usuarios pueden controlar la visibilidad de las notificaciones en la barra de notificaciones. Publicar novedades en tiempo real no deseadas podría provocar que los usuarios revoquen el permiso de publicación de una app.

Para evitar que los usuarios inhabiliten por completo las Novedades en tiempo real, evita publicar actualizaciones que los usuarios puedan descartar. No vuelvas a publicar las Novedades en tiempo real que el usuario descartó. Usa setDeleteIntent para detectar las actualizaciones rechazadas.