En esta página, se describen las funciones principales de la API de Health Connect.
Operaciones de CRUD en la sincronización de registros y datos
La plataforma proporciona funciones estándar de inserción, actualización y eliminación para datos grabados. Health Connect también incluye una funcionalidad que permite que las apps cliente sincronicen los datos de Health Connect. Esto produce un registro de cambios en los datos que le muestra al desarrollador y al usuario si otras apps insertaron o borraron algunos tipos de datos.
Funciones de agregación básicas
Los clientes pueden aplicar una función de agregación en los datos subyacentes y proporcionar lo siguiente:
- Los valores promedio, mínimo o máximo (por ejemplo, la frecuencia cardíaca mínima y máxima durante una sesión de actividad)
- La suma total (por ejemplo, el recuento total de pasos en un intervalo diario)
- Un recuento simple de la cantidad de mediciones subyacentes (por ejemplo, la cantidad de sesiones de actividad en una semana determinada)
- La duración total de los tipos de datos admitidos (por ejemplo, el tiempo de sueño profundo esta semana o la duración total de las sesiones de actividad de hoy)
Verificaciones de disponibilidad
Health Connect es compatible con la versión 28 (Pie) y versiones posteriores del SDK de Android. El SDK permite que las apps cliente determinen si la API de Health Connect se encuentra en el dispositivo con Android del usuario. De lo contrario, Health Connect activará una verificación de disponibilidad para determinar si el dispositivo del usuario es compatible.
Verificaciones de permisos
Health Connect requiere que solicites el permiso del usuario para leer y escribir sus datos de salud y estado físico por app. También te permite ver los permisos que el usuario otorgó o rechazó.
Lectura con Health Connect
Lectura en primer plano
Por lo general, puedes leer datos de Health Connect cuando tu app está en primer plano. En estos casos, te recomendamos que uses un servicio en primer plano para ejecutar esta operación en caso de que el usuario o el sistema coloquen tu app en segundo plano durante una operación de lectura.
En los casos en los que tu app puede esperar una interrupción, como mostrar una lectura en tu app, lee directamente desde Health Connect tu aplicación cliente.
En situaciones en las que prefieras que la app se ejecute sin interrupciones, usa un servicio en primer plano:
FOREGROUND_SERVICE_TYPE_HEALTH: Permite que la app permanezca en primer plano para recopilar datos de sensores, como una app de entrenamiento que continúa recopilando datos incluso cuando el usuario la pone en segundo plano.FOREGROUND_SERVICE_TYPE_SHORT_SERVICE: Es un servicio de tipo genérico que permite que una app siga recopilando datos esenciales para tareas que tardan menos de tres minutos, incluso si el usuario coloca la app en segundo plano antes de que se complete.
Lectura en segundo plano
Puedes solicitar que tu aplicación se ejecute en segundo plano y lea datos de Health Connect. Si solicitas el permiso Leer en segundo plano, el usuario puede otorgarle a tu app acceso para leer datos en segundo plano.