查看 Health Connect 功能

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

针对记录的 CRUD 操作和数据同步

该平台针对记录的数据提供了标准的插入、更新和删除功能。健康数据共享还包含一项功能,可让客户端应用从健康数据共享中同步数据。这将生成一个数据更改日志,向开发者和用户显示特定数据类型是否已由其他应用插入或删除。

基本聚合函数

客户端可以针对底层数据应用聚合函数,从而提供以下信息:

  • 平均值、最小值或最大值(例如活动时段的最低心率和最高心率)。
  • 总数(例如每日的总步数)。
  • 底层测量次数的简单计数(例如,某一周的活动时段数)。
  • 所支持数据类型的总时长(例如,本周深层睡眠时间或今天活动时段的总时长)。

可用性检查

健康数据共享与 Android SDK 版本 28 (Pie) 及更高版本兼容。 借助此 SDK,客户端应用可以确定用户的 Android 设备上是否具有 Health Connect API。如果没有,则健康数据共享会触发可用性检查,以确定用户的设备是否兼容。

权限检查

健康数据共享要求您按应用请求用户授予读取和写入其健康与健身数据的权限。您还可以查看用户已经授予或拒绝了哪些权限。

通过 Health Connect 读取

前台读取

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

对于您的应用可能预计中断的情况(例如在应用中显示所读取数据),请直接将数据从 Health Connect 读取至客户端应用。

如果您希望应用在运行时不出现中断,请使用前台服务

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

  • FOREGROUND_SERVICE_TYPE_SHORT_SERVICE:一种通用类型的服务,可让应用继续收集耗时不到三分钟的任务的关键数据,即使在任务完成之前用户将应用置于后台也是如此。

后台读取

您可以请求让应用在后台运行并从“健康数据共享”读取数据。如果您请求后台读取权限,用户可以授予您的应用在后台读取数据的权限。