Notificaciones y widgets de conversación

Android 11 agregó compatibilidad para personalizar el comportamiento y la posición de las notificaciones de conversación en el panel de notificaciones por prioridad y nivel de alerta, lo que permite que las conversaciones se marquen como importantes y que las burbujas específicas de conversaciones se inicien en el espacio de conversación.

A partir de estas funciones de Android 11, Android 12 ofrece dos nuevas funciones de conversación:

• La función Conversaciones recientes en Configuración permite que los usuarios personalicen el comportamiento de las notificaciones para las conversaciones recientes sin esperar a recibir una notificación.

• La función de widget de conversación permite a los usuarios abrir chats fácilmente en la pantalla principal, lo que les brinda una vista rápida de las conversaciones recientes.

En este documento, se describen los aspectos de implementación, personalización y validación de las notificaciones y los widgets de conversación.

Descripción general de las notificaciones de conversaciones

Android 11 presenta una nueva primitiva del sistema, la conversación, que se representa con el objeto de acceso directo para compartir existente (que se lanzó con Android 9).

El elemento Conversation se puede usar de la siguiente manera:

• Compartir datos de Conversaciones entre las apps del sistema a través de la hoja para compartir (ya disponible en Android 10)

• Para conducir burbujas(accesos directos en Android 11) Consulta la Figura 1.

• Participar en el nuevo espacio de conversación en la parte superior del panel de notificaciones (implementado en Android 11) Consulta la Figura 2.

• Para crear widgets de conversación (implementados en Android 12)

  

  Figura 1: La notificación se inicia en forma de burbuja desde el panel lateral de notificaciones

  

  Figura 2: Espacio de conversación ubicado en la parte superior de la pantalla de notificaciones

Además de vincularse al acceso directo que representa la conversación, la notificación también usa MessagingStyle para incluir el último mensaje de la conversación en el espacio de conversación.

Los socios de GMS deben implementar lo siguiente:

• Un nuevo espacio de Conversaciones como una sección separada en la parte superior del panel de notificaciones
• Es un estilo de notificación que permite y admite el patrón de burbuja específico de la conversación.

Los socios que implementan Conversations también deben implementar Important conversations. Sin embargo, la implementación de Conversations se puede alinear con los conceptos del OEM de naturaleza similar. En general, los socios tienen la libertad de alinear la sección de conversación con su IU del sistema específica. El socio no tiene que modificar ni implementar extensiones, código de HAL, controladores o kernel.

Consulta la siguiente implementación de referencia en las secciones SystemUI y PeopleService del AOSP:

frameworks/base/packages/SystemUI/src/com/android/systemui/people/
frameworks/base/core/java/android/app/people/
frameworks/base/services/people/java/com/android/server/people/

Validación

Para asegurarte de que tu versión de la función funcione según lo previsto, verifica lo siguiente:

1. Las apps que admiten por completo la API de Conversation ven sus notificaciones en la nueva sección y pueden personalizarlas por conversación en lugar de por el NotificationChannel genérico.

2. Las burbujas específicas de la conversación funcionan.

Para validar la implementación, usa las siguientes pruebas en el paquete de notificaciones:

• Pruebas de CTS

  cts/tests/app/src/android/app/cts/NotificationManagerTest.java
  

• Pruebas del verificador de CTS

  cts/apps/CtsVerifier/src/com/android/cts/verifier/notifications/
  
  

Descripción general de los widgets de conversación

En Android 12, la función Widget de conversación se basa en las representaciones de conversación creadas en Android 11 (como se describe en la sección anterior) al permitir que las apps proporcionen el estado de las conversaciones que se muestran en los widgets de conversación.

Figura 3: Se muestran conversaciones en los widgets de conversación

La función Widget de conversación de Android 12 promueve la conexión, ya que permite a los usuarios abrir chats fácilmente en la pantalla principal. Los widgets son accesos directos mejorados que permiten a los usuarios volver a sus conversaciones de forma eficiente y, al mismo tiempo, mostrar fragmentos de los estados de las conversaciones.

El socio debe implementar lo siguiente:

1. Es un widget proporcionado por SystemUI.
2. Un flujo para agregar estos widgets desde la pantalla de selección de widgets
3. Se agregó compatibilidad para cambiar el tamaño de los widgets de la siguiente manera:
   • Usa onAppWidgetOptionsChanged() para cambiar el diseño a uno de mejor tamaño cuando el usuario cambie el tamaño del diseño o rote el dispositivo al modo de paisaje.
   • Usa maxResizeHeight, maxResizeWidth, minWidth, minHeight, minResizeWidth y minResizeHeight para delimitar correctamente los cambios de tamaño de tu widget.

Ten en cuenta las siguientes dependencias cuando implementes widgets de conversación:

• El socio no tiene que modificar ni implementar código de HAL, controlador o kernel.
• Para la implementación, se usa la API de Status, que permite que las apps agreguen información de estado o disponibilidad a una conversación y al widget asociado.
• El proceso es el mismo tanto en las implementaciones de dispositivos nuevos como en las de actualización.
• La función Widgets de conversación depende de una nueva función que se lanza en Android 12, que almacena en caché las conversaciones vistas recientemente (por ejemplo, desde notificaciones). Esta última función permite expandir la lista de conversaciones que un usuario podría agregar a su pantalla principal.

Consulta la siguiente implementación de referencia en los archivos SystemUI y Launcher3:

frameworks/base/packages/SystemUI/src/com/android/systemui/people/
frameworks/base/core/java/android/app/people/
frameworks/base/services/people/java/com/android/server/people/

Personalización

La función de widgets de conversación no se puede activar ni desactivar. Sin embargo, un socio puede cambiar los diseños de las plantillas de widgets, siempre y cuando se cumplan los requisitos de los GMS.

Validación

Para asegurarte de que tu versión de la función funcione según lo previsto, verifica lo siguiente:

1. Si mantienes presionado el Selector, puedes agregar un nuevo widget de conversación para una conversación a través del selector de widgets. Consulta la figura 4 para ver la IU del selector de widgets:

   

   Figura 4: IU del selector de widgets para agregar un widget de conversación nuevo

2. Cuando se envían notificaciones al dispositivo desde la conversación seleccionada, el widget se actualiza para reflejar esas notificaciones.

3. Cuando se aplican estados a esa conversación con la API de ConversationStatus, el widget refleja esos estados.

4. Los usuarios pueden cambiar el tamaño de los widgets, y estos pueden cambiar de tamaño según el Launcher actual. Los diseños de tus widgets deben funcionar bien con diferentes tamaños del Selector en diferentes dispositivos y al cambiar el tamaño del widget.

Para validar la implementación, usa las siguientes pruebas en el paquete de notificaciones:

• Pruebas de CTS (PeopleManagerTest) para las APIs expuestas.

  cts/tests/app/src/android/app/cts/NotificationManagerTest.java
  

• Pruebas manuales para el requisito de GMS: Conversaciones.