常见问题解答

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

问: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 涉及非常少的数据处理和推导,除了诸如基础卡路里和基础代谢率 (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 天。如果您的应用被卸载然后重新安装,则日期将重置,并将此日期作为您的新起始日期,就像您第一次使用该应用一样。

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

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

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

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

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

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