I tipi di dati in Health Connect vengono memorizzati in oggetti che sono sottoclassi di
Record.
Per ogni tipo di dati, esistono campi associati generici, ad esempio
time e zoneOffset, o specifici, ad esempio title, count e percentage.
Alcuni campi utilizzano tipi di base, come long, double o string, mentre altri utilizzano tipi complessi come enumerazioni e classi come Instant e ZoneOffset. Gli attributi di questi campi possono essere obbligatori o
facoltativi. Alcuni attributi sono di sola lettura e altri sono limitati a un intervallo specifico di valori.
Per l'elenco completo dei tipi di dati disponibili e dei relativi campi, consulta le classi in Jetpack.
Attributi dei metadati
I dati nell'API Health Connect includono anche gli attributi dei metadati descritti nel seguente elenco:
- ID Connessione Salute:a ogni punto di dati viene assegnato un identificatore univoco (UID) al momento della creazione. Questa opzione è utile per le operazioni di lettura e scrittura standard. Per ulteriori dettagli, consulta ID Connessione Salute.
- Ora dell'ultima modifica:questo timestamp indica l'ultima volta che un record è stato aggiornato. Viene generato automaticamente alla prima creazione del record o a ogni aggiornamento.
- Origine dati:Health Connect memorizza le informazioni sull'app da cui provengono i dati. Contiene il nome del pacchetto dell'origine, che viene aggiunto automaticamente al momento della creazione.
- Dispositivo:Health Connect memorizza le informazioni sul dispositivo da cui provengono i dati. Solo il tipo di dispositivo è obbligatorio; tutti gli altri campi (produttore, modello, nome visualizzato e identificatore univoco del dispositivo (UDI)) sono facoltativi.
- ID client:Health Connect fornisce ID client in modo che le app client possano fare riferimento ai dati utilizzando i propri ID, il che aiuta a risolvere i conflitti e semplifica la sincronizzazione. Queste informazioni vengono fornite manualmente al record.
- Versione del record client:insieme all'ID client, Health Connect fornisce il controllo delle versioni per facilitare il monitoraggio delle modifiche durante la sincronizzazione dei dati. viene fornito manualmente al record.
- Metodo di registrazione:Health Connect ti consente di capire come vengono registrati i dati. Questi metodi includono app che registrano i dati in modo passivo (automatico) e utenti che registrano i dati in modo attivo o manuale.
ID Health Connect
Health Connect assegna identificatori univoci (UID) agli oggetti dati appena inseriti, che identificano gli oggetti dati e li distinguono dagli altri. Gli ID Health Connect sono utili nelle richieste di lettura o scrittura. Gli ID Health Connect non sono identici agli ID client. Un'app client assegna ID client, mentre Health Connect assegna esclusivamente ID Health Connect.
Tieni presente le seguenti note quando utilizzi gli ID Health Connect:
- Le sessioni hanno un unico ID Health Connect, ma i dati all'interno delle sessioni hanno i propri ID Health Connect.
- Gli ID Health Connect non sono collegati o correlati ai timestamp.
- Alcuni casi d'uso potrebbero richiedere l'archiviazione di un ID Health Connect specifico durante un flusso di lavoro. Ad esempio, è necessario un ID specifico per recuperare e mostrare a un utente la voce di dati appena registrata.
Tempo in Health Connect
Tutti i dati scritti in Connessione Salute devono specificare le informazioni sull'offset del fuso orario. La specifica dell'offset della zona consente alle app di leggere i dati per rappresentarli in ora civile. L'ora civile è l'ora locale e pertinente per l'utente, ma non necessariamente in tempo universale coordinato (UTC).
In rare circostanze, l'offset della zona potrebbe non essere disponibile. Quando ciò si verifica in Android 14 (livello API 34), Connessione Salute imposta l'offset del fuso orario in base al fuso orario predefinito del sistema del dispositivo. In Android 13 e versioni precedenti (livello API 33 e precedenti), è possibile scrivere in Connessione Salute senza specificare informazioni sull'offset del fuso orario, il che deve essere evitato il più possibile.
Impostazione di ora e zona
La specifica delle informazioni sull'offset del fuso orario durante la scrittura dei dati fornisce informazioni sul fuso orario durante la lettura dei dati in Connessione Salute. Tuttavia, potrebbe non riuscirci in determinate situazioni, ad esempio quando non viene fornito l'offset della zona. La tua app deve essere preparata per gestire entrambi i tipi di dati, in modo sensato per le tue circostanze specifiche.