Jetzt loslegen

In diesem Dokument wird erläutert, wie Sie die Awareness API für Android entwickeln können. 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. Sie können zu Testzwecken auch ein separates Google-Konto verwenden.

Hinweis

API-Schlüssel abrufen

Wenn Sie die Awareness API noch nicht aktiviert und einen Google API-Schlüssel erhalten haben, folgen Sie den Schritten unter Registrierung und API-Schlüssel.

Eigene Anwendung 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 Modulebene (in der Regel app/build.gradle) die Abhängigkeiten für die Awareness API hinzu.

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

  3. Fügen Sie der Datei AndroidManifest.xml Ihrer App Ihren Awareness API-Schlüssel hinzu. Fügen Sie hierzu ein <meta-data>-Tag mit android:name="com.google.android.awareness.API_KEY" hinzu. Für android:value solltest du einen eigenen Awareness API-Schlüssel in Anführungszeichen setzen.

    <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 variieren je nach den von Ihrer App verwendeten API-Methoden und Zauntypen.

Beispielaufruf

Der folgende Beispielaufruf von getDetectedActivity() zeigt, wie das Modell für verbindungslose Google Play-Dienste 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 der Awareness API: