Notificaciones de conversación y widgets

Android 11 agrega soporte para personalizar el comportamiento y la ubicación de las notificaciones de conversación en el tono Notificaciones por prioridad y nivel de alerta, lo que permite que las conversaciones se marquen como importantes y que se lancen burbujas específicas de conversación en el espacio de conversación.

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

  • La función Conversaciones recientes en Configuración permite a los usuarios personalizar el comportamiento de notificación para 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 de inicio, lo que brinda una vista rápida de las conversaciones recientes.

Este documento describe los aspectos de implementación, personalización y validación de las notificaciones de conversación y los widgets.

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 para compartir existente (que se implementó con Android 9).

La primitiva Conversaciones se puede utilizar de la siguiente manera:

  • Para compartir datos de conversaciones entre las aplicaciones en todo el sistema a través de Sharesheet (ya en Android 10).

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

  • Para participar en el nuevo espacio de conversación además del tono de notificación (implementado en Android 11). Ver Figura 2 .

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

    conv_bubbles

    Figura 1: Notificación que se lanza como una burbuja desde el cajón de notificaciones

    conv_notification

    Figura 2: espacio de conversación ubicado en la parte superior de la pantalla de notificación

Además de vincularse al atajo que representa la conversación, la notificación también usa MessagingStyle para incluir el último mensaje de la conversación en el espacio 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 tono de Notificación.
  • Un estilo de notificación que permite y admite el patrón de burbuja específico de conversación.

Los socios que implementan Conversaciones también deben implementar Conversaciones importantes. Sin embargo, la implementación de Conversaciones se puede alinear con conceptos OEM de naturaleza similar. En general, los socios tienen la libertad de alinear la sección de conversación con la interfaz de usuario de su sistema específico. El socio no tiene que modificar o implementar HAL/controlador/código de kernel/extensiones.

Consulte 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 asegurarse de que su versión de la función funcione según lo previsto, verifique lo siguiente:

  1. Las aplicaciones que admiten completamente la API de conversación 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 conversación están funcionando.

Para validar la implementación, use las siguientes pruebas en el paquete de notificación:

  • pruebas CTS.

    cts/tests/app/src/android/app/cts/NotificationManagerTest.java
    
  • Pruebas del Verificador 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 aplicaciones proporcionen el estado de esas conversaciones que se muestran en Widgets de conversación.

conv_widgets

Figura 3: Conversaciones mostradas en Conversation Widgets

La función Widget de conversación en Android 12 promueve la conexión al permitir que los usuarios abran chats fácilmente en la pantalla de inicio. Los widgets son accesos directos mejorados que permiten a los usuarios volver a sus conversaciones de manera eficiente mientras muestran fragmentos de los estados de la conversación.

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 de widgets de la siguiente manera:

Tenga en cuenta las siguientes dependencias al implementar widgets de conversación:

  • El socio no tiene que modificar o implementar el código HAL/driver/kernel.
  • La API de estado, que permite que las aplicaciones 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 tanto en las implementaciones de nuevos dispositivos como en la implementación de actualizaciones.
  • 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 (de notificaciones, por ejemplo). Esta última función permite ampliar la lista de conversaciones que un usuario podría agregar potencialmente a su pantalla de inicio.

Consulte 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 o 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 asegurarse de que su versión de la función funcione según lo previsto, verifique lo siguiente:

  1. Al mantener presionado el Lanzador, se puede agregar un nuevo widget de conversación para una conversación a través del selector de widgets. Consulte la figura 4 para ver la interfaz de usuario del selector de widgets:

    widget_picker

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

  2. Al enviar notificaciones al dispositivo desde la conversación seleccionada, el widget se actualiza para reflejar esas notificaciones.

  3. Al aplicar estados a esa conversación usando la API ConversationStatus , el widget refleja esos estados.

  4. Los usuarios pueden cambiar el tamaño de los widgets y los widgets pueden cambiar sus tamaños en función de su Iniciador actual. Los diseños de sus widgets deben funcionar bien con diferentes tamaños de Launcher en diferentes dispositivos y al cambiar el tamaño del widget.

Para validar la implementación, use las siguientes pruebas en el paquete de notificación:

  • Pruebas CTS (PeopleManagerTest) para las superficies API.

    cts/tests/app/src/android/app/cts/NotificationManagerTest.java
    
  • Pruebas manuales para requerimiento GMS - Conversaciones.