Pianifica e rivedi i tipi di dati di Connessione Salute

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.