本页列出了一些常见问题及其解答。
问: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 精确控制哪些应用对各个数据类型拥有读取或写入权限。 | 基于 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,您的应用可以读取 time
或 startTime
最多在第一次成功请求权限之前 30 天的记录。如果您希望应用在 30 天后读取记录,请使用 PERMISSION_READ_HEALTH_DATA_HISTORY
权限。如果用户卸载您的应用,然后重新安装,系统会重置此日期,并将其标记为新开始日期,就像您是首次使用该应用一样。
虽然对共享给 Health Connect 的数据没有限制,但目前请避免写入大量历史数据。同样,请避免写入与未来事件相关的数据,例如关于预测的 MenstruationPeriodRecord
的数据。
问:如果我在与 Health Connect 集成方面需要帮助,应该与谁联系?
答:如果您在 Health Connect 集成方面遇到任何技术问题、疑问或疑虑,请与 health-connect-support@google.com 联系。
我们的支持专家会尽量快速而全面地回复开发者的问题。与此同时,请参阅 Health Connect 文档,以获取任何所需指导。
问:如何声明对数据类型的读取或写入权限?
答:为了让您的应用对 Health Connect 数据类型拥有读取或写入权限,请使用 Play 管理中心声明您的应用会访问这些类型的数据。