本页包含与 Google Fit API 版本相关的信息。 更新日志会按日期列出版本,并包含所有新功能、问题修复或重大性能改进。
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,该客户端可自动管理与服务的连接,且减少需要使用的样板代码:- 添加了
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
类型的会话。 - 如需检测会话中的粒度,请插入以下类型的活动细分:
- 如需读取睡眠数据,请像查询常规健身活动一样查询睡眠活动时段的睡眠时段。
- 如需插入睡眠数据,请创建一个