常见问题解答

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

问: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 天的记录。如果您希望应用在 30 天后读取记录,请使用 PERMISSION_READ_HEALTH_DATA_HISTORY 权限。如果用户卸载您的应用,然后重新安装,系统会重置此日期,并将其标记为新开始日期,就像您是首次使用该应用一样。

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

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

:如果您在 Health Connect 集成方面遇到任何技术问题、疑问或疑虑,请与 health-connect-support@google.com 联系。

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

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

:为了让您的应用对 Health Connect 数据类型拥有读取或写入权限,请使用 Play 管理中心声明您的应用会访问这些类型的数据