@capgo/capacitor-health

Panoramica

@capgo/capacitor-health legge e scrive i dati sanitari dell'utente tramite Apple HealthKit su iOS e Health Connect su Android. Usalo per conteggi dei passi, allenamenti, fasi del sonno, parametri vitali e campioni di nutrizione, senza dover mantenere due integrazioni native SDK separate nel layer dell'app.

Dashboard di fitness, app per le abitudini, prodotti wellness vicini al clinico e programmi di benessere aziendale iniziano spesso con requestAuthorization, poi readSamples oppure saveSample per le metriche che li interessano.

Supporto piattaforme

Piattaforma	Supporto	Note
iOS	Sì	Autorizzazione HealthKit e campioni
Android	Sì	Health Connect, autorizzazione facoltativa alla cronologia per letture oltre i 30 giorni circa
Web	Limitato	isAvailable segnala SDK nativi non supportati

Helper solo per Android: openHealthConnectSettings, showPrivacyPolicy.

Funzionalità principali

• isAvailable - Indica 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.

Pubblico API

Metodo	Descrizione
isAvailable	Restituisce se la piattaforma corrente supporta il SDK nativo per la salute.
requestAuthorization	Richiede l'accesso in lettura/scrittura ai tipi di dati specificati.
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 dati specificato nell'intervallo di tempo indicato.
saveSample	Scrive un singolo campione nel health store nativo.
getPluginVersion	Ottieni la versione nativa del plugin Capacitor.
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 repository nativo di dati sanitari. Supportato su iOS (HealthKit) e Android (Health Connect).
queryAggregated	Interroga i dati sanitari aggregati dal repository nativo. Aggrega i dati in intervalli 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.

Fonte di verità

Questo riferimento è sincronizzato da src/definitions.ts nella capacitor-health.

Continua da @capgo/capacitor-health

Se stai usando @capgo/capacitor-health per pianificare il lavoro sui plugin nativi, collegalo a Utilizzo di @capgo/capacitor-health per la funzionalità nativa in Utilizzo di @capgo/capacitor-health, Directory dei plugin di Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Capacitor Plugins di Capgo, Aggiunta o aggiornamento dei plugin per i dettagli su come aggiungere o aggiornare i plugin, e Alternative ai plugin Ionic Enterprise per il workflow del prodotto in Alternative ai plugin Ionic Enterprise.