Rozpocznij

Z tego dokumentu dowiesz się, jak zacząć tworzyć aplikacje korzystające z interfejsu Awareness API na Androidzie. Interfejs Awareness API jest częścią Usług Google Play.

Aby korzystać z Awareness API, musisz mieć konto Google. Jeśli masz już konto, nie musisz nic więcej robić. Możesz też utworzyć osobne konto Google na potrzeby testów.

Zanim zaczniesz

Uzyskiwanie klucza interfejsu API

Jeśli nie masz jeszcze włączonego interfejsu Awareness API i nie masz klucza Google API, wykonaj czynności opisane w sekcji Rejestracja i klucze API.

Konfiguracja aplikacji

  1. W pliku build.gradle na poziomie projektu dodaj repozytorium Maven firmy Google do sekcji buildscript i allprojects:

    buildscript {
    repositories {
        google()
    }
}

allprojects {
    repositories {
        google()
    }
}

  2. Dodaj zależności do interfejsu Awareness API do pliku Gradle modułu na poziomie aplikacji. Jest to zwykle:app/build.gradle

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

  3. Dodaj klucz interfejsu Awareness API do pliku AndroidManifest.xml aplikacji. Aby to zrobić, dodaj tag <meta-data> z wartością android:name="com.google.android.awareness.API_KEY". W miejscu wartości android:value wpisz własny klucz interfejsu Awareness API (w cudzysłowie).

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

  4. Dodaj do pliku AndroidManifest.xml aplikacji niezbędne uprawnienia. Wymagane uprawnienia różnią się w zależności od metod interfejsu API i typów ogrodzeń, z których korzysta aplikacja.

Przykładowe wywołanie

Ten przykładowy wywołanie interfejsu getDetectedActivity() pokazuje, jak korzystać z modelu usług Google Play bez połączenia z interfejsem Awareness API:

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

Dalsze kroki

Dowiedz się więcej o różnych interfejsach API w ramach interfejsu Awareness API: