Lineamientos de la IU de Health Connect

La interfaz de usuario (IU) de tu app debería enfocarse en detallar los beneficios de usar Health Connect y explicar los conceptos clave de una manera que mejore el conocimiento de los usuarios sobre lo que implica una integración.

La experiencia del usuario (UX) debe cumplir con tres principios esenciales:

  1. Coherencia: Asegúrate de que los flujos estén alineados en todo el proceso de integración.
  2. Transparencia: Explica de forma directa cómo funciona Health Connect junto con tu app.
  3. Claridad: Ayuda a los usuarios a acceder a Health Connect a través de tu app.

A grandes rasgos, el flujo de UX se puede dividir en las siguientes etapas:

Flujo de UX de Health Connect

Promover Health Connect

La forma de mostrar Health Connect en tu app depende de los patrones y las convenciones de UX establecidos en tu IU.

Enfócate en el beneficio del usuario

La primera vez que les presentas Health Connect a los usuarios, debes tratar de ofrecer un motivo significativo para que usen tu integración.

En lugar de describir las funciones de Health Connect, adapta tu mensaje a cómo se beneficia un usuario con esas funciones.

Beneficios para los usuarios de Health Connect

Usa un lenguaje claro

No solicites a los usuarios "Conéctate a Health Connect". Esta es una oración molesta y también puede confundir al usuario sobre la relación entre las apps en el ecosistema de Health Connect.

Tu UX debe ayudar a los usuarios a imaginarse el modo en que Health Connect interactúa con tu app, por lo que es importante considerar las etiquetas de los botones que funcionan mejor para lograr ese objetivo.

Intenta utilizar frases verbales como "configurar" o "comenzar" en las etiquetas de tus botones. O bien, si inicias la vista de permisos, usa un texto de botón más específico, como "Elige los datos para compartir".

Lenguaje claro de Health Connect

Promover Health Connect

A continuación, se incluyen algunas formas en las que puedes promocionar Health Connect en tu app:

Flujo de configuración de la app y solicitud de permisos

Configuración de la app y solicitud de permisos

Flujo de la tarjeta promocional de la pantalla principal

Flujo de promoción de la pantalla principal

Configuración

Configuración con punto de entrada

Descarga del APK de Android 13

Descarga del APK de Android 13

Incorporación de nuevos tipos de datos y solicitud de permisos

Las apps que ya tienen una integración con Health Connect pueden solicitar nuevos tipos de datos además de los que ya se otorgaron.

En la pantalla de permisos, solo se deben mostrar los tipos de datos nuevos solicitados para evitar confundir a los usuarios.

A continuación, se incluyen algunos ejemplos de cómo promocionar los tipos de datos nuevos:

Reutiliza las convenciones existentes

Si tu app ya promociona datos nuevos en otros ecosistemas, te recomendamos que hagas lo mismo para Health Connect en Android y que adaptes el lenguaje cuando sea pertinente.

Enfatiza la propuesta de valor

¿Por qué los usuarios querrían usar estos datos en tu app?

  • Ejemplos: Lectura de los datos
    • Proporciona estadísticas más precisas a los usuarios en tu app
    • Los usuarios pueden ver todos los datos en un solo lugar en tu app
  • Ejemplo: Escritura de los datos
    • Los usuarios pueden compartir estos datos nuevos de tu app con otras apps de salud y actividad física compatibles en su teléfono.

Contextualiza los permisos

Solicita permisos nuevos cuando tenga sentido para los usuarios, de modo que sepan qué se les pide.

Ejemplos:

  • Solicita permiso para acceder a las rutas de ejercicio después de que los usuarios terminen un entrenamiento en tu app.
  • Si tu app implementa permisos nuevos, muéstralos juntos en una sola promoción en la pantalla principal.
  • Si tienes una sección dedicada en tu app, por ejemplo, Sueño, promociona el permiso correspondiente allí.

Solicita un nuevo tipo de datos

Permisos revocados y cancelados

En la pantalla Configuración de tu app, se debe mostrar a los usuarios cómo revocar permisos relacionados con los tipos de datos de Health Connect:

Permisos revocados y cancelados

Acceso insuficiente

Si tu app no tiene suficiente acceso a Health Connect, se debe mostrar la siguiente pantalla a los usuarios en todos los puntos de entrada:

App con acceso insuficiente

Se cancelaron los permisos dos veces

Si el usuario selecciona Cancelar en la pantalla de solicitud de permisos dos veces seguidas, tu app debe mostrarle una pantalla similar a la siguiente:

El usuario canceló los permisos dos veces

Lectura y visualización de datos

Para generar confianza y asegurarles a los usuarios que sus datos se leen correctamente, es importante mostrarles cómo obtiene datos tu app, que provienen de la propiedad packageName de la clase DataOrigin.

Hay dos maneras de hacerlo:

  1. Atribución básica
  2. Atribución con educación

Atribución básica

Como mínimo, la interfaz de usuario (IU) debe mostrar el ícono y el nombre de la fuente de la app (o solo el nombre de la app si no se puede mostrar el ícono). La atribución básica es adecuada para las siguientes pantallas: Principal, Registro de actividad y Detalles de la actividad.

Para admitir la atribución adecuada, tu aplicación puede mostrar el nombre y el ícono de la aplicación que registró los datos originalmente. Esto mejora la confianza del usuario y proporciona claridad sobre el origen de la información de salud.

No es necesario que solicites ningún permiso sensible, como QUERY_ALL_PACKAGES, para recuperar esta información. En el siguiente ejemplo, se muestra cómo recuperar la etiqueta y el ícono de la app para un paquete determinado desde PackageManager:

fun getAppLabelAndIcon(context: Context, packageName: String): Pair<CharSequence?, Drawable?>{
    return try {
      val pm = context.pacageManager
      val appInfo = pm.getApplicationInfo(packageName, 0)
      val label = pm.getApplicationLabel(appInfo)
      val icon = pm.getApplicationIcon(appInfo)
      label to icon
    } catch (e: PackageManager.NameNotFoundException){
      null to null
    }
}

Esta utilidad garantiza la atribución adecuada, ya que muestra el nombre y el ícono de la app junto con los datos. Consulta la implementación en el ejemplo de HealthConnectManager.kt.

Atribución básica para la lectura de datos

Atribución con educación

Tu app debe ayudar a los usuarios a obtener información sobre el origen de los datos con un vínculo directo a la pantalla “Permisos de apps” en Health Connect. Este tipo de atribución es adecuado para las siguientes pantallas: Detalles de la actividad, Informes y estadísticas.

Sincronización de datos

Si hay suficiente latencia cuando se sincroniza tu app con Health Connect, te recomendamos que tu app muestre esta notificación mientras se sincronizan los datos. Esto le informa al usuario que algo está sucediendo y que puede tardar un tiempo en finalizar. Si usas notificaciones para la sincronización, deben establecerse en prioridad baja de forma predeterminada.

Se muestra el estado de sincronización de los datos

Recursos

Los íconos de producto deben usarse sobre un fondo blanco o gris muy claro. También puedes usar el ícono en un fondo negro si es necesario.

Lineamientos de los íconos

Descarga los siguientes íconos: