Guida
Come usare Health in Capacitor
Usare @capgo/capacitor-health
Plugin Capacitor per interagire con i dati di Apple HealthKit e Health Connect.
Installa
bun add @capgo/capacitor-health
bunx cap sync
bunx cap sync copia il code nativo del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.
Importa
import { Health } from '@capgo/capacitor-health';
API in breve
| Metodo | Descrizione |
|---|---|
isAvailable |
Restituisce se la piattaforma corrente supporta il SDK nativo della salute. |
requestAuthorization |
Richiede l'accesso in lettura/scrittura ai tipi di dati forniti. |
checkAuthorization |
Verifica lo stato di autorizzazione per i tipi di dati forniti senza mostrare prompt all'utente. |
readSamples |
Legge i campioni per il tipo di dato specificato nell'intervallo di tempo indicato. |
saveSample |
Scrive un singolo campione nel database nativo della salute. |
openHealthConnectSettings |
Apre la schermata delle impostazioni di Health Connect (solo Android). Su iOS, questo metodo non fa nulla. |
showPrivacyPolicy |
Mostra l'informativa sulla privacy dell'app per Health Connect (solo Android). Su iOS, questo metodo non fa nulla. |
queryWorkouts |
Interroga le sessioni di allenamento dal database nativo della salute. Supportato su iOS (HealthKit) e Android (Health Connect). |
queryAggregated |
Interroga i dati sanitari aggregati dal database nativo. Aggrega i dati in intervalli temporali (ora, giorno, settimana, mese) con operazioni come somma, media, min o max. È più efficiente che recuperare singoli campioni per lunghi intervalli di date. |
Esempi
isAvailable()
Restituisce se la piattaforma corrente supporta il SDK nativo della salute.
import { Health } from '@capgo/capacitor-health';
const result = await Health.isAvailable();
console.log(result);
requestAuthorization()
Richiede l'accesso in lettura/scrittura ai tipi di dati forniti.
import { Health } from '@capgo/capacitor-health';
const result = await Health.requestAuthorization({ read: ['steps'] });
console.log(result);
checkAuthorization()
Verifica lo stato di autorizzazione per i tipi di dati forniti senza mostrare prompt all'utente.
import { Health } from '@capgo/capacitor-health';
const result = await Health.checkAuthorization({ read: ['steps'] });
console.log(result);
readSamples()
Legge i campioni per il tipo di dato specificato nell'intervallo di tempo indicato.
import { Health } from '@capgo/capacitor-health';
const result = await Health.readSamples({ dataType: 'steps' });
console.log(result);
saveSample()
Scrive un singolo campione nel database nativo della salute.
import { Health } from '@capgo/capacitor-health';
await Health.saveSample({
dataType: 'steps',
value: 1,
});
openHealthConnectSettings()
Apre la schermata delle impostazioni di Health Connect (solo Android). Su iOS, questo metodo non fa nulla.
import { Health } from '@capgo/capacitor-health';
await Health.openHealthConnectSettings();
La tabella sopra elenca i 9 metodi principali. Listener, helper di versione e il contratto completo di ogni metodo sono documentati nel repository GitHub.
Riferimento completo
Continua da Usare @capgo/capacitor-health
Se stai usando Usare @capgo/capacitor-health per pianificare il lavoro sui plugin nativi, connettilo a @capgo/capacitor-health per i dettagli di implementazione in @capgo/capacitor-health, Per iniziare per i dettagli di implementazione in Getting Started, Directory Plugin Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Plugin Capacitor di Capgo, e Aggiunta o aggiornamento dei plugin per i dettagli di implementazione in Aggiunta o aggiornamento dei plugin.