常见问题解答

此页面列出了一些常见问题及其答案。

问: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 细粒度地控制哪些应用具有对每种数据类型的读取或写入访问权限。

Health Connect 受益于内置的自定义权限机制。这使得 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 天内具有 timestartTime 的记录。如果您希望您的应用读取 30 天后的记录,请使用 PERMISSION_READ_HEALTH_DATA_HISTORY 权限。如果您的应用被卸载后重新安装,日期会重置,这将标记为您的新开始日期,就像您第一次使用该应用一样。

您与 Health Connect 共享的数据没有限制,但目前请避免写入大量历史数据。同样,请避免写入与未来事件相关的数据,例如预测的MenstruationPeriodRecord

问:如果我在集成 Health Connect 方面需要帮助,应该联系谁?

答:如果您有任何关于 Health Connect 集成的技术问题、疑虑或遇到问题,请向 Health Connect 开发者支持提交工单。

我们的支持专家会努力尽快且全面地回答开发者问题。同时,您可以查阅 Health Connect 文档以获取您可能需要的任何指导。

问:如何声明对读写数据类型的访问权限?

答:要让您的应用具有对 Health Connect 数据类型的读写访问权限,请使用 Play 管理中心声明您的应用访问这些类型