开始使用 Android

获取 Google 账号

如需使用 Google 健身 API，您需要一个 Google 账号。您可以创建新账号或 使用现有账号。您可能需要创建一个单独的账号，以便从用户的角度测试应用。

获取 Google Play 服务

在开发主机上获取最新版 Google Play 服务客户端库：

1. 打开 Android SDK 管理器。
2. 在 SDK 工具 下，找到 Google Play 服务。
3. 如果这些软件包的状态不是已安装，请同时选择这两个软件包 然后点击安装软件包。

获取 OAuth 2.0 客户端 ID

如需启用 Fitness API，请获取 OAuth 2.0 客户端 ID。

创建和配置项目

我们建议使用 Android Studio 开发环境 来构建使用 Fitness API 的应用。如需详细了解如何在 Android Studio 中创建新项目并对其进行配置，请参阅 创建项目。

添加 Google Play 服务客户端库

在 Android Studio 中，打开模块的 build.gradle 文件，并将 Google Play 服务客户端库添加为依赖项：

plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.3.0")
        implementation("com.google.android.gms:play-services-auth:21.5.1")
}

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-fitness:21.3.0'
    implementation 'com.google.android.gms:play-services-auth:21.5.1'
}

这样可确保 Gradle 在构建应用时自动下载 Fitness SDK。

获取必要的 Android 权限

如需读取和写入 某些类型的数据，您的应用需要 请求 Android 权限。

获取 OAuth 权限

您的应用有权访问的数据类型与 授权范围相对应。如需请求 这些权限，您需要添加 您的应用需要访问的数据类型，并将其添加到FitnessOptions 实例中。当您的应用请求使用任何 Google 健身数据类型时，Android SDK 会自动检查这些数据类型所属的范围，并请求用户授权访问这些范围。

创建 API 客户端

创建 API 客户端，并添加您的应用需要访问的数据类型，以便写入或读取数据。以下端点可用：

• SensorsClient：访问本地设备和配套设备中硬件传感器提供的不同来源的健康和健身数据。
• RecordingClient：用于以低功耗模式持续在后台收集传感器数据。
• HistoryClient：在 Google 健身中插入、删除和读取历史数据。
• SessionsClient：创建和管理用户活动会话。
• GoalsClient：读取用户在 Google 健身中创建的心肺强化分数和步数目标。
• ConfigClient：访问 Google 健身平台中的自定义数据类型和设置。

查看有关如何构建 Fitness API 客户端的示例。

最终用户授权流程

以下内容展示了用户在被要求授予权限时看到的最终授权流程：

1. Android 权限：用户在下载应用之前，会看到您的应用 请求了哪些 Android 权限。下载应用后，应用会请求所需的任何运行时权限，用户可以授予或拒绝这些权限。
2. 检查和连接：您的应用会在请求访问其他数据类型之前，检查是否已授予权限。
3. OAuth 范围请求：Google 会提示用户向您的应用授予其想要访问的数据类型所需的 OAuth 范围。
4. 访问已应用：用户授予权限后，您的应用可以 访问属于用户已授予权限的范围的数据类型。