Saltar al contenido

@capgo/capacitor-health

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

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

Helpers exclusivos de Android: openHealthConnectSettings, showPrivacyPolicy.

  • 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.
MétodoDescripción
isAvailableIndica si la plataforma actual soporta el SDK nativo de salud.
requestAuthorizationSolicita permisos de lectura/escritura para los tipos de datos indicados.
checkAuthorizationComprueba el estado de autorización de los tipos de datos sin mostrar un prompt al usuario.
readSamplesLee muestras del tipo de dato especificado dentro del intervalo de tiempo definido.
saveSampleEscribe una única muestra en el almacén de salud nativo.
getPluginVersionObtén la versión nativa del plugin 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 del almacén de salud nativo. Compatible con iOS (HealthKit) y Android (Health Connect).
queryAggregatedConsulta 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.

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