Los gehts

In diesem Dokument wird beschrieben, wie Sie mit der Entwicklung mit der Awareness API unter Android beginnen. Die Awareness API ist Teil der Google Play-Dienste.

Wenn Sie die Awareness API verwenden möchten, benötigen Sie ein Google-Konto. Wenn Sie bereits ein solches Konto haben, sind Sie schon startklar. Für Testzwecke könnte ein separates Google-Konto sinnvoll sein.

Hinweis

API-Schlüssel abrufen

Wenn Sie die Awareness API noch nicht aktiviert und keinen Google API-Schlüssel erhalten haben, folgen Sie der Anleitung unter Registrierung und API-Schlüssel.

Eigene App konfigurieren

  1. Fügen Sie in der Datei build.gradle auf Projektebene das Maven-Repository von Google in die Abschnitte buildscript und allprojects ein:

    buildscript {
    repositories {
        google()
    }
}

allprojects {
    repositories {
        google()
    }
}

  2. Fügen Sie der Gradle-Datei auf App-Ebene Ihres Moduls, die in der Regel app/build.gradle ist, die Abhängigkeiten für die Awareness API hinzu:

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

  3. Fügen Sie den Awareness API-Schlüssel der Datei AndroidManifest.xml Ihrer App hinzu. Fügen Sie dazu ein <meta-data>-Tag mit android:name="com.google.android.awareness.API_KEY" hinzu. Geben Sie neben android:value Ihren eigenen Awareness API-Schlüssel ein, umgeben von Anführungszeichen.

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

  4. Fügen Sie der Datei AndroidManifest.xml Ihrer App die erforderlichen Berechtigungen hinzu. Die erforderlichen Berechtigungen hängen von den API-Methoden und Fence-Typen ab, die Ihre App verwendet.

Beispielanruf

Der folgende Beispielaufruf von getDetectedActivity() zeigt, wie das verbindungslos Google Play-Dienste-Modell mit der Awareness API verwendet wird:

    // 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");
            }
        })

Nächste Schritte

Weitere Informationen zu den verschiedenen APIs in der Awareness API: