本页介绍了 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 读取至客户端应用。
对于您希望应用在运行时不出现中断的情况(例如从 Health Connect 读取一系列数组,然后将这些数据写入并上传到别的地方),请使用 ForegroundService,而不是可轻松关闭的 activity。
后台读取
您可以请求让应用在后台运行并从 Health Connect 读取数据。如果您请求后台读取权限,用户可以授予您的应用在后台读取数据的权限。