Android API

Android 版 Google 健身 API 是 Google Play 服务的一部分。Google 健身 API 支持 Android 4.1（API 级别 16）及更高版本。借助这些 API，您的应用可以执行以下操作：

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

读取传感器数据

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

记录数据

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

Google 健身图表
图 1. Android 设备上的 Google 健身。

历史数据

如果您希望用户能够查看以往活动的健身数据，可以使用 History API。此 API 可用于访问历史健康和健身数据，并允许应用执行批量操作，例如插入、删除和读取数据。

会话

健身数据本身就很有用，但如果将其与用户活动的其他信息相结合，则会更有用。Sessions API 会将健康和健身数据以及一些元数据捆绑到称为sessions的单元中。会话表示用户进行某项健身活动的时间间隔。

查看和设置目标

您的应用可以显示用户的健身活动与所设目标的比较情况，从而帮助激励用户。目标 API 可帮助您的应用向用户显示他们创建的健康和健身目标。