Questa pagina descrive le funzioni principali dell'API Health Connect.
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 al di fuori di Connessione Salute. In questo modo 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 medio, minimo o massimo (ad esempio, la frequenza cardiaca minima e massima durante una sessione di attività).
- Il 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 sui 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 Health Connect è 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 l'autorizzazione dell'utente per leggere e scrivere i suoi dati relativi a salute e attività fisica per ogni app. Ti consente inoltre 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 è in primo piano. In questi casi, puoi prendere in considerazione l'utilizzo di un servizio in primo piano per eseguire questa operazione nel caso in cui l'utente o il sistema metta 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 nella tua applicazione, leggi direttamente da Connessione Salute alla tua applicazione client.
Per le situazioni in cui preferisci che la tua app venga eseguita senza interruzioni, 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 di 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 mette l'app in background prima che venga completata.
Lettura in background
Puoi richiedere che la tua 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 per leggere i dati in background.