Inizia

Questo documento spiega come iniziare a sviluppare con l'API Awareness su Android. L'API Awareness fa parte di Google Play Services.

Per usare l'API Awareness, devi avere un Account Google. Se hai già un account, è tutto pronto. Puoi anche creare un Account Google separato a scopo di test.

Prima di iniziare

Ottenere una chiave API

Se non hai ancora abilitato l'API Awareness e ottenuto una chiave API di Google, segui i passaggi descritti in Registrazione e chiavi API per farlo.

Configura la tua app

  1. Nel file build.gradle a livello di progetto, includi il repository Maven di Google nelle sezioni buildscript e allprojects:

    buildscript {
        repositories     {
            google    ()
            }
    }

    allprojects     {
        repositories     {
            google    ()
            }
    }

  2. Aggiungi le dipendenze dell'API Awareness al file Gradle a livello di app del tuo modulo, che in genere è app/build.gradle:

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

  3. Aggiungi la chiave API Awareness al file AndroidManifest.xml dell'app. Per farlo, aggiungi un tag <meta-data> con android:name="com.google.android.awareness.API_KEY". Per android:value, inserisci la tua chiave API Awareness, circondata da virgolette.

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

  4. Aggiungi le autorizzazioni necessarie al file AndroidManifest.xml dell'app. Le autorizzazioni richieste variano in base ai metodi API e ai tipi di recinzione utilizzati dall'app.

Esempio di chiamata

L'esempio di chiamata seguente relativo a getDetectedActivity() mostra come utilizzare il modello Google Play Services senza connessione con l'API Awareness:

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

Passaggi successivi

Scopri di più sulle diverse API all'interno dell'API Awareness: