Per iniziare

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

Per utilizzare l'API Awareness, devi avere un Account Google. Se hai già un account, è tutto pronto. Ti consigliamo anche di avere un Account Google distinto per scopi di test.

Prima di iniziare

Ottenere una chiave API

Se non hai ancora attivato l'API Awareness e ottenuto una chiave API di Google, segui la procedura descritta in Registrazione e chiavi API.

Configura la tua app

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

    buildscript {
    repositories {
        google()
    }
}

allprojects {
    repositories {
        google()
    }
}

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

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

  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, racchiusa tra 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 a seconda dei metodi dell'API e dei tipi di recinti utilizzati dalla tua app.

Chiamata di esempio

L'esempio seguente di chiamata a getDetectedActivity() dimostra come utilizzare il modello di servizi Google Play 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: