Recursos de saúde no Wear OS

Os Recursos de saúde são um serviço incluído no Wear OS 3 versões mais recentes. Os Recursos de saúde atuam como intermediários dos vários sensores e respectivos algoritmos do dispositivo para fornecer aos apps dados de alta qualidade relacionados a atividades físicas, exercícios e saúde do usuário.

A API Health Services está na versão Beta e pronta para uso em produção.

Consulte o repositório de exemplos dos Recursos de saúde (link em inglês) no GitHub para conferir alguns exemplos de apps fitness.

Como os Recursos de saúde ajudam os desenvolvedores de apps

Sem os Recursos de saúde, os apps precisam se conectar a um ou vários sensores, configurar cada um deles adequadamente, receber dados brutos e usar os próprios algoritmos para gerar informações relevantes. Por exemplo, para mostrar as variações de elevação durante uma sessão de atividade do usuário, um app poderia se registrar para detectar atualizações de Sensor.TYPE_PRESSURE e receber a pressão do ar, usá-la para calcular a altitude e agregar esses dados ao longo do tempo.

Os Recursos de saúde configuram automaticamente todos os sensores relacionados ao condicionamento físico e à saúde da forma adequada para cada caso de uso, além de coletar dados do sensor e calcular métricas, como frequência cardíaca, distância, calorias, elevação, andares, velocidade e ritmo, entre outras. Assim, os apps podem se registrar para receber esses dados diretamente nos Recursos de Saúde.

with-health-services

Veja alguns dos benefícios de usar os Recursos de saúde:

  • Aproveitar os algoritmos avançados executados de forma nativa na plataforma.
  • Economizar bateria usando as configurações de sensor dos Recursos de Saúde, que são otimizadas em relação ao consumo de bateria.
  • Preparar o app para ter suporte a dispositivos com Wear 3 ou mais recente. A API Health Services é consistente em todos os dispositivos Wear 3 e mais recentes, o que facilita a atualização do app.
  • Garantir a consistência de dados em todos os aplicativos no mesmo dispositivo, com o uso da cálculos de plataforma padronizados.
  • Ativar experiências com reconhecimento de atividade, incluindo a capacidade de detectar um exercício em andamento iniciado em outro app.

Esses benefícios permitem que os desenvolvedores se concentrem no desenvolvimento de recursos e experiências do usuário exclusivas do app, podendo contar com a plataforma para fornecer métricas robustas e consistentes de maneira eficiente em termos de energia.

Conceitos dos Recursos de saúde

Use os conceitos apresentados a seguir ao desenvolver apps usando os Recursos de saúde.

Tipos de dados

Os Recursos de saúde oferecem uma variedade de dados coletados de todas as fontes disponíveis no dispositivo, que são atualizados continuamente. Os dados se enquadram em duas categorias gerais: amostras de dados de um único momento, como HEART_RATE_BPM, e dados coletados em um intervalo de tempo, como DISTANCE.

Para saber mais, consulte a lista completa de Tipos de dados.

Eventos

Os apps recebem eventos quando o usuário atinge um determinado estado ou evento. Por exemplo, quando um usuário define uma meta de distância em um app de exercício, o app envia uma notificação informando a distância percorrida. Também é possível usar uma meta passiva para situações em que o usuário alcança determinada contagem de passos ou adormece.

Para saber mais, consulte Metas de exercício e Metas passivas.

Tipos de exercício

Os Recursos de saúde tratam a atividade física como um recurso de primeira classe e oferecem suporte a diversos tipos de exercício, como corrida ou esqui. Enquanto um exercício está em andamento, os Recursos de saúde coletam métricas sobre os tipos de dados selecionados e as informam ao app que gerencia o exercício.

Para saber mais, consulte a lista completa de tipos de exercício.

Criar apps usando os Recursos de saúde

Crie apps usando os Recursos de saúde, conforme descrito nas seções a seguir.

Experiências passivas

Com o PassiveMonitoringClient, seu app implementa um PassiveListenerService que recebe atualizações sobre um tipo de dados ou evento. Esse recurso é usado para experiências de longa duração, em que as atualizações de dados são menos frequentes.

Consulte Atualizações de dados passivos para mais informações.

Experiências ativas

Com o MeasureClient, o app registra listeners para receber atualizações de dados rápidas. Esse recurso é útil para experiências de curta duração, como quando o usuário olha para a interface do app. Tente minimizar o tempo que o app gasta com um listener registrado, porque ele aumenta a taxa de amostragem dos sensores e, portanto, causa aumento do consumo de bateria. Essa API não é destinada a detecção de dados em segundo plano ou monitoramento de treinos.

Consulte Fazer medições de saúde com o MeasureClient para mais informações.

Com o ExerciseClient, seu app pode gerenciar o treino de um usuário, definir metas de atividade física e detectar atualizações sobre o estado do exercício. O app também pode receber atualizações rápidas de dados usando essa API, desde que o exercício tenha sido criado por ele. O ExerciseClient pode ser usado, por exemplo, em apps de corrida, já que ele permite que os usuários gravem informações sobre a atividade, mostrem métricas em tempo real no dispositivo e registrem dados para análises mais detalhadas.

Consulte Gravar um exercício com o ExerciseClient para mais informações.

Testar com dados sintéticos

Para testar se o app está recebendo atualizações de dados dos Recursos de Saúde, configure o dispositivo manualmente para emitir dados como se um usuário estivesse fazendo um exercício.

Consulte Usar dados sintéticos com os Recursos de saúde para mais informações.