Saltare al contenuto principale
@capgo/capacitor-salute API dei dispositivi Sorgente aperta

Salute Plugin Capacitor

Accedi ai dati di salute e fitness dai piattaforme di salute native

Installa

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

Guida

Come utilizzare la salute in Capacitor

Utilizzare @capgo/capacitor-health

Capacitor plugin per interagire con i dati da Apple HealthKit e Health Connect.

Installa

bun add @capgo/capacitor-health
bunx cap sync

bunx cap sync copia il plugin nativo code nei tuoi progetti nativi. Esegui nuovamente dopo ogni aggiornamento del plugin.

Importa

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

API in un colpo d'occhio

Metodo Descrizione
isAvailable Restituisce se il sistema operativo corrente supporta il nativo SDK di salute.
requestAuthorization Richiede l'accesso di lettura/scrittura ai tipi di dati forniti.
checkAuthorization Verifica lo stato di autorizzazione per i tipi di dati forniti senza sollecitare l'utente.
readSamples Legge campioni per il tipo di dati specificato entro il periodo di tempo specificato.
saveSample Scrive un singolo campione nel magazzino di salute nativo.
openHealthConnectSettings Apri la schermata di impostazioni di Health Connect (disponibile solo su Android). Su iOS, non esegue alcuna azione.
showPrivacyPolicy Mostra la politica sulla privacy dell'applicazione per Health Connect (disponibile solo su Android). Su iOS, questo metodo non fa nulla.
queryWorkouts Esegue query sui sessioni di allenamento dallo store di salute nativo. Supportato su iOS (HealthKit) e Android (Health Connect).
queryAggregated Esegue una query sui dati di salute aggregati dal magazzino di salute nativo. Aggancia i dati in bucket di tempo (ora, giorno, settimana, mese) con operazioni come somma, media, minimo o massimo. Questo è più efficiente del recupero di campioni individuali per intervalli di date grandi.

Esempi

isAvailable()

Controlla se la piattaforma corrente supporta il magazzino di salute nativo SDK.

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

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

requestAuthorization()

Richiede l'accesso di lettura/scrittura ai tipi di dati forniti.

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

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

checkAuthorization()

Controlla lo stato di autorizzazione per i tipi di dati forniti senza sollecitare l'utente.

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

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

readSamples()

Legge campioni per il tipo di dati specificato entro il periodo di tempo specificato.

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

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

saveSample()

Scrive un singolo campione nel magazzino di salute nativo.

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

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

openHealthConnectSettings()

Apri la schermata di impostazioni di Health Connect (disponibile solo su Android). Su iOS, non esegue alcuna azione.

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

await Health.openHealthConnectSettings();

La tabella sopra elenca i 9 metodi di base. Gli ascoltatori e gli aiuti di versione, nonché la piena contrattazione di ogni metodo, sono documentati nel repository di GitHub.

Riferimento completo

Continua dall'uso di @capgo/capacitor-health

Utilizzo di @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-health Utilizzando @capgo/capacitor-salute per pianificare il lavoro dei plugin nativi, connettilo con @capgo/capacitor-health per i dettagli di implementazione in @capgo/capacitor-salute, Avvio rapido per i dettagli di implementazione in Avvio rapido, Directory dei plugin Capgo per il workflow del prodotto nella Capgo Directory dei Plugin Plugin Capacitor di Capgo per i dettagli di implementazione in Plugin Capacitor di Capgo, e Aggiungere o aggiornare i plugin per i dettagli di implementazione in Aggiungere o aggiornare i plugin.

FAQ

Domande frequenti

Come posso installare il plugin di salute in un'app Capacitor?

Run "bun add @capgo/capacitor-health" (or "npm install @capgo/capacitor-health"), then run "bunx cap sync" so the iOS and Android projects pick up the native code. Import it from "@capgo/capacitor-health" in your app code.

Funziona @capgo/capacitor-health con React, Vue e Angular?

Yes. Health is a Capacitor package, so it works with any web framework that runs inside Capacitor, including Ionic, React, Vue, Angular, Svelte and plain JavaScript.

Qual è la versione di Capacitor supportata da @capgo/capacitor-health?

Capgo plugin seguono la versione maggiore di Capacitor: utilizzare la versione maggiore del plugin che corrisponde alla versione maggiore di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

È @capgo/capacitor-health gratuito e open source?

Sì. Il codice sorgente di code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-health/ e il pacchetto è gratuito per l'installazione da npm. I rapporti di bug e le richieste di pull sono accetti.

Posso aggiornare code che utilizza Health senza una revisione dell'App Store?

L'installazione o l'aggiornamento del plugin modifica il code nativo, quindi richiede una nuova costruzione dello store. Dopo di che, le modifiche JavaScript, HTML e CSS che chiamano il plugin possono essere spediti immediatamente con Capgo live updates.

Rilascia aggiornamenti di salute senza attendere la revisione dell'app.

Una volta che il plugin è presente nella tua store build, gli aggiornamenti live di Capgo inviano i cambiamenti JavaScript, HTML e CSS agli utenti in pochi minuti.

Inizia con Capgo