本页中包含与 Google Fit API 版本相关的信息。 更新日志会按日期列出版本,并包含所有新功能、bug 修复或重大性能改进。
2021 年 8 月 2 日
写入运行状况数据类型的功能现已面向开发者正式推出。访问 Health 数据类型的授权与所有其他数据类型一致。如需了解更多详情,请参阅此处。
2021 年 4 月 27 日
我们于 2020 年 10 月 10 日宣布的授权变更的执行存在一小段延迟。授权变更现将于 2021 年 5 月 4 日起强制执行。
Google 健身开发者和用户数据政策也将于 2021 年 5 月 4 日生效。为执行 Google 健身开发者政策,我们将准时开始应用验证。
2020 年 10 月 19 日
我们一直在努力为开发者和用户增强 Google 健身的安全性和隐私保护,为此我们对 Google 健身政策和 API 做出了一些更改:
- 我们推出了新的 Google 健身开发者和用户数据政策。 请查看该政策,并根据需要对您的应用和服务进行适当更改。
- 写入访问现在仅允许应用读取其已写入的数据。如需继续从 Google 健身平台读取其他应用写入的数据,请更新您的代码以请求相关数据类型的读取权限范围。
- 心率数据有自己的范围。
- 睡眠数据有自己的范围和新的数据类型。
- 使用
SessionsClient
时,您现在需要使用FitnessOptions
中的相应方法指定应用需要访问的会话类型。
自 2020 年 10 月 19 日起,开发者将可以使用对 API 的这些变更。我们将从 2021 年 4 月 27 日开始执行这项要求。
如需了解有关这些更改的更多详细信息和说明,请参阅此处。
2019 年 3 月 21 日
Google 健身应用现在会显示写入 Android API 的睡眠时段。 详细了解如何写入和读取睡眠数据。
2018 年 11 月 19 日
我们对 Google Fit API 进行了以下更改:
- 针对
com.google.location.sample
和com.google.location.bounding_box
数据类型的读取请求将仅返回写入数据的同一应用的数据。
2018 年 9 月 26 日
Google Play 服务健身 16.0.0 支持访问两种新的数据类型及其各自的汇总数据:
在 maven.google.com 上发布的工件
- com.google.android.gms:play-services-fitness:16.0.0
2017 年 11 月
Google Play 服务 11.6.0 引入了以下新的 Google 健身功能:
- 针对基于
GoogleApi
的新客户端更新了 Fitness API,这些 API 会自动管理服务连接,并且需要使用更少的样板代码:- 添加了
BleClient
类和Fitness.getBleClient()
方法。“BleClient
”提供了用于在 Google 健身中扫描、声明和使用蓝牙低功耗设备的入口点。 - 添加了
ConfigClient
类和Fitness.getConfigClient()
方法。ConfigClient
提供了在 Google 健身中访问自定义数据类型和设置的入口点。 - 添加了
GoalsClient
类和Fitness.getGoalsClient()
方法。GoalsClient
是读取 Google 健身用户创建的健身Goal
的入口点。 - 添加了
HistoryClient
类和Fitness.getHistoryClient()
方法。HistoryClient
提供了在 Google 健身中插入、删除和读取数据的入口点。 - 添加了
RecordingClient
类和Fitness.getRecordingClient()
方法。RecordingClient
提供了入口点,用于在 Google 健身中启用低功耗且始终开启的后台传感器数据收集。 - 添加了
SensorsClient
类和Fitness.getSensorsClient()
方法。SensorsClient
提供了入口点,用于在本地和已连接的设备中公开不同的健身数据源,以及向监听器提供直播活动。 - 添加了
SessionsClient
类和getSessionsClient
方法。SessionsClient
提供了用于在 Google 健身中创建和管理用户活动的Session
的入口点。
- 添加了
2015 年 5 月
Google Play 服务 7.5 引入了以下 Google 健身新功能:
- 可以订阅的运动里程和消耗卡路里数计算。
- 设备上的应用订阅数据后,Google 健身平台便会立即开始跟踪距离和卡路里数据。如需详细了解如何订阅数据类型,请参阅记录健身数据。
- 但 Sensors API 不会实时提供这类数据。
- Google 健身平台现在可以使用
com.google.activity.exercise
数据类型存储日常锻炼数据,例如二头肌弯举和下蹲。如需详细了解 Google 健身可以存储的锻炼数据,请参阅WorkoutExercises
。
2015 年 4 月
Google Play 服务 7.3 引入了以下 Google 健身新功能:
- Google 健身平台现在可以使用
com.google.fitness
数据类型跟踪营养数据。com.google.calories.consumed
数据类型现已废弃。可以使用com.google.fitness.item
数据类型记录消耗的卡路里数。- 如需详细了解数据类型,请参阅健身数据类型。
- 开发者可以检索每日汇总步数,以便在 Android Wear 表盘等领域使用。如需了解详情,请参阅读取每日总数据。
2015 年 3 月
Google Play 服务 7.0 引入了以下 Google 健身新功能:
- Google Fit API 现在已模块化,因此您可以选择要在应用中包含的功能。这项变更会大幅降低启用 Google 健身的应用的内存要求,并会影响您访问 API 的方式。如需详细了解如何更新代码,请参阅连接到健身服务。
- Google 健身平台现在会计算距离。如需访问数据,请使用
com.google.distance.delta
数据类型。如需详细了解数据类型,请参阅健身数据类型。 - 开发者现在可以读取和写入精细的睡眠数据。
其中包括轻度睡眠、深度睡眠、REM 和清醒活动。这些精细的 activity 类型已添加到
FitnessActivities
枚举类型中。- 如需插入睡眠数据,请创建一个
FitnessActivities.SLEEP
类型的会话。 - 若要检测会话的粒度,请插入以下类型的活动细分:
- 如需读取睡眠数据,请像处理正常健身活动一样查询睡眠时段以获取睡眠活动片段。
- 如需插入睡眠数据,请创建一个