常见问题解答

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

问: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 14 后,系统即会自动开始从 Android 13 的 Health Connect APK 迁移到 Android 14 的 Health Connect 系统应用。

在迁移过程中,Android 14 API 会被暂停,并显示为“迁移中”状态。状态也会显示在 Health Connect 界面中。迁移完成后,您可以卸载独立的 Health Connect APK。

如需了解详情,请参阅 Android 13 到 Android 14 迁移指南

问:Health Connect 是否支持未安装 Google Play 服务的 Android 手机?

:不支持。Health Connect 有特定的兼容性要求,包括移动设备需搭载 Android 9 (API 28) 或更高版本,已安装 Google Play 服务。

问:Health Connect 和 Google 健身有何区别?

:下表介绍了这两个 API 的架构的关键区别:

Health Connect Google 健身
以设备为中心

Health Connect 以设备为中心。数据会存储在用户的设备上,而不是与特定 Google 帐号相关联。

以 Google 账号为中心

Google 健身以账号为中心。数据会存储在服务器端基础架构上。其数据模型完全与特定的 Google 帐号(而非用户的设备)相关联。这就使服务器成为了 Google 健身中的可信来源。

细化权限

用户可以通过 Health Connect 精确控制哪些应用对每种数据类型拥有读取或写入权限。

Health Connect 受益于内置的自定义权限机制。这样,Health Connect 就可以集中管理和优化权限的管理和分配方式。

基于 OAuth 的权限

Google 健身中的权限需要执行额外的操作,因为这些权限基于 OAuth 身份验证。OAuth 范围还可能会涵盖更多数据类型。

极少处理数据

Health Connect 涉及的数据处理和派生操作极少,只有基础卡路里数和基础代谢率 (BMR) 等少数数据类型例外。因此,开发者将可以通过 Health Connect 访问更多原始数据。

特定于服务的数据处理

Google 健身会处理更多数据,它会将一些数据类型转换为其他数据类型,还会合并数据类型。Google 健身会为特定服务处理数据,而不像 Health Connect 那样提供原始数据的访问权限。

问:Health Connect 的存储是基于设备还是云端?

:Health Connect 提供设备端存储。我们的目标是打造一个系统,让用户不仅能够全面控制自己的数据,还能控制与哪些应用和服务分享这些数据。

问:哪些移动设备可以使用 Health Connect 应用?

:只有搭载 Android 9 (API 28) 或更高版本的移动设备才能使用 Health Connect 应用。这些设备还必须安装 Google Play 服务。

问:Jetpack 上存在 Java SDK 吗?最终会添加此 SDK 吗?

:Health Connect SDK 仅支持 Kotlin。我们目前没有将 Java SDK 添加到 Jetpack 库的计划。不过,我们最终可能会同时支持这两种编程语言,具体取决于开发者的反馈。

问:Health Connect 可以读取或写入多大范围内的历史数据?

:借助 Health Connect,您的应用可以读取 timestartTime 最多在第一次成功请求权限之前 30 天的记录。如果用户卸载您的应用,然后重新安装,系统会重置该日期,并将其标记为新的开始日期,就像您是首次使用它一样。

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

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

:如果您对 Health Connect 集成有任何技术问题、疑问或疑虑,请联系 health-connect-support@google.com

我们的支持专家会尽量快速而全面地回复开发者的问题。在此期间,请参阅 Health Connect 文档以获取任何所需指导。

问:如何请求对数据类型的读取或写入权限?

:为了让您的应用对 Health Connect 数据类型拥有读取或写入权限,请填写开发者声明表单提交申请。如需了解详情,请参阅请求对 Health Connect 数据类型的访问权限