Rozpocznij

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

Aby korzystać z interfejsu Awareness API, musisz mieć konto Google. Jeśli masz już konto, nie musisz nic więcej robić. Możesz też potrzebować osobnego konta Google do celów testowych.

Zanim zaczniesz

Uzyskiwanie klucza interfejsu API

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

Konfiguracja aplikacji

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

    buildscript {
    repositories {
        google()
    }
}

allprojects {
    repositories {
        google()
    }
}

  2. Dodaj zależności interfejsu Awareness API do pliku Gradle na poziomie aplikacji modułu, który zwykle wygląda tak: 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 atrybutem android:name="com.google.android.awareness.API_KEY". W przypadku android:value wstaw 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 niezbędne uprawnienia do pliku AndroidManifest.xml aplikacji. Wymagane uprawnienia różnią się w zależności od metod interfejsu API i rodzajów obszarów, których używa Twoja aplikacja.

Przykładowe wywołanie

Poniższy przykładowy wywołanie getDetectedActivity() pokazuje, jak używać 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

Więcej informacji o różnych interfejsach API w ramach interfejsu Awareness API: