Questa pagina descrive le funzioni principali dell'API Connessione Salute.
Operazioni CRUD sulla sincronizzazione di record e dati
La piattaforma fornisce funzioni standard di inserimento, aggiornamento ed eliminazione per i dati registrati. Connessione Salute include anche funzionalità che consentono alle app client di sincronizzare i dati in uscita da Connessione Salute. Viene generato un log delle modifiche ai dati che mostra allo sviluppatore e all'utente se determinati tipi di dati sono stati inseriti o eliminati da altre app.
Funzioni di aggregazione di base
I clienti possono applicare una funzione di aggregazione ai dati sottostanti, fornendo quanto segue:
- I valori medi, minimi o massimi (ad esempio la frequenza cardiaca minima e massima durante una sessione di attività).
- La somma totale (ad esempio il numero totale di passi in un intervallo giornaliero).
- Un conteggio semplice del numero di misurazioni sottostanti (ad esempio, il numero di sessioni di attività in una determinata settimana).
- La durata totale per i tipi di dati supportati (ad esempio il tempo trascorso in sonno profondo questa settimana o la durata totale delle sessioni di attività oggi).
Controlli di disponibilità
Connessione Salute è compatibile con la versione 28 (Pie) e successive dell'SDK Android. L'SDK consente alle app client di determinare se l'API Connessione Salute è attiva sul dispositivo Android dell'utente. In caso contrario, Health Connect attiva un controllo di disponibilità per determinare se il dispositivo dell'utente è compatibile.
Controlli delle autorizzazioni
Connessione Salute richiede di richiedere all'utente l'autorizzazione a leggere e scrivere i suoi dati relativi a salute e attività fisica su base per app. Inoltre, ti consente di vedere quali autorizzazioni sono già state concesse o negate dall'utente.
Lettura con Connessione Salute
Lettura in primo piano
In genere puoi leggere i dati da Connessione Salute quando la tua app è attiva in primo piano. In questi casi, ti consigliamo di utilizzare un servizio in primo piano per eseguire questa operazione nel caso in cui l'utente o il sistema inserisca la tua app in background durante un'operazione di lettura.
Per le situazioni in cui la tua app potrebbe prevedere un'interruzione, ad esempio la visualizzazione di una lettura nell'applicazione, leggi direttamente da Connessione Salute all'applicazione client.
Per le situazioni in cui preferisci che la tua app venga eseguita senza interruzione, utilizza un servizio in primo piano:
FOREGROUND_SERVICE_TYPE_HEALTH
: consente all'app di rimanere in primo piano per raccogliere i dati dei sensori, ad esempio un'app per l'allenamento che continua a raccogliere dati anche quando l'utente la mette in background.FOREGROUND_SERVICE_TYPE_SHORT_SERVICE
: un servizio di tipo generico che consente a un'app di continuare a raccogliere dati critici per attività che richiedono meno di tre minuti, anche se l'utente inserisce l'app in background prima del completamento.
Lettura in background
Puoi richiedere che l'applicazione venga eseguita in background e legga i dati da Connessione Salute. Se richiedi l'autorizzazione Lettura in background, l'utente può concedere alla tua app l'accesso in lettura dei dati in background.