@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 conteos de pasos, entrenamientos, etapas de sueño, constantes vitales y muestras de nutrición sin mantener dos integraciones nativas SDK separadas en la capa de tu app.
Los dashboards de fitness, las apps de hábitos, los productos de bienestar clínicos y los programas corporativos de bienestar suelen empezar con requestAuthorization, luego readSamples o saveSample para las métricas que les importan.
Soporte de plataformas
Sección titulada “Soporte 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 unos 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 soporta 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.
Público API
Sección titulada “Público API”| Método | Descripción |
|---|---|
isAvailable | Indica si la plataforma actual admite el SDK nativo de health. |
requestAuthorization | Solicita acceso de lectura/escritura a los tipos de datos proporcionados. |
checkAuthorization | Verifica el estado de autorización de los tipos de datos proporcionados sin mostrar prompts al usuario. |
readSamples | Lee las muestras del tipo de dato indicado dentro del intervalo de tiempo especificado. |
saveSample | Escribe una única muestra en el almacén de salud nativo. |
getPluginVersion | Obtén la versión del plugin nativo 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 desde el almacén de salud nativo. Compatible con iOS (HealthKit) y Android (Health Connect). |
queryAggregated | Consulta datos de salud agregados del almacén de salud 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.
Continuar desde @capgo/capacitor-health
Sección titulada “Continuar desde @capgo/capacitor-health”Si estás usando @capgo/capacitor-health para planificar el trabajo con plugins nativos, conéctalo con Uso de @capgo/capacitor-health para la capacidad nativa en Uso de @capgo/capacitor-health, Directorio de plugins de Capgo para el flujo de trabajo del producto en Capgo Plugin Directory, Plugins de Capacitor por Capgo para el detalle de implementación en los Plugins de Capacitor por Capgo, Añadir o actualizar plugins para el detalle de implementación en Agregar o actualizar plugins, y Alternativas a plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas a plugins de Ionic Enterprise.