Esamina la funzionalità di Connessione Salute
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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.
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2025-07-27 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-07-27 UTC."],[],[],null,["# Review Health Connect functionality\n\nThis page describes the main functions of the Health Connect API.\n\nCRUD operations on record and data synchronization\n--------------------------------------------------\n\nThe platform provides standard insert, update, and delete functions for recorded\ndata. Health Connect also includes functionality that allows client apps to\nsynchronize data out of Health Connect. This produces a log of data changes\nthat shows the developer and user whether certain data types have been\ninserted or deleted by other apps.\n\nBasic aggregation functions\n---------------------------\n\nClients can apply an aggregation function over underlying data, providing the\nfollowing:\n\n- The **average, minimum or maximum** values (for example, the minimum and maximum heart rate during an activity session).\n- The **sum total** (for example, the total step count in a daily interval).\n- A **simple count** of the number of underlying measurements (for example, the number of activity sessions in a given week).\n- The **total duration** on supported data types (for example, time spent in deep sleep this week, or total duration of activity sessions today).\n\nAvailability checks\n-------------------\n\nHealth Connect is compatible with Android SDK version 28 (Pie) and higher.\nThe SDK allows client apps to determine whether the Health Connect API is on\nthe user's Android-powered device. If it isn't, Health Connect triggers an\navailability check to determine whether the user's device is compatible.\n\nPermission checks\n-----------------\n\nHealth Connect requires you to request the user's permission to read and\nwrite their health and fitness data on a per-app basis. It also lets you\nsee what permissions have already been granted or denied by the user.\n\nReading with Health Connect\n---------------------------\n\n### Foreground reading\n\nYou can normally read data from Health Connect when your app is\nin the foreground. In these cases, you may consider using a foreground service\nto run this operation in case the user or system places your app\nin the background during a read operation.\n\nFor situations in which your app may expect an interruption, such as displaying\na reading in your application, read directly from Health Connect to your client\napplication.\n\nFor situations in which you prefer your app to run without\ninterruptions, use a\n[foreground service](/develop/background-work/services/fgs):\n\n- [`FOREGROUND_SERVICE_TYPE_HEALTH`](/reference/android/content/pm/ServiceInfo#FOREGROUND_SERVICE_TYPE_HEALTH): Allows app to remain in\n the foreground to collect sensor data, such as a workout app that continues\n to collect data even when the user puts the app in the background.\n\n- [`FOREGROUND_SERVICE_TYPE_SHORT_SERVICE`](/reference/android/content/pm/ServiceInfo#FOREGROUND_SERVICE_TYPE_SHORT_SERVICE): A generic-type\n service that allows an app to continue to collect critical data for\n tasks that take less than three minutes,\n even if the user places the app in the background before it completes.\n\n### Background reading\n\nYou can request that your application run in the background and read data from\nHealth Connect. If you request the\n[Background Read](/health-and-fitness/guides/health-connect/develop/read-data#background-read-example)\npermission, your user can grant your app access to read data in the background."]]
