此页面列出了一些常见问题及其答案。
问:Health Connect 是否只在 Android 平台上可用?
答:是的。Health Connect API 和 Health Connect 应用都只在 Android 平台上可用。
有关 Wear OS 上的健康传感器数据用例,请参阅 Health Services API 文档。
问:如何访问 Health Connect?
答:访问 Health Connect 的方法取决于您设备上运行的 Android 版本
- 在 Android 14 上,Health Connect 是 Android 系统的一部分。您可以通过依次前往设置 > 安全与隐私 > 隐私,然后查找Health Connect来访问 Health Connect。
在支持 Health Connect 的较低 Android 版本(包括 Android 13)上,Health Connect 是一个公开可用的应用,您可以从 Google Play 商店下载。您可以通过以下任一方式访问该应用
- 前往设置 > 应用,查找 Health Connect,然后打开它。
- 使用快速设置(可在系统托盘中找到)配置 Health Connect 的快速访问。
- 前往 Health Connect 的 Google Play 商店页面,然后点击打开。
问:健康数据如何从 Android 13 迁移到 Android 14?
答:从 Android 13 的 Health Connect APK 迁移到 Android 14 的 Health Connect 系统应用会在您升级到 Android 14 后立即自动开始。
在迁移过程中,Android 14 API 会暂停并显示“正在迁移”状态。该状态也会在 Health Connect UI 中显示。迁移完成后,您可以卸载独立的 Health Connect APK。
有关详细信息,请查看Android 13 到 Android 14 迁移指南。
问:Health Connect 是否支持未安装 Google Play 服务的 Android 手机?
答:不支持。Health Connect 有一定的兼容性要求,包括移动设备必须运行 Android 9 (API 28) 或更高版本,并且安装了 Google Play 服务。
问:Health Connect 与 Google Fit 相比如何?
答:下表描述了两个 API 之间的主要架构差异
Health Connect | Google Fit |
---|---|
以设备为中心 Health Connect 以设备为中心。数据存储在用户的设备上,而不是与特定的 Google 账号关联。 | 以 Google 账号为中心 Google Fit 以账号为中心。数据存储在服务器端基础设施上。其数据模型完全与特定的 Google 账号而非用户的设备绑定。这使得服务器成为 Google Fit 中的事实来源。 |
细粒度权限 用户可以通过 Health Connect 细粒度地控制哪些应用具有对每种数据类型的读取或写入访问权限。 | 基于 OAuth 的权限 Google Fit 中的权限需要额外的工作,因为它们基于 OAuth 身份验证。OAuth 范围也可能涵盖更多的数据类型。 |
少量数据处理 Health Connect 涉及的数据处理和派生非常少,除了 Basal Calories(基础卡路里)和 Basal Metabolic Rate (BMR)(基础代谢率)等数据类型的一些小例外。因此,开发者将通过 Health Connect 访问更多原始数据。 | 特定服务的数据处理 Google Fit 处理更多数据,将某些数据类型转换为其他类型或进行合并。Google Fit 处理特定服务的数据,而不是像 Health Connect 那样提供对原始数据的访问。 |
问:Health Connect 存储是基于设备还是基于云?
答:Health Connect 提供设备端存储。我们的目标是创建一个系统,让用户完全控制自己的数据,以及他们与哪些应用和服务共享数据。
问:哪些移动设备可以使用 Health Connect 应用?
答:只有运行 Android 9 (API 28) 或更高版本的移动设备才能使用 Health Connect 应用。这些设备还必须安装 Google Play 服务。
问:Jetpack 中是否存在 Java SDK?将来会添加吗?
答:Health Connect SDK 仅支持 Kotlin。我们目前没有立即计划在 Jetpack 库中添加 Java SDK。但是,我们最终可能会根据开发者的反馈支持两种编程语言。
问:Health Connect 可以读取或写入的历史数据范围是多少?
答:Health Connect 允许您的应用读取在您的应用首次成功请求权限之前最多 30 天内具有 time
或 startTime
的记录。如果您希望您的应用读取 30 天后的记录,请使用 PERMISSION_READ_HEALTH_DATA_HISTORY
权限。如果您的应用被卸载后重新安装,日期会重置,这将标记为您的新开始日期,就像您第一次使用该应用一样。
您与 Health Connect 共享的数据没有限制,但目前请避免写入大量历史数据。同样,请避免写入与未来事件相关的数据,例如预测的MenstruationPeriodRecord
。
问:如果我在集成 Health Connect 方面需要帮助,应该联系谁?
答:如果您有任何关于 Health Connect 集成的技术问题、疑虑或遇到问题,请向 Health Connect 开发者支持提交工单。
我们的支持专家会努力尽快且全面地回答开发者问题。同时,您可以查阅 Health Connect 文档以获取您可能需要的任何指导。
问:如何声明对读写数据类型的访问权限?
答:要让您的应用具有对 Health Connect 数据类型的读写访问权限,请使用 Play 管理中心声明您的应用访问这些类型。