Resumen
Sección titulada “Resumen”@capgo/capacitor-health lee y escribe datos de salud del usuario a través de Apple HealthKit en iOS y Health Connect en Android. Úsalo para contar pasos, entrenamientos, fases de sueño, constantes vitales y muestras de nutrición sin tener que mantener dos integraciones SDK nativas distintas en tu capa de app.
Dashboards de fitness, apps de hábitos, productos de bienestar clínico y programas de bienestar corporativo suelen empezar con requestAuthorization, luego readSamples o saveSample para las métricas que necesitan.
Soporte de plataformas
Sección titulada “Compatibilidad de plataformas”| Plataforma | Soporte | Notas |
|---|---|---|
| iOS | Sí | Autorización y muestras de HealthKit |
| Android | Sí | Health Connect, permiso opcional de historial para lecturas de más de 30 días |
| Web | Limitado | isAvailable reporta SDKs nativos no compatibles |
Helpers exclusivos de Android: openHealthConnectSettings, showPrivacyPolicy.
Funcionalidades principales
Sección titulada “Funcionalidades principales”isAvailable- Indica si la plataforma actual admite el SDK nativo de salud.requestAuthorization- Solicita acceso de lectura/escritura para los tipos de datos indicados.checkAuthorization- Verifica el estado de autorización de los tipos de datos sin mostrar un prompt al usuario.readSamples- Lee muestras del tipo de dato indicado dentro del intervalo de tiempo especificado.
API pública
Sección titulada “API pública”| Método | Descripción |
|---|---|
isAvailable | Indica si la plataforma actual soporta el SDK nativo de salud. |
requestAuthorization | Solicita permisos de lectura/escritura para los tipos de datos indicados. |
checkAuthorization | Comprueba el estado de autorización de los tipos de datos sin mostrar un prompt al usuario. |
readSamples | Lee muestras del tipo de dato especificado dentro del intervalo de tiempo definido. |
saveSample | Escribe una única muestra en el almacén de salud nativo. |
getPluginVersion | Obtén la versión nativa del plugin Capacitor. |
openHealthConnectSettings | Abre la pantalla de ajustes de Health Connect (solo Android). En iOS, este método no hace nada. |
showPrivacyPolicy | Muestra la política de privacidad de la app para Health Connect (solo Android). En iOS, este método no hace nada. |
queryWorkouts | Consulta sesiones de entrenamiento del almacén de salud nativo. Compatible con iOS (HealthKit) y Android (Health Connect). |
queryAggregated | Consulta datos de salud agregados del almacén nativo. Agrupa los datos en intervalos (hora, día, semana, mes) con operaciones como suma, promedio, mínimo o máximo. Es más eficiente que obtener muestras individuales para rangos de fechas amplios. |
Fuente de verdad
Sección titulada “Fuente de verdad”Esta referencia se sincroniza desde src/definitions.ts en capacitor-health.
Continúa con @capgo/capacitor-health
Sección titulada “Continúa con @capgo/capacitor-health”Si estás usando @capgo/capacitor-health para planificar el trabajo del plugin nativo, conéctalo con Uso de @capgo/capacitor-health para la capacidad nativa en el uso de @capgo/capacitor-health, Directorio de plugins de Capgo para el flujo de trabajo de productos en el Capgo Plugin Directory, Plugins de Capacitor por Capgo para los detalles de implementación en Plugins de Capacitor por Capgo, Añadir o actualizar plugins para el detalle de implementación en Agregar o actualizar plugins, y Alternativas a los plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas a plugins de Ionic Enterprise.