Pierwsze kroki

W tym dokumencie wyjaśniamy, jak zacząć korzystać z interfejsu Know API na Androidzie. Interfejs Know API jest częścią Usług Google Play.

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

Zanim zaczniesz

Uzyskiwanie klucza interfejsu API

Jeśli nie masz jeszcze włączonego interfejsu Know API i uzyskałeś klucz interfejsu Google API, wykonaj czynności opisane w artykule Rejestracja i klucze interfejsu API.

Konfiguracja aplikacji

  1. W pliku build.gradle na poziomie projektu umieść repozytorium Maven firmy Google zarówno w sekcjach buildscript, jak i allprojects:

    buildscript {
    repositories {
        google()
    }
}

allprojects {
    repositories {
        google()
    }
}

  2. Dodaj zależności interfejsu Know API do pliku Gradle na poziomie aplikacji, który zazwyczaj wynosi app/build.gradle:

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

  3. Dodaj klucz Conversation API do pliku AndroidManifest.xml aplikacji. Aby to zrobić, dodaj do tagu <meta-data> tag android:name="com.google.android.awareness.API_KEY". W polu android:value wpisz własny klucz interfejsu Accessibility API, który znajduje się w cudzysłowie.

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

  4. Dodaj wymagane uprawnienia do pliku AndroidManifest.xml aplikacji. Wymagane uprawnienia różnią się w zależności od metod interfejsu API i typów ogrodzeń używanych w aplikacji.

Przykładowa rozmowa

Z przykładowego wywołania getDetectedActivity() dowiesz się, jak korzystać z modelu usług Google Play bez połączenia z interfejsem API Discovery:

    // 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 interfejsie Know API: