スタートガイド

このドキュメントでは、Android で Awareness API を使用して開発を開始する方法について説明します。Awareness API は Google Play 開発者サービスに含まれています。

Awareness API を使用するには、Google アカウントが必要です。すでにアカウントを持っていれば、この条件は満たしています。テスト用に別の Google アカウントを使用することもできます。

始める前に

API キーを取得する

Awareness API をまだ有効にしておらず、Google API キーを取得していない場合は、登録と API キーの手順に沿って有効にします。

アプリを構成する

  1. プロジェクト レベルの build.gradle ファイルで、buildscript セクションと allprojects セクションの両方に Maven の Maven リポジトリを含めます。

    buildscript {
        repositories     {
            google    ()
            }
    }

    allprojects     {
        repositories     {
            google    ()
            }
    }

  2. Awareness API の依存関係をモジュールのアプリレベルの Gradle ファイル（通常は app/build.gradle）に追加します。

    dependencies {
      implementation     'com.google.android.gms:play-services-awareness:19.0.1'
    }

  3. アプリの AndroidManifest.xml ファイルに Awareness API キーを追加します。これを行うには、<meta-data> タグと android:name="com.google.android.awareness.API_KEY" を追加します。android:value には、引用符で囲まれた独自の Awareness API キーを挿入します。

    <manifest>
            <application>
                <meta-data
                    android:name="com.google.android.awareness.API_KEY"
                    android:value="API_KEY"/>
            </application>
    </manifest>

  4. アプリの AndroidManifest.xml ファイルに必要な権限を追加します。必要な権限は、アプリが使用する API メソッドとフェンスの種類によって異なります。

呼び出し例

次の getDetectedActivity() の呼び出しは、認知度 API でコネクションレス型の Google Play 開発者サービス モデルを使用する方法を示しています。

    // Each type of contextual information in the snapshot API has a corresponding "get" method.
    // For instance, this is how to get the user's current Activity.
    Awareness.getSnapshotClient(this).getDetectedActivity()
        .addOnSuccessListener(new OnSuccessListener<DetectedActivityResponse>() {
            @Override
            public void onSuccess(DetectedActivityResponse dar) {
                ActivityRecognitionResult arr = dar.getActivityRecognitionResult();
                // getMostProbableActivity() is good enough for basic Activity detection.
                // To work within a threshold of confidence,
                // use ActivityRecognitionResult.getProbableActivities() to get a list of
                // potential current activities, and check the confidence of each one.
                DetectedActivity probableActivity = arr.getMostProbableActivity();

                int confidence = probableActivity.getConfidence();
                String activityStr = probableActivity.toString();
                mLogFragment.getLogView().println("Activity: " + activityStr
                    + ", Confidence: " + confidence + "/100");
            }
        })

次のステップ

Awareness API に含まれるさまざまな API の詳細: