Esta página descreve as principais funções da API Health Connect.
Operações CRUD durante a sincronização de dados e registros
A plataforma oferece funções padrão de inserir, atualizar e excluir dados gravados. A Conexão Saúde também inclui uma funcionalidade que permite que apps clientes sincronizem dados fora da Conexão Saúde. Isso produz um registro de mudanças de dados que mostra ao desenvolvedor e ao usuário se determinados tipos de dados foram inseridos ou excluídos por outros apps.
Funções básicas de agregação
Os clientes podem aplicar uma função de agregação aos dados, fornecendo o seguinte:
- Os valores médio, mínimo ou máximo (por exemplo, a frequência cardíaca mínima e máxima durante uma sessão de atividade).
- A soma total (por exemplo, a contagem total de passos em um intervalo diário).
- Uma contagem simples do número de medições, como o número de sessões de atividade em uma determinada semana.
- A duração total nos tipos de dados com suporte, por exemplo, o tempo gasto em sono profundo esta semana ou a duração total das sessões de atividade hoje.
Verificações de disponibilidade
A API do Conexão Saúde é compatível com o SDK do Android versão 28 (Pie) e mais recentes. O SDK permite que apps clientes determinem se a API Health Connect está no dispositivo Android do usuário. Se não estiver, o Conexão Saúde vai acionar uma verificação de disponibilidade para determinar se o dispositivo do usuário é compatível.
Verificações de permissão
A Conexão Saúde exige que você solicite a permissão do usuário para ler e/ou gravar os dados de saúde e condicionamento físico dele em cada app. Ele também permite que você veja quais permissões já foram concedidas ou negadas pelo usuário.
Como ler dados com o Conexão Saúde
Apenas aplicativos em execução em primeiro plano podem ler dados com o Conexão Saúde. Essa restrição está em vigor para proteger ainda mais a privacidade do usuário. O Conexão Saúde notifica e garante aos usuários que ele não tem acesso de leitura em segundo plano aos dados deles e que só pode ler e acessar dados em primeiro plano.
Para situações em que seu app pode esperar uma interrupção, como ao mostrar uma leitura, leia diretamente do Conexão Saúde para o aplicativo cliente.
Para situações em que você queira que o app seja executado sem interrupções, como ao ler um intervalo de dados do Conexão Saúde e depois gravar e fazer upload dele para outro lugar, use um ForegroundService em vez de uma atividade que pode ser facilmente dispensada.