Android API

Android 版 Google 健身 API 是 Google Play 服务的一部分。Android 4.1(API 级别 16)及更高版本支持 Google Fit API。使用这些 API,您的应用可以执行以下操作:

  • 读取近乎实时的历史数据,包括来自蓝牙低功耗 (BLE) 设备的数据。
  • 记录活动。
  • 将数据与会话相关联。
  • 设定健身目标。

读取传感器数据

如果您的应用提供关于用户活动的信息(例如用户每天行走步数),那么显示有关用户动作的近乎实时的数据会很有帮助。借助 Sensors API,您可以访问包含此信息的原始数据流。数据可以来自 Android 设备上提供的传感器,也可以来自配套设备(如穿戴式设备)中的传感器。

记录数据

如果您的应用需要收集、存储和同步关于用户身体活动的数据,您可以使用 Recording API。此 API 使用订阅存储健康与健身数据。您的应用指定要记录的一种或多种 activity。然后,即使您的应用未运行,Google 健身也会在后台存储指定类型的数据。还会在系统重启时恢复这些订阅。

Google 健身示意图
图 1. Android 版 Google 健身。

历史数据

如果您希望用户能够查看过去活动的健身数据,可以使用 History API。此 API 提供对历史健康与保健数据的访问权限,让应用可以执行批量操作,例如插入、删除和读取数据。

会话

健身数据本身有益,但如果您将这些数据与其他关于用户活动的信息结合起来,这些数据将更加实用。Sessions API 将健康数据与部分元数据捆绑在一起,称为“会话”单元。会话表示用户执行健身活动的时间间隔。

查看和设置目标

您的应用可以显示用户的健身活动与其设定的目标之间的对比情况,从而激励用户。Goals API 有助于您的应用向用户展示他们创建的健康和健身目标。