Saltar al contenido

@capgo/capacitor-health

El plugin Capacitor para interactuar con datos de Apple HealthKit y Health Connect.

@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.

PlataformaSoporteNotas
iOSSíAutorización y muestras de HealthKit
AndroidSíHealth Connect, permiso opcional de historial para lecturas de más de unos 30 días
WebLimitadoisAvailable reporta SDKs nativos no compatibles

Helpers exclusivos de Android: openHealthConnectSettings, showPrivacyPolicy.

  • 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.
MétodoDescripción
isAvailableIndica si la plataforma actual admite el SDK nativo de health.
requestAuthorizationSolicita acceso de lectura/escritura a los tipos de datos proporcionados.
checkAuthorizationVerifica el estado de autorización de los tipos de datos proporcionados sin mostrar prompts al usuario.
readSamplesLee las muestras del tipo de dato indicado dentro del intervalo de tiempo especificado.
saveSampleEscribe una única muestra en el almacén de salud nativo.
getPluginVersionObtén la versión del plugin nativo Capacitor.
openHealthConnectSettingsAbre la pantalla de ajustes de Health Connect (solo Android). En iOS, este método no hace nada.
showPrivacyPolicyMuestra la política de privacidad de la app para Health Connect (solo Android). En iOS, este método no hace nada.
queryWorkoutsConsulta sesiones de entrenamiento desde el almacén de salud nativo. Compatible con iOS (HealthKit) y Android (Health Connect).
queryAggregatedConsulta 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.

Esta referencia se sincroniza desde src/definitions.ts en 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.