Esta página descreve as principais funções da API Conexão Saúde.
Operações CRUD durante a sincronização de dados e registros
A plataforma oferece funções padrão para inserir, atualizar e excluir dados gravados. A Conexão Saúde também inclui uma função que permite que os apps cliente sincronizem dados fora do app 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 de agregação básicas
Os clientes podem aplicar uma função de agregação aos dados subjacentes, 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, por exemplo, o número de sessões de atividade em uma determinada semana.
- A duração total dos tipos de dados com suporte, por exemplo, o tempo passado em sono profundo na semana ou a duração total das sessões de atividade no dia.
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 do Conexão Saúde está instalada no dispositivo Android do usuário. Se não estiver, o app Conexão Saúde aciona 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 gravar os dados de saúde e condicionamento físico em cada app. Ela também permite que você saiba quais permissões já foram concedidas ou negadas pelo usuário.
Como ler dados com o Conexão Saúde
Leitura em primeiro plano
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.
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, em seguida, gravar e fazer upload dele para outro lugar, use um ForegroundService em vez de uma atividade que pode ser facilmente dispensada.
Leitura em segundo plano
Você pode solicitar que o app seja executado em segundo plano e leia dados da Conexão Saúde. Se você solicitar a permissão Leitura em segundo plano, o usuário poderá conceder ao app acesso para ler dados em segundo plano.