常见问题

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

问:Health Connect 是否仅在 Android 平台上可用?

答:是的。Health Connect API 和 Health Connect 应用仅在 Android 平台上可用。

对于 Wear OS 上的健康传感器数据用例,请参阅健康服务 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 涉及极少的数据处理和推导,对于基础卡路里和基础代谢率 (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 允许您的应用读取timestartTime 属性最多为应用首次成功请求权限之前的 30 天内的记录。如果您希望您的应用读取 30 天后的记录,请使用 PERMISSION_READ_HEALTH_DATA_HISTORY 权限。如果您的应用被卸载然后重新安装,则日期将重置,这将您的新起始日期标记为第一次使用该应用。

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

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

答:如果您有任何关于 Health Connect 集成的技术问题、故障或疑虑,请联系[email protected]

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

问:如何声明访问读取或写入数据类型?

答:为了让您的应用能够读取或写入 Health Connect 数据类型,请使用 Play Console 声明您的应用访问这些类型