開始使用 Android

申請 Google 帳戶

您必須擁有 Google 帳戶，才能使用 Google 健身 API。你可以建立新帳戶或使用現有帳戶。您可能想建立獨立帳戶，從使用者的角度測試應用程式。

取得 Google Play 服務

在開發主機上取得最新版 Google Play 服務用戶端程式庫：

1. 開啟 Android SDK Manager。
2. 在「SDK Tools」下方，找到「Google Play services」。
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.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。

取得必要的 Android 權限

如要讀取及寫入某些類型的資料，應用程式必須要求 Android 權限。

取得 OAuth 權限

應用程式有權存取的資料類型對應至授權範圍。如要要求這些權限，您需要在 FitnessOptions 執行個體中新增應用程式需要存取的資料類型。當應用程式要求使用任何 Google Fit 資料類型時，Android SDK 會自動檢查這些資料類型所屬的範圍，並要求使用者授權存取這些範圍。

建立 API 用戶端

建立 API 用戶端，並新增應用程式需要存取的資料型別，以便寫入或讀取資料。以下為可用的端點：

• SensorsClient：存取本機裝置和隨附裝置中硬體感應器的不同健康與健身資料來源。
• RecordingClient：以低耗電量在背景持續收集感應器資料。
• HistoryClient：在 Google Fit 中插入、刪除及讀取歷來資料。
• SessionsClient：建立及管理使用者活動的「工作階段」。
• GoalsClient：讀取使用者在 Google Fit 中建立的心肺活絡分鐘數和步數目標。
• ConfigClient：在 Google Fit 平台中存取自訂資料類型和設定。

查看如何建構 Fitness API 用戶端的範例。

產生的使用者授權流程

以下顯示使用者在被要求授予權限時，會遇到的授權流程：

1. Android 權限：使用者下載應用程式前，會看到應用程式要求的 Android 權限。應用程式下載完成後，會要求所需的執行階段權限，使用者可選擇授予或拒絕這些權限。
2. 檢查及連結：應用程式會先檢查是否已獲授權，再要求存取其他資料類型。
3. 要求 OAuth 範圍：Google 會提示使用者授予應用程式 OAuth 範圍，以便存取所需資料類型。
4. 存取權限已套用：使用者授予權限後，應用程式就能存取使用者已授予權限的範圍所屬資料類型。