适用于 Android 的使用入门

本指南介绍了如何在 Android 上开始使用 Google Fit 进行开发。

设置

在开始构建应用之前，请完成以下部分中的步骤。

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

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

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

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

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

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

Kotlin DSLGroovy DSL 
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.4.0")
}
 
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.4.0'
}

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

构建和测试应用

完成设置步骤后，您就可以开始构建应用了。首先，请了解应用可以存储和读取的数据类型。详细了解如何在 Google 健身中使用数据。

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

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

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

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

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

以下内容展示了当用户被要求授予权限时，他们会体验到的授权流程：

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

申请验证

构建并测试应用后，您需要申请验证，敏感范围和受限范围需要不同程度的理由。