此页面介绍了 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 读取一系列数据,然后将其写入并上传到其他位置),请使用前台服务,而不是活动,因为活动很容易被关闭。