Notificaciones y widgets de conversación

Android 11 agrega 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.

Sobre la base de estas funciones de Android 11, Android 12 ofrece dos funciones nuevas de conversación:

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

• La función Widget de conversación permite a los usuarios abrir chats fácilmente en la pantalla principal, lo que 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 conversación

Android 11 presenta una nueva primitiva del sistema, la conversación, que está representada por el objeto de acceso directo de uso compartido existente (que se lanzó con Android 9).

La primitiva de conversaciones se puede usar de la siguiente manera:

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

• Para controlar burbujas(accesos directos en Android 11) (consulta la Figura 1)

• Para 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 del panel 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
• Un estilo de notificación que permite y admite el patrón de burbuja específico de la conversación

Los socios que implementan conversaciones también deben implementar conversaciones importantes. Sin embargo, la implementación de conversaciones se puede alinear con los conceptos de 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 HAL/controlador/código/extensiones del kernel.

Consulta la siguiente implementación de referencia en las secciones SystemUI y PeopleService en 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 personalizar esas notificaciones 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 esas 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 en 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. Un widget proporcionado por SystemUI
2. Un flujo para agregar estos widgets desde la pantalla de selección de widgets
3. Compatibilidad con el cambio de tamaño del widget de la siguiente manera:
   • Usa onAppWidgetOptionsChanged() para cambiar el diseño a un diseño de mejor tamaño cuando el usuario cambia el tamaño del diseño o rota al modo horizontal.
   • Usa maxResizeHeight, maxResizeWidth, minWidth, minHeight, minResizeWidth y minResizeHeight para delimitar correctamente los cambios de tamaño del widget.

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

• El socio no tiene que modificar ni implementar HAL/controlador/código del kernel.
• La API de Status, que permite que las apps agreguen información de estado o disponibilidad a una conversación y al widget asociado, se usa para la implementación.
• El proceso es el mismo en las implementaciones de dispositivos nuevos y en las implementaciones de actualización.
• La función Widgets de conversación tiene una dependencia 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 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 que se cumplan los requisitos de 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, se puede 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 ConversationStatus API, el widget refleja esos estados.

4. Los usuarios pueden cambiar el tamaño de los widgets, y estos pueden cambiar sus tamaños según su selector actual. Los diseños de tus widgets deben funcionar bien con diferentes tamaños de selector en diferentes dispositivos y cuando se cambia 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 superficies de la API

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

• Pruebas manuales para el requisito de GMS: Conversaciones