Os tipos de dados na Conexão Saúde são armazenados em objetos que são subclasses de
Record.
Para cada tipo de dado, há campos associados que são genéricos, como
time e zoneOffset, ou específicos, como title, count e percentage.
Alguns campos usam tipos básicos, como long, double ou string, enquanto outros usam tipos complexos, como enumerações e classes como Instant e ZoneOffset. Os atributos desses campos podem ser obrigatórios ou opcionais. Alguns atributos são somente leitura, e outros são fixados em um intervalo específico de valores.
Para conferir a lista completa de tipos de dados disponíveis e os campos deles, consulte as classes no Jetpack.
Atributos de metadados
Os dados da API Health Connect também incluem atributos de metadados descritos na lista a seguir:
- ID do Conexão Saúde: cada ponto de dados recebe um identificador exclusivo (UID, na sigla em inglês) após a criação. Isso é útil para operações padrão de leitura e gravação. Consulte ID da Conexão Saúde para mais detalhes.
- Horário da última modificação:marca o carimbo de data/hora da última instância em que um registro teve uma atualização. Ele é gerado automaticamente na primeira criação do registro ou em cada atualização.
- Origem de dados:o Conexão Saúde armazena informações sobre o app de origem dos dados. Ele contém o nome do pacote dessa origem, que é adicionado automaticamente após a criação.
- Dispositivo: o Conexão Saúde armazena informações sobre o dispositivo de origem dos dados. Ele contém o fabricante e o modelo do dispositivo, informados por você manualmente.
- ID do cliente:o Conexão Saúde oferece IDs de cliente para que os apps cliente possam consultar dados usando os próprios IDs, o que ajuda na resolução de conflitos e facilita a sincronização. Isso é fornecido ao registro manualmente.
- Versão do registro do cliente:além do ID do cliente, o Conexão Saúde oferece o controle de versão para ajudar a rastrear as mudanças durante a sincronização de dados. Isso é fornecido ao registro manualmente.
- Método de gravação:o Conexão Saúde permite entender como os dados são gravados. Esses métodos incluem apps que registram dados de forma passiva (automática) e usuários que registram dados de forma ativa ou manual.
ID da Conexão Saúde
O Conexão Saúde atribui identificadores exclusivos (UIDs) a objetos de dados recém-inseridos, que identificam e distinguem os objetos de dados de outros. Os IDs do Conexão Saúde são úteis em solicitações de leitura ou gravação. Os IDs da Conexão Saúde não são idênticos aos IDs do cliente. Um app cliente atribui IDs do cliente, enquanto o Conexão Saúde atribui IDs da Conexão Saúde de forma exclusiva.
Tenha em mente as seguintes observações ao trabalhar com IDs do Conexão Saúde:
- As sessões têm um único ID da Conexão Saúde, mas os dados delas têm IDs próprios.
- Os IDs da Conexão Saúde não são vinculados nem estão relacionados a carimbos de data/hora.
- Alguns casos de uso podem exigir o armazenamento de um ID específico do Conexão Saúde durante um fluxo de trabalho. Por exemplo, um ID específico é necessário para recuperar e mostrar a um usuário a entrada de dados que ele acabou de registrar.
Tempo no Conexão Saúde
Todos os dados gravados no Conexão Saúde precisam especificar as informações de deslocamento da zona. Especificar o deslocamento da zona permite que os apps leiam os dados para representá-los em tempo civil. Tempo civil é o horário local e relevante para o usuário, não necessariamente no horário universal coordenado (UTC, na sigla em inglês).
Em algumas circunstâncias raras, o deslocamento de zona pode não estar disponível. Quando isso ocorre no Android 14 (nível 34 da API), a Conexão Saúde define o ajuste de fuso horário com base no fuso horário padrão do sistema do dispositivo. No Android 13 e versões anteriores (nível 33 da API e versões anteriores), é possível gravar no Conexão Saúde sem especificar informações de deslocamento de zona, o que deve ser evitado sempre que possível.
Configuração de horário e fuso
A especificação das informações de deslocamento da zona durante a gravação de dados fornece informações de fuso horário ao ler dados no Conexão Saúde. No entanto, ela pode não fazer isso em determinadas situações, por exemplo, quando o deslocamento da zona não é fornecido. Seu app precisa estar preparado para lidar com os dois tipos de dados de uma forma que faça sentido para suas circunstâncias específicas.