Connessione Salute archivia e struttura i dati relativi a salute e fitness. Inoltre, tiene conto come vengono misurati i diversi tipi di dati. Questi tipi di dati includono il battito cardiaco misurazioni effettuate immediatamente, conteggio dei passi effettuato nel tempo e dati del sonno effettuati in sessioni.
È importante capire innanzitutto quali tipi di dati e autorizzazioni Collega le offerte per pianificare i requisiti delle tue app. Detto questo, devi rivedere i tuoi tipi di dati prima di poter finalizzare i requisiti.
Categorie dei tipi di dati
Connessione Salute supporta i tipi di dati utilizzati nella maggior parte dei casi di salute e fitness per offrire la maggiore varietà possibile. Connessione Salute punta a offrire visualizzazione e archiviazione complete dei dati relativi a salute e attività fisica. Questi tipi di dati rientrano nelle seguenti categorie:
- Attività:registra qualsiasi attività svolta da un utente. Può includere attività di salute e fitness, come corsa, nuoto e sonno.
- Misurazione corporea: acquisisce dati comuni relativi al corpo, come il peso di un utente e il suo metabolismo basale.
- Monitoraggio del ciclo: acquisisce i cicli mestruali e i relativi punti dati. come il risultato binario di un test di ovulazione.
- Alimentazione: acquisisce i tipi di dati relativi all'idratazione e all'alimentazione. Il primo rappresenta la quantità di acqua consumata da un utente in una singola bevanda. Quest'ultimo include campi facoltativi come calorie, zucchero e magnesio.
- Sonno: acquisisce i dati dell'intervallo relativi alla durata e al tipo di utente di sonno.
- Dati fondamentali: acquisiscono informazioni essenziali sulle informazioni generali dell'utente. l'integrità fisica. Include dati come temperatura corporea, glicemia, sangue pressione e saturazione dell'ossigeno nel sangue.
Formato del tipo di dati
I tipi di dati di Connessione Salute vengono archiviati in oggetti che sono sottoclassi di
Record
Per ogni tipo di dati, esistono campi associati generici come
time e zoneOffset o specifiche come title, count e percentage.
Per alcuni campi vengono utilizzati tipi semplici, ad esempio long, double o string, mentre altri usano
tipi complessi come enumerazioni e classi come Instant e
ZoneOffset. Gli attributi di questi campi possono essere obbligatori o
facoltativo. Alcuni attributi sono di sola lettura, mentre altri sono bloccati a un
in un intervallo specifico di valori.
Per l'elenco completo dei tipi di dati disponibili e dei relativi campi, consulta le classi in Jetpack.
Attributi di dati aggiuntivi
I dati nell'API Health Connect includono anche gli attributi metadata descritti nel seguente elenco:
- ID Connessione Salute: a ogni punto di dati viene assegnato un identificatore univoco (UID) al momento della creazione. Ciò è utile per le operazioni standard di lettura e scrittura. Per maggiori dettagli, vedi ID Connessione Salute.
- Ultima modifica: contrassegna il timestamp relativo all'ultima istanza di un record ha un aggiornamento. Viene generato automaticamente alla prima creazione o a ogni aggiornamento.
- Origine dei dati:Connessione Salute memorizza le informazioni sull'app in cui da cui provengono i dati. Contiene il nome del pacchetto dell'origine, vengono aggiunti automaticamente al momento della creazione.
- Dispositivo:Connessione Salute memorizza informazioni sul dispositivo su cui si trovano i dati da cui proviene. Contiene il produttore e il modello del dispositivo, di cui puoi inserisci manualmente il valore.
- ID client:Connessione Salute fornisce gli ID client in modo che le app client possano fare riferimento ai dati utilizzando ID propri, il che contribuisce alla risoluzione dei conflitti e semplifica la sincronizzazione. che viene fornito manualmente al record.
- Versione record client: insieme all'ID client, Connessione Salute fornisce controllo delle versioni per tenere traccia delle modifiche durante la sincronizzazione dei dati. Questo viene fornito manualmente il record.
- Metodo di registrazione:Connessione Salute ti consente di capire come vengono registrati i dati. Questi metodi includono le app che registrano dati in modo passivo (automaticamente) e gli utenti di dati in modo attivo o manuale.
ID Connessione Salute
Connessione Salute assegna identificatori univoci (UID) agli oggetti dati appena inseriti, che identificano gli oggetti dati e li distinguono dagli altri. ID Connessione Salute sono utili nelle richieste di lettura o scrittura. Gli ID Connessione Salute non sono identici a ID client. Un'app client assegna gli ID client, mentre solo Connessione Salute assegna ID Connessione Salute.
Quando lavori con gli ID di Connessione Salute, tieni presente le seguenti note:
- Le sessioni hanno un solo ID Connessione Salute, ma i dati all'interno delle sessioni hanno i loro propri ID Connessione Salute.
- Gli ID Connessione Salute non sono legati o correlati ai timestamp.
- Alcuni casi d'uso potrebbero richiedere l'archiviazione di un ID Connessione Salute specifico durante un flusso di lavoro. Ad esempio, è necessario un ID specifico da recuperare e mostrare a un utilizzare la voce di dati appena registrata.
Tempo in Connessione Salute
Tutti i dati scritti in Connessione Salute devono specificare le informazioni sull'offset della zona. Se specifichi l'offset di zona, le app possono leggere i dati per rappresentarli in civile. Per ora civile si intende l'ora locale e pertinente per l'utente, ma non necessariamente nel fuso orario UTC (Coordinated Universal Time).
In rari casi, l'offset di zona potrebbe non essere disponibile. In questo caso in Android 14 (livello API 34), Connessione Salute imposta l'offset della zona in base fuso orario predefinito di sistema del dispositivo. In Android 13 e versioni precedenti (API di livello 33 e livelli inferiori), è possibile scrivere su Connessione Salute senza specificando informazioni sull'offset di zona, che deve essere evitata quando possibile.
Impostazione di ora e fuso orario
Se specifichi le informazioni sull'offset di zona durante la scrittura dei dati, viene fornito il fuso orario informazioni durante la lettura dei dati in Connessione Salute. Tuttavia, potrebbe non riuscire in determinate situazioni, ad esempio quando non viene fornito l'offset di zona. La tua app e devono essere preparati a gestire entrambi i tipi di dati, in un modo che abbia senso alle tue circostanze specifiche.
Autorizzazioni
Prima di richiedere autorizzazioni, l'app deve dichiararle nel file manifest per prima cosa. Consulta le seguenti tabelle per la mappatura completa dei tipi di dati e dei relativi autorizzazioni aggiuntive.
Per 1.0.0-alpha10 e versioni successive
| Tipo di classe di record | Dichiarazione delle autorizzazioni di lettura e scrittura |
|---|---|
| Calorie Bruciate Attive |
android.permission.health.READ_ACTIVE_CALORIES_BURNED
android.permission.health.WRITE_ACTIVE_CALORIES_BURNED |
| Temperatura corporea basale |
android.permission.health.READ_BASAL_BODY_TEMPERATURE
android.permission.health.WRITE_BASAL_BODY_TEMPERATURE |
| BasalMetabolicRate |
android.permission.health.READ_BASAL_METABOLIC_RATE
android.permission.health.WRITE_BASAL_METABOLIC_RATE |
| Glicemia |
android.permission.health.READ_BLOOD_GLUCOSE
android.permission.health.WRITE_BLOOD_GLUCOSE |
| Pressione sanguigna |
android.permission.health.READ_BLOOD_PRESSURE
android.permission.health.WRITE_BLOOD_PRESSURE |
| Grasso corporeo |
android.permission.health.READ_BODY_FAT
android.permission.health.WRITE_BODY_FAT |
| Temperatura corporea |
android.permission.health.READ_BODY_TEMPERATURE
android.permission.health.WRITE_BODY_TEMPERATURE |
| Massa d'acqua corporea |
android.permission.health.READ_BODY_WATER_MASS
android.permission.health.WRITE_BODY_WATER_MASS |
| Massa ossea |
android.permission.health.READ_BONE_MASS
android.permission.health.WRITE_BONE_MASS |
| Mucus cervicale |
android.permission.health.READ_CERVICAL_MUCUS
android.permission.health.WRITE_CERVICAL_MUCUS |
| CiclismoPedalingCadence |
android.permission.health.READ_EXERCISE
android.permission.health.WRITE_EXERCISE |
| Distanza |
android.permission.health.READ_DISTANCE
android.permission.health.WRITE_DISTANZA |
| Altitudine aumentata |
android.permission.health.READ_ELEVATION_GAINED
android.permission.health.WRITE_ELEVATION_GAINED |
| Sessione di allenamento |
android.permission.health.READ_EXERCISE
android.permission.health.WRITE_EXERCISE |
| Piani saliti |
android.permission.health.READ_FLOORS_CLIMBED
android.permission.health.WRITE_FLOORS_CLIMBED |
| Battito cardiaco |
android.permission.health.READ_HEART_RATE
android.permission.health.WRITE_HEART_RATE |
| HeartRateVariabilityRmssd |
android.permission.health.READ_HEART_RATE_VARIABILITY
android.permission.health.WRITE_HEART_RATE_VARIABILITY |
| Altezza |
android.permission.health.READ_HEIGHT
android.permission.health.WRITE_HEIGHT |
| Idratazione |
android.permission.health.READ_HYDRATION
android.permission.health.WRITE_HYDRATION |
| Emorragia intermestruale |
android.permission.health.READ_INTERMENSTRUAL_BLEEDING
android.permission.health.WRITE_INTERMENSTRUAL_BLEEDING |
| Massa corporea |
android.permission.health.READ_LEAN_BODY_MASS
android.permission.health.WRITE_LEAN_BODY_MASS |
| Flow Menstruation |
android.permission.health.READ_MENSTRUATION
android.permission.health.WRITE_MENSTRUATION |
| Periodo di misurazione |
android.permission.health.READ_MENSTRUATION
android.permission.health.WRITE_MENSTRUATION |
| Alimentazione |
android.permission.health.READ_NUTRITION
android.permission.health.WRITE_NUTRITION |
| Test ovulazione |
android.permission.health.READ_OVULATION_TEST
android.permission.health.WRITE_OVULATION_TEST |
| Saturazione ossigeno |
android.permission.health.READ_OXYGEN_SATURATION
android.permission.health.WRITE_OXYGEN_SATURATION |
| Alimentazione |
android.permission.health.READ_POWER
android.permission.health.WRITE_POWER |
| Frequenza respiratoria |
android.permission.health.READ_RESPIRATORY_RATE
android.permission.health.WRITE_RESPIRATORY_RATE |
| Battito cardiaco a riposo |
android.permission.health.READ_RESTING_HEART_RATE
android.permission.health.WRITE_RESTING_HEART_RATE |
| Attività sessuale |
android.permission.health.READ_SEXUAL_ACTIVITY
android.permission.health.WRITE_SEXUAL_ACTIVITY |
| SessioneSonno |
android.permission.health.READ_SLEEP
android.permission.health.WRITE_SLEEP |
| Velocità |
android.permission.health.READ_SPEED
android.permission.health.WRITE_SPEED |
| Sales Cadence |
android.permission.health.READ_STEPS
android.permission.health.WRITE_STEPS |
| Passi |
android.permission.health.READ_STEPS
android.permission.health.WRITE_STEPS |
| TotaleCalorieBruciate |
android.permission.health.READ_TOTAL_CALORIES_BURNED
android.permission.health.WRITE_TOTAL_CALORIES_BURNED |
| Vo2Max |
android.permission.health.READ_VO2_MAX
android.permission.health.WRITE_VO2_MAX |
| Peso |
android.permission.health.READ_WEIGHT
android.permission.health.WRITE_WEIGHT |
| Spinge in sedia a rotelle |
android.permission.health.READ_WHEELCHAIR_PUSHES
android.permission.health.WRITE_WHEELCHAIR_PUSHES |
Per 1.0.0-alpha09 e precedenti
| Tipo di classe di record | Dichiarazione delle autorizzazioni di lettura e scrittura |
|---|---|
| Calorie Bruciate Attive |
androidx.health.permission.ActiveCaloriesBurned.READ
androidx.health.permission.ActiveCaloriesBurned.WRITE |
| Temperatura corporea basale |
androidx.health.permission.BasalBodyTemperature.READ
androidx.health.permission.BasalBodyTemperature.SCRITTURA |
| BasalMetabolicRate |
androidx.health.permission.BasalMetabolicRate.READ:
androidx.health.permission.BasalMetabolicRate.SCRITTURA |
| Glicemia |
androidx.health.permission.glucosio nel sangue.READ
androidx.health.permission.Glicemia.SCRITTURA |
| Pressione sanguigna |
androidx.health.permission.Pressione del sangue.READ
androidx.salute.permission.Pressione.sanguigna.SCRITTURA |
| Grasso corporeo |
androidx.health.permission.BodyFat.READ:
androidx.health.permission.BodyFat.SCRITTURA |
| Temperatura corporea |
androidx.health.permission.BodyTemperature.READ
androidx.health.permission.BodyTemperature.WRITE |
| Massa d'acqua corporea |
androidx.health.permission.BodyWaterMass.READ:
androidx.health.permission.BodyWaterMass.SCRITTURA |
| Massa ossea |
androidx.health.permission.BoneMass.READ
androidx.health.permission.BoneMass.SCRITTURA |
| Mucus cervicale |
androidx.health.permission.CervicalMucus.READ
androidx.health.permission.CervicalMucus.SCRITTURA |
| CiclismoPedalingCadence |
androidx.health.permission.CyclingPedalingCadence.READ
androidx.health.permission.CiclismoPedalingCadence.SCRITTURA |
| Distanza |
androidx.health.permission.Distance.READ
androidx.health.permission.Distanza.SCRITTURA |
| Altitudine aumentata |
androidx.health.permission.ElevationGained.READ
androidx.health.permission.ElevationGained.SCRITTURA |
| Sessione di allenamento |
androidx.health.permission.ExerciseSession.READ
androidx.health.permission.ExerciseSession.SCRITTURA |
| Piani saliti |
androidx.health.permission.FloorsClimbed.READ
androidx.salute.permission.PianiSsaliti.SCRITTURA |
| Battito cardiaco |
androidx.health.permission.HeartRate.READ:
androidx.health.permission.HeartRate.SCRITTURA |
| HeartRateVariabilityRmssd |
androidx.health.permission.HeartRateVariabilityRmssd.READ
androidx.health.permission.HeartRateVariabilityRmssd.WRITE |
| Altezza |
androidx.health.permission.Height.READ:
androidx.health.permission.Altezza.SCRITTURA |
| Idratazione |
androidx.health.permission.Hydration.READ
androidx.health.permission.Hydration.SCRITTURA |
| Emorragia intermestruale |
androidx.health.permission.IntermestrualBleeding.READ
androidx.health.permission.Sanguinamento Intermestruale.SCRITTURA |
| Massa corporea |
androidx.health.permission.LeanBodyMass.READ
androidx.health.permission.LeanBodyMass.SCRITTURA |
| Flow Menstruation |
androidx.health.permission.MenstruationFlow.READ:
androidx.health.permission.MenstruationFlow.SCRITTURA |
| Alimentazione |
androidx.health.permission.Nutrition.READ:
androidx.health.permission.Nutrition.SCRITTURA |
| Test ovulazione |
androidx.health.permission.OvulationTest.READ:
androidx.health.permission.OvulationTest.WRITE |
| Saturazione ossigeno |
androidx.health.permission.OxygenSaturation.READ:
androidx.health.permission.OxygenSaturation.SCRITTURA |
| Alimentazione |
androidx.health.permission.Power.READ
androidx.health.permission.Power.SCRITTURA |
| Frequenza respiratoria |
androidx.health.permission.RespiratoryRate.READ
androidx.health.permission.RespiratoryRate.SCRITTURA |
| Battito cardiaco a riposo |
androidx.health.permission.RestingHeartRate.READ
androidx.health.permission.RestingHeartRate.SCRITTURA |
| Attività sessuale |
androidx.health.permission.SexualActivity.READ
androidx.health.permission.SexualActivity.WRITE |
| SessioneSonno |
androidx.health.permission.SleepSession.READ
androidx.health.permission.SleepSession.WRITE |
| Velocità |
androidx.health.permission.Speed.READ:
androidx.health.permission.Velocità.SCRITTURA |
| Sales Cadence |
androidx.health.permission.StepsCadence.READ
androidx.health.permission.StepsCadence.SCRITTURA |
| Passi |
androidx.health.permission.Steps.READ
androidx.health.permission.Steps.SCRITTURA |
| TotaleCalorieBruciate |
androidx.health.permission.TotalCaloriesBurned.READ
androidx.health.permission.TotalCaloriesBurned.WRITE |
| Vo2Max |
androidx.health.permission.Vo2Max.READ:
androidx.health.permission.Vo2Max.SCRITTURA |
| Peso |
androidx.health.permission.Weight.READ:
androidx.health.permission.Weight.SCRITTURA |
| Spinge in sedia a rotelle |
androidx.health.permission.WheelchairPushes.READ
androidx.salute.Autorizzazione.Spinge sulla sedia a rotelle.SCRITTURA |
Rivedi le autorizzazioni e i tipi di dati
Ora che hai pianificato i tipi di dati e le autorizzazioni, puoi implementare durante lo sviluppo.
Quando esamini la tua app prima di caricarla sul Play Store, ricontrolla l'elenco dei tipi di dati e delle autorizzazioni richiesti dalla tua app. Questo consente di dichiarare accuratamente l'utilizzo dei dati da parte dell'app.
Quando ti prepari a pubblicare la tua app sul Play Store, dichiarare l'accesso ai tipi di dati di Connessione Salute che la tua app utilizzi. In caso contrario, agli utenti potrebbe essere mostrato un messaggio di errore relativo alla tua app non possono accedere ai tipi di dati di Connessione Salute perché richiedono informazioni approvazione.