Analisar a funcionalidade do app Conexão Saúde
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-27 UTC."],[],[],null,["# Review Health Connect functionality\n\nThis page describes the main functions of the Health Connect API.\n\nCRUD operations on record and data synchronization\n--------------------------------------------------\n\nThe platform provides standard insert, update, and delete functions for recorded\ndata. Health Connect also includes functionality that allows client apps to\nsynchronize data out of Health Connect. This produces a log of data changes\nthat shows the developer and user whether certain data types have been\ninserted or deleted by other apps.\n\nBasic aggregation functions\n---------------------------\n\nClients can apply an aggregation function over underlying data, providing the\nfollowing:\n\n- The **average, minimum or maximum** values (for example, the minimum and maximum heart rate during an activity session).\n- The **sum total** (for example, the total step count in a daily interval).\n- A **simple count** of the number of underlying measurements (for example, the number of activity sessions in a given week).\n- The **total duration** on supported data types (for example, time spent in deep sleep this week, or total duration of activity sessions today).\n\nAvailability checks\n-------------------\n\nHealth Connect is compatible with Android SDK version 28 (Pie) and higher.\nThe SDK allows client apps to determine whether the Health Connect API is on\nthe user's Android-powered device. If it isn't, Health Connect triggers an\navailability check to determine whether the user's device is compatible.\n\nPermission checks\n-----------------\n\nHealth Connect requires you to request the user's permission to read and\nwrite their health and fitness data on a per-app basis. It also lets you\nsee what permissions have already been granted or denied by the user.\n\nReading with Health Connect\n---------------------------\n\n### Foreground reading\n\nYou can normally read data from Health Connect when your app is\nin the foreground. In these cases, you may consider using a foreground service\nto run this operation in case the user or system places your app\nin the background during a read operation.\n\nFor situations in which your app may expect an interruption, such as displaying\na reading in your application, read directly from Health Connect to your client\napplication.\n\nFor situations in which you prefer your app to run without\ninterruptions, use a\n[foreground service](/develop/background-work/services/fgs):\n\n- [`FOREGROUND_SERVICE_TYPE_HEALTH`](/reference/android/content/pm/ServiceInfo#FOREGROUND_SERVICE_TYPE_HEALTH): Allows app to remain in\n the foreground to collect sensor data, such as a workout app that continues\n to collect data even when the user puts the app in the background.\n\n- [`FOREGROUND_SERVICE_TYPE_SHORT_SERVICE`](/reference/android/content/pm/ServiceInfo#FOREGROUND_SERVICE_TYPE_SHORT_SERVICE): A generic-type\n service that allows an app to continue to collect critical data for\n tasks that take less than three minutes,\n even if the user places the app in the background before it completes.\n\n### Background reading\n\nYou can request that your application run in the background and read data from\nHealth Connect. If you request the\n[Background Read](/health-and-fitness/guides/health-connect/develop/read-data#background-read-example)\npermission, your user can grant your app access to read data in the background."]]
