Saltar al contenido principal
@capgo/capacitor-salud Dispositivos de API Fuente abierta

Salud plugin de Capacitor

Acceda a datos de salud y fitness desde plataformas de salud 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 Salud en Capacitor

Probar en dispositivo

Descargue la aplicación Capgo, luego escane el código QR code.

Vista previa del plugin de salud QR code

Usando @capgo/capacitor-salud

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

Instalar

bun add @capgo/capacitor-health
bunx cap sync

bunx cap sync Copia el plugin nativo code en tus proyectos nativos. Correlo de nuevo después de cada actualización del plugin.

Importar

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

Vista general de API

Método Ejemplo de uso
isAvailable Devuelve si el plataforma actual admite la salud nativa SDK.
requestAuthorization Solicita acceso de lectura/escritura a los tipos de datos proporcionados.
checkAuthorization Verifica el estado de autorización para los tipos de datos proporcionados sin solicitar la confirmación del usuario.
readSamples Lee muestras para el tipo de dato especificado dentro del plazo de tiempo especificado.
saveSample Escribe una muestra única en el almacén de salud nativa.
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 aplicación para Health Connect (solo Android). En iOS, este método no hace nada.
queryWorkouts Consulta las sesiones de entrenamiento desde el almacén de salud nativa. Soportado en iOS (HealthKit) y Android (Health Connect).
queryAggregated Consulta los datos de salud agregados desde el almacén de salud nativa. Agrupa los datos en lotes de tiempo (hora, día, semana, mes) con operaciones como suma, promedio, mínimo o máximo. Esto es más eficiente que obtener muestras individuales para rangos de fechas grandes.

Ejemplos

isAvailable()

Devuelve si el plataforma actual admite la salud nativa SDK.

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

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

requestAuthorization()

Accede a lectura/escritura a 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 para los tipos de datos proporcionados sin solicitar la intervención del usuario.

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

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

readSamples()

Lee muestras para el tipo de datos especificado dentro del plazo de tiempo especificado.

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

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

saveSample()

Escribe una muestra única 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 configuración de Health Connect (solo para Android). En iOS, no realiza ninguna acción.

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

await Health.openHealthConnectSettings();

La tabla anterior enumera los 9 métodos básicos. Los ayudantes de escucha y versión, y la contratación completa de cada método, se documentan en el GitHub repositorio.

Referencia completa

Continúa desde el uso de @capgo/capacitor-health

Si estás utilizando Usando @capgo/capacitor-health para planificar el trabajo de plugin nativo, conecte con @capgo/capacitor-salud para obtener detalles de implementación en @capgo/capacitor-health, Getting Started para obtener detalles de implementación en Inicio, Directorio de Plugins de Capgo para el flujo de trabajo del producto en el directorio de plugins Capgo Plugins de Capacitor por Capgo para obtener detalles de implementación en Plugins de Capacitor por Capgo, y Agregar o Actualizar Plugins para los detalles de implementación en la adición o actualización de plugins.

FAQ

Preguntas frecuentes del plugin de salud

¿Cómo instalo el plugin de salud en una aplicación Capacitor?

Ejecuta "bun add @capgo/capacitor-salud" (o "npm install @capgo/capacitor-salud"), luego ejecuta "bunx cap sync" para que los proyectos iOS y Android capturen el nativo code. Importa desde "@capgo/capacitor-salud" en tu aplicación code.

¿Funciona @capgo/capacitor-salud con React, Vue y Angular?

Sí. Salud 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 soporta @capgo/capacitor-salud?

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

¿Es gratuita y de código abierto @capgo/capacitor-salud?

Sí. El código fuente de code está público en GitHub en https://github.com/Cap-go/capacitor-salud/ y el paquete es gratuito para instalar desde npm. Se aceptan informes de errores y solicitudes de extracción.

¿Puedo actualizar code que utiliza Salud sin una revisión de la Tienda?

La instalación o actualización del plugin cambia el nativo code, por lo que necesita una nueva compilación de la tienda. Después de eso, los cambios de JavaScript, HTML y CSS que llaman al plugin pueden enviar instantáneamente con Capgo actualizaciones en vivo.

Ship Health changes without waiting for app review

Una vez que el plugin esté en tu tienda de construcción, Capgo actualizaciones en vivo envían cambios en JavaScript, HTML y CSS a los usuarios en minutos.

Inicia con Capgo