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