Premiers pas

Ce document explique comment commencer à développer avec l'API Awareness sur Android. L'API Awareness fait partie des services Google Play.

Pour utiliser l'API Awareness, vous devez disposer d'un compte Google. Si vous avez déjà un compte, vous êtes prêt. Vous pouvez également créer un compte Google distinct à des fins de test.

Avant de commencer

Obtenir une clé API

Si vous n'avez pas encore activé l'API Awareness et obtenu une clé API Google, suivez la procédure décrite dans la section Inscription et clés API.

Configurer votre application

  1. Dans votre fichier build.gradle au niveau du projet, incluez le dépôt Maven de Google dans les sections buildscript et allprojects:

    buildscript {
    repositories {
        google()
    }
}

allprojects {
    repositories {
        google()
    }
}

  2. Ajoutez les dépendances de l'API Awareness au fichier Gradle au niveau de l'application de votre module, qui est généralement app/build.gradle:

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

  3. Ajoutez votre clé API Awareness au fichier AndroidManifest.xml de votre application. Pour ce faire, ajoutez une balise <meta-data> avec android:name="com.google.android.awareness.API_KEY". Pour android:value, insérez votre propre clé API Awareness et entourez-la de guillemets.

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

  4. Ajoutez les autorisations nécessaires au fichier AndroidManifest.xml de votre application. Les autorisations requises varient en fonction des méthodes d'API et des types de barrières utilisés par votre application.

Exemple d'appel

L'exemple d'appel suivant à getDetectedActivity() montre comment utiliser le modèle de services Google Play sans connexion avec 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");
            }
        })

Étapes suivantes

En savoir plus sur les différentes API de l'API Awareness: