查看 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:一种通用型服务,可让应用继续收集耗时不到 3 分钟的任务的关键数据,即使用户在任务完成之前将应用置于后台也是如此。

后台读取

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