Android で使ってみる

Google アカウントを取得する

Google Fit API を使用するには、Google アカウントが必要です。新しいアカウントを作成するか、既存のアカウントを使用できます。ユーザーの視点からアプリをテストするために、別のアカウントを作成することをおすすめします。

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 を取得します。

プロジェクトを作成して構成する

Fitness API を使用してアプリをビルドするには、Android Studio 開発環境を使用することをおすすめします。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 がアプリをビルドするときに、フィットネス 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. アクセスが適用される: ユーザーが権限を付与すると、アプリはユーザーが権限を付与したスコープに属するデータ型にアクセスできます。