本页介绍了 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 读取数据。如果您请求后台读取权限,用户可以授予您的应用在后台读取数据的权限。