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 funcionalidade 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 subjacentes (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 de 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
Normalmente, é possível ler dados da Conexão Saúde quando o app está em primeiro plano. Nesses casos, use um serviço em primeiro plano para executar essa operação caso o usuário ou o sistema coloque o app em segundo plano durante uma operação de leitura.
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ê prefere que o app seja executado sem interrupções, use um serviço em primeiro plano:
FOREGROUND_SERVICE_TYPE_HEALTH: permite que o app permaneça em primeiro plano para coletar dados do sensor, como um app de treino que continua coletando dados mesmo quando o usuário coloca o app em segundo plano.FOREGROUND_SERVICE_TYPE_SHORT_SERVICE: um serviço de tipo genérico que permite que um app continue coletando dados importantes para tarefas que levam menos de três minutos, mesmo que o usuário coloque o app em segundo plano antes da conclusão.
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.