Saltar al contenido principal
@capgo/capacitor-health API de dispositivos Código abierto

Salud plugin Capacitor

Accede a datos de salud y fitness de plataformas nativas

Instalar

bun add @capgo/capacitor-health bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-health
  • pnpm add @capgo/capacitor-health
  • yarn add @capgo/capacitor-health

Guía

Cómo usar Health en Capacitor

Usando @capgo/capacitor-health

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

Instalar

bun add @capgo/capacitor-health
bunx cap sync

bunx cap sync copia el code nativo del plugin en tus proyectos nativos. Ejecútalo de nuevo tras cada actualización del plugin.

Importar

import { Health } from '@capgo/capacitor-health';

API de un vistazo

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 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.
openHealthConnectSettings Abre la configuración 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 nativo. Agrupa los datos en intervalos de tiempo (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.

Ejemplos

isAvailable()

Indica si la plataforma actual soporta el SDK de salud nativo.

import { Health } from '@capgo/capacitor-health';

const result = await Health.isAvailable();
console.log(result);

requestAuthorization()

Solicita permisos de lectura/escritura para los tipos de datos proporcionados.

import { Health } from '@capgo/capacitor-health';

const result = await Health.requestAuthorization({ read: ['steps'] });
console.log(result);

checkAuthorization()

Verifica el estado de autorización de los tipos de datos proporcionados sin mostrar prompts al usuario.

import { Health } from '@capgo/capacitor-health';

const result = await Health.checkAuthorization({ read: ['steps'] });
console.log(result);

readSamples()

Lee las muestras del tipo de dato indicado dentro del intervalo de tiempo especificado.

import { Health } from '@capgo/capacitor-health';

const result = await Health.readSamples({ dataType: 'steps' });
console.log(result);

saveSample()

Escribe una única muestra en el almacén de salud nativo.

import { Health } from '@capgo/capacitor-health';

await Health.saveSample({
  dataType: 'steps',
  value: 1,
});

openHealthConnectSettings()

Abre la pantalla de ajustes de Health Connect (solo Android). En iOS, este método no hace nada.

import { Health } from '@capgo/capacitor-health';

await Health.openHealthConnectSettings();

La tabla anterior enumera los 9 métodos principales. Los helpers de versión y listeners, así como el contrato completo de cada método, están documentados en la repositorio GitHub.

Referencia completa

Continúa desde Usando @capgo/capacitor-health

Si estás usando Usando @capgo/capacitor-health para planificar el trabajo con plugins nativos, conéctalo con @capgo/capacitor-health para los detalles de implementación en @capgo/capacitor-health, Primeros pasos para los detalles de implementación en Primeros pasos, Directorio de plugins de Capgo para el flujo de trabajo del producto en Capgo Plugin Directory, Plugins de Capacitor por Capgo para los detalles de implementación en Capacitor Plugins de Capgo, y Añadir o actualizar plugins para los detalles de implementación al añadir o actualizar plugins.

FAQ

FAQ del plugin Health

¿Cómo instalo el plugin Health en una app Capacitor?

Ejecuta "bun add @capgo/capacitor-health" (o "npm install @capgo/capacitor-health"), luego ejecuta "bunx cap sync" para que los proyectos de iOS y Android reconozcan el code nativo. Impórtalo desde "@capgo/capacitor-health" en el code de tu app.

¿Es compatible @capgo/capacitor-health con React, Vue y Angular?

Sí. Health es un paquete Capacitor, por lo que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor es compatible con @capgo/capacitor-health?

Los plugins de Capgo siguen la versión mayor de Capacitor: usa la versión mayor del plugin que coincida con la versión mayor de tu Capacitor (por ejemplo, el plugin v8 con Capacitor 8). La tabla de compatibilidad del README de GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-health gratuito y de código abierto?

Sí. El código fuente de code es público en GitHub en https://github.com/Cap-go/capacitor-health/ y el paquete es gratuito para instalar desde npm. Los reportes de bugs y pull requests son bienvenidos.

¿Puedo actualizar code que usa Health sin pasar por la revisión de la App Store?

Instalar o actualizar el plugin cambia el code nativo, así que requiere un nuevo build para la tienda. Después, los cambios de JavaScript, HTML y CSS que llamen al plugin se pueden publicar al instante con las live updates de Capgo.

Lanza cambios de Health sin esperar la revisión de la app

Una vez que el plugin esté en tu store build, Capgo live updates envía tus cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Empieza con Capgo