Guida
Come usare Health in Capacitor
Utilizzo di @capgo/capacitor-health
Il plugin Capacitor per interagire con i dati da Apple HealthKit e Health Connect.
Installa
bun add @capgo/capacitor-health
bunx cap sync
bunx cap sync copia i code nativi 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 health nativo SDK. |
requestAuthorization |
Richiede l'accesso in lettura/scrittura ai tipi di dati specificati. |
checkAuthorization |
Verifica lo stato di autorizzazione per i tipi di dati specificati senza sollecitare l'utente. |
readSamples |
Legge i campioni per il tipo di dati specificato nell'intervallo di tempo indicato. |
saveSample |
Scrive un singolo campione nel health store nativo. |
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 health store nativo. Supportato su iOS (HealthKit) e Android (Health Connect). |
queryAggregated |
Interroga i dati sanitari aggregati dal health store nativo. Aggrega i dati in bucket temporali (ora, giorno, settimana, mese) con operazioni come somma, media, min o max. È più efficiente rispetto al recupero di singoli campioni per ampi intervalli di date. |
Esempi
isAvailable()
Restituisce se la piattaforma corrente supporta il SDK sanitario nativo.
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 sollecitare l'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 dati specificato all'interno dell'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 health store nativo.
import { Health } from '@capgo/capacitor-health';
await Health.saveSample({
dataType: 'steps',
value: 1,
});
openHealthConnectSettings()
Apre la schermata di 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 core. Gli helper per listener e versioni e il contratto completo di ogni metodo sono documentati nella repository GitHub.
Riferimento completo
Continua da Utilizzo di @capgo/capacitor-health
Se stai usando Utilizzo di @capgo/capacitor-health per pianificare il lavoro sui plugin nativi, collegalo a @capgo/capacitor-health per i dettagli implementativi in @capgo/capacitor-health, Per iniziare per i dettagli di implementazione nella guida introduttiva, Directory dei plugin di 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.