Google 产品组合中有许多健康产品和服务,其中包括 Health Connect。我们已弃用 Google Fit API,并会在 2025 年 6 月 30 日之前停止使用这些 API。以下指南介绍应从各 Google Fit Android API 迁移到哪个 API 或平台。
从 Fit Android API 迁移到 Health Connect API
迁移到 Health Connect API 需要完成 3 个主要步骤。
第 1 步:集成
第一步的集成是将 Health Connect 添加到您的应用中。这一步包括以下操作:
- 按照这些开始使用步骤与 Health Connect 集成。
- 在应用清单中声明所需的数据类型和访问模式。
- 向用户请求访问 Health Connect 的权限。
- 根据具体的用例或工作流读/写数据。
第 2 步:迁移
当用户在 Google 健身和 Health Connect 这两个平台间迁移时,建议让 Google Fit Android API 集成和 Health Connect API 集成都保持有效。虽然我们已弃用 Google Fit Android API,但计划最晚于 2025 年 6 月 30 日停用该 API。这是为了让用户有充足的时间改用 Health Connect 并继续提供服务。
第 3 步:清理
请按照以下步骤移除 Google 健身 SDK:
- 移除与 Google 健身 Android API 关联的代码。
- 移除 Google Play 服务依赖项。
Sensor API
Sensor API 可用于在应用中实时读取原始传感器数据。Sensor API 执行以下操作:
- 列出设备和配套设备上可用的数据源。
- 注册用于接收原始传感器数据的监听器。
- 取消注册监听器,使其不再接收原始传感器数据。
请从 Sensor API 迁移到以下 API 或平台:
手机 | Wear |
使用 SensorManager、FusedLocationProvider |
使用健康服务
|
Session API
会话表示用户进行某项健身活动的时间间隔。
Session API 可让应用在健身数据存储区中创建会话。
请从 Session API 迁移到以下 API 或平台:
手机 | Wear |
开始/停止:不适用。应用应在内部跟踪正在进行的会话的状态。 读/写:使用 Health Connect。 |
启动/停止:使用健康服务 (ExerciseClient) 读/写:通过移动应用使用 Health Connect。 对于具体的工作流程,我们建议:
|
Recording API
Recording API 可让应用通过创建订阅,请求以省电的方式自动存储传感器数据。订阅与 Android 应用相关联,包含一个健身数据类型或一个特定的数据源。
请从 Recording API 迁移到以下 API 或平台:
手机 | Wear |
请按以下步骤从 Recording API 迁移:
|
使用健康服务
如需详细了解 PassiveMonitoringClient 和 ExerciseClient 之间的区别,请参阅健康服务文档。 |
History API
History API 可让应用对健身数据存储区执行批量操作,包括读取、插入、更新和删除身心健康方面的历史数据。
请从 History API 迁移到以下 API 或平台:
手机 | Wear |
使用 Health Connect |
通过移动应用(而非穿戴式设备)使用 Health Connect。 |
Goals API
目标是指用户可以在 Google 健身应用中为自己设置的目标。目标可以激励用户每天保持活力。用户可以在个人资料中调整每天希望达到的步数和心肺强化分数目标。Google 健身平台使用 Goals API 记录用户的目标,并对照这些目标跟踪用户每天的活动。
手机 | Wear |
没有可用的替代 API。 | 没有可用的替代 API。 |
BLE API
应用可以使用 BLE API 查找可用的蓝牙低功耗 (BLE) 设备,并将传感器数据插入 Google 健身平台中。
请从 BLE API 迁移到以下 API 或平台:
手机 | Wear |
直接使用 Android Bluetooth API。 | 直接使用 Android Bluetooth API。 |