查看平台架构

SDK、客户端应用和权限管理。keywords_public: 健康数据共享, 架构, Android SDK, 客户端应用, APK, 数据管理, CRUD, 聚合

健康数据共享旨在促进客户端应用与健康数据共享 API 之间的快速便捷集成。

下图显示了客户端应用通过 SDK 层和 IPC(进程间通信)与 Health Connect API 集成:

每项健康类功能旁边都会显示一个复选框
图 1.健康数据共享架构图

SDK 支持

借助此 SDK,客户端应用可以确定用户的设备上是否具有健康数据共享 API。如果没有,则会触发可用性检查,以确定设备是否兼容。

健康数据共享 SDK 至少支持 Android 8(API 级别 26),而健康数据共享应用仅与 Android 9(API 级别 28)或更高版本兼容。这意味着第三方应用可以支持使用 Android 8 的用户,但只有使用 Android 9 或更高版本的用户才能使用健康数据共享。

发布渠道可用情况

健康数据共享 功能在 Alpha稳定 渠道中发布。如需详细了解特定版本,请参阅 健康数据共享客户端版本

Alpha 渠道

网站上记录的所有功能均可用。

稳定渠道

所有记录的功能, 扩展设备类型除外

架构组件

本部分详细介绍了构成健康数据共享架构的关键组件,包括 SDK、客户端应用、健康数据共享 APK 及其权限和数据管理功能。

1. 软件开发套件

SDK 可让客户端应用通过 IPC 与健康数据共享 APK 进行通信。

2. 客户端应用

为了与健康数据共享集成,客户端应用会将 SDK 关联到其健康与健身应用。这提供了一个有助于与健康数据共享 API 进行交互的 API Surface。

3. Health Connect APK

健康数据共享 APK 是健康数据共享 API 的主要元素,包含权限管理和数据管理组件。健康数据共享 APK 直接在用户设备上提供。

4. 权限管理

健康数据共享包含一个界面,应用可通过该界面请求用户授予显示数据的权限。

它还提供现有用户权限的列表,让用户可以控制对多个应用中数据的访问权限。

5. 数据管理

健康数据共享 提供一个界面,其中显示了所记录数据的概览,包括用户的步数、骑车速度、心率以及其他 支持的数据类型。其数据管理功能包括:

  • CRUD 操作和数据同步:该平台针对数据提供了标准的 插入、更新和删除功能。它还包含供客户端应用同步数据的功能,该功能会生成一个数据更改日志,显示数据是否已由其他应用插入或删除。

  • 基本聚合函数:客户端可以将聚合函数应用于 数据,包括:

    • 平均值、最小值或最大值,例如会话期间的最低心率或最高心率。
    • 总和,例如一天的总步数。
    • 测量次数,例如一周的活动会话数。
    • 所支持数据类型的总时长,例如深度睡眠时间。
  • 通过 Health Connect 读取:Health Connect 允许应用在应用位于前台时读取用户的 健康与健身数据,或者在用户授予 权限的情况下,在后台运行时读取用户的健康与健身数据。

    • 前台读取:当应用 位于前台时,您可以从 Health Connect 读取数据;对于较长的操作,建议使用 前台服务以防止中断。
    • 后台读取:用户可以向您的应用授予在后台运行时从 Health Connect 读取数据的权限。