查看 Health Connect 功能

本页面介绍 Health Connect API 的主要功能。

记录的 CRUD 操作和数据同步

平台为记录的数据提供标准的插入、更新和删除功能。Health Connect 还包含允许客户端应用从 Health Connect 同步数据的功能。这会生成数据更改日志,向开发者和用户显示其他应用是否插入或删除了某些数据类型。

基本聚合函数

客户端可以对底层数据应用聚合函数,提供以下功能:

  • 平均值、最小值或最大值(例如,活动会话期间的最小和最大心率)。
  • 总和(例如,每日间隔内的总步数)。
  • 底层测量值的简单计数(例如,给定周内的活动会话数量)。
  • 支持数据类型的总持续时间(例如,本周深度睡眠时间,或今天活动会话的总持续时间)。

可用性检查

Health Connect 兼容 Android SDK 版本 28 (Pie) 及更高版本。SDK 允许客户端应用确定用户的 Android 设备上是否提供 Health Connect API。如果没有,Health Connect 会触发可用性检查,以确定用户的设备是否兼容。

权限检查

Health Connect 要求您请求用户许可,以按应用为单位读取和写入其健康和健身数据。它还允许您查看用户已授予或拒绝的权限。

使用 Health Connect 读取

前台读取

当您的应用在前台运行时,您通常可以从 Health Connect 读取数据。在这些情况下,您可能需要考虑使用前台服务来运行此操作,以防用户或系统在读取操作期间将您的应用置于后台。

在您的应用可能预期中断(例如在您的应用中显示读数)的情况下,直接从 Health Connect 读取到您的客户端应用。

在您希望应用不中断运行的情况下,请使用前台服务

  • FOREGROUND_SERVICE_TYPE_HEALTH:允许应用保持在前台收集传感器数据,例如,即使在用户将应用置于后台时,锻炼应用仍继续收集数据。

  • FOREGROUND_SERVICE_TYPE_SHORT_SERVICE:一种通用服务,允许应用在任务耗时少于三分钟的情况下继续收集关键数据,即使在完成前用户将应用置于后台。

后台读取

您可以请求您的应用在后台运行并从 Health Connect 读取数据。如果您请求后台读取权限,您的用户可以授予您的应用在后台读取数据的访问权限。