Revisa la funcionalidad de Health Connect
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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.
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-07-27 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-07-27 (UTC)"],[],[],null,["# Review Health Connect functionality\n\nThis page describes the main functions of the Health Connect API.\n\nCRUD operations on record and data synchronization\n--------------------------------------------------\n\nThe platform provides standard insert, update, and delete functions for recorded\ndata. Health Connect also includes functionality that allows client apps to\nsynchronize data out of Health Connect. This produces a log of data changes\nthat shows the developer and user whether certain data types have been\ninserted or deleted by other apps.\n\nBasic aggregation functions\n---------------------------\n\nClients can apply an aggregation function over underlying data, providing the\nfollowing:\n\n- The **average, minimum or maximum** values (for example, the minimum and maximum heart rate during an activity session).\n- The **sum total** (for example, the total step count in a daily interval).\n- A **simple count** of the number of underlying measurements (for example, the number of activity sessions in a given week).\n- The **total duration** on supported data types (for example, time spent in deep sleep this week, or total duration of activity sessions today).\n\nAvailability checks\n-------------------\n\nHealth Connect is compatible with Android SDK version 28 (Pie) and higher.\nThe SDK allows client apps to determine whether the Health Connect API is on\nthe user's Android-powered device. If it isn't, Health Connect triggers an\navailability check to determine whether the user's device is compatible.\n\nPermission checks\n-----------------\n\nHealth Connect requires you to request the user's permission to read and\nwrite their health and fitness data on a per-app basis. It also lets you\nsee what permissions have already been granted or denied by the user.\n\nReading with Health Connect\n---------------------------\n\n### Foreground reading\n\nYou can normally read data from Health Connect when your app is\nin the foreground. In these cases, you may consider using a foreground service\nto run this operation in case the user or system places your app\nin the background during a read operation.\n\nFor situations in which your app may expect an interruption, such as displaying\na reading in your application, read directly from Health Connect to your client\napplication.\n\nFor situations in which you prefer your app to run without\ninterruptions, use a\n[foreground service](/develop/background-work/services/fgs):\n\n- [`FOREGROUND_SERVICE_TYPE_HEALTH`](/reference/android/content/pm/ServiceInfo#FOREGROUND_SERVICE_TYPE_HEALTH): Allows app to remain in\n the foreground to collect sensor data, such as a workout app that continues\n to collect data even when the user puts the app in the background.\n\n- [`FOREGROUND_SERVICE_TYPE_SHORT_SERVICE`](/reference/android/content/pm/ServiceInfo#FOREGROUND_SERVICE_TYPE_SHORT_SERVICE): A generic-type\n service that allows an app to continue to collect critical data for\n tasks that take less than three minutes,\n even if the user places the app in the background before it completes.\n\n### Background reading\n\nYou can request that your application run in the background and read data from\nHealth Connect. If you request the\n[Background Read](/health-and-fitness/guides/health-connect/develop/read-data#background-read-example)\npermission, your user can grant your app access to read data in the background."]]
