Obtenir des données d'instantané

Cette section explique comment utiliser l'API Snapshot pour obtenir l'état actuel de chacun des types de contextes compatibles. Pour en savoir plus, consultez la section Premiers pas. Pour en savoir plus sur les signaux contextuels obsolètes, ouvrez la notification déroulante suivante:

Avis d'abandon: signaux contextuels Places et Météo

Avertissement:Les signaux contextuels Places et Météo, exposés par les méthodes getPlaces() et getWeather(), ont été abandonnés.

• Le signal contextuel Places a été désactivé. L'utilisation de ce signal était limitée aux clients disposant d'implémentations existantes jusqu'au 30 octobre 2019. Les nouvelles implémentations doivent utiliser le SDK Places pour Android au lieu du signal contextuel Places.
• Le signal contextuel "Météo" a également été désactivé. L'utilisation de ce signal a été limitée aux clients qui l'ont déjà implémenté jusqu'au 31 janvier 2020. Google ne propose pas de fonctionnalité de remplacement pour le signal contextuel de météo.

Obtenir l'activité en cours

Pour obtenir l'activité actuelle de l'utilisateur, appelez getDetectedActivity(), qui renvoie un ActivityRecognitionResult contenant des informations sur les activités les plus récentes de l'utilisateur.

La méthode getDetectedActivity() nécessite l'autorisation com.google.android.gms.permission.ACTIVITY_RECOGNITION. Ajoutez cette autorisation à AndroidManifest.xml.

Pour obtenir l'activité actuelle de l'utilisateur, procédez comme suit:

1. Appelez getSnapshotClient() pour créer une instance de SnapshotClient.
2. Utilisez addOnSuccessListener pour créer un OnSuccessListener pouvant écouter un DetectedActivityResponse.
3. Appelez getStatus() pour vous assurer que le résultat est valide.

4. Appelez DetectedActivityResponse.getActivityRecognitionResult() pour renvoyer un ActivityRecognitionResult. Vous pouvez l'utiliser pour obtenir de nombreux aspects de l'activité actuelle de l'utilisateur. Exemple :

   • Appelez getMostProbableActivity() pour n'obtenir que l'activité la plus probable.
   • Appelez getProbableActivities() pour obtenir une liste des activités récentes classées par probabilité.
   • Appelez getActivityConfidence() pour renvoyer la valeur de confiance d'un type d'activité donné.
   • Appelez hasResult() pour déterminer si un Intent contient un ActivityRecognitionResult.

L'exemple de code suivant utilise getMostProbableActivity() pour obtenir l'activité détectée la plus probable et pour consigner le résultat dans la console:

Awareness.getSnapshotClient(this).getDetectedActivity()
    .addOnSuccessListener(new OnSuccessListener<DetectedActivityResponse>() {
        @Override
        public void onSuccess(DetectedActivityResponse dar) {
            ActivityRecognitionResult arr = dar.getActivityRecognitionResult();
            DetectedActivity probableActivity = arr.getMostProbableActivity();

            int confidence = probableActivity.getConfidence();
            String activityStr = probableActivity.toString();
            mLogFragment.getLogView().println("Activity: " + activityStr
                + ", Confidence: " + confidence + "/100");
        }
    })

Obtenir des balises à proximité

Pour obtenir des informations sur les balises à proximité, appelez getBeaconState(). Les données de balise comprennent le contenu, le type et l'espace de noms de toutes les pièces jointes.

La méthode getBeaconState() nécessite l'autorisation android.permission.ACCESS_FINE_LOCATION. Ajoutez cette autorisation à AndroidManifest.xml. De plus, vous devez activer l'API Nearby Messages pour votre projet Google Developers Console. Pour en savoir plus, consultez les pages Inscription et clés API et Premiers pas.

Attention :getBeaconState() n'est compatible qu'avec les appareils exécutant le niveau d'API 18 (Jelly Bean) ou version ultérieure. Si vous appelez depuis un appareil exécutant une version antérieure, getStatus() renvoie le code d'état API_NOT_AVAILABLE.

Pour obtenir des informations sur les balises à proximité, procédez comme suit:

1. Vérifiez si l'utilisateur a accordé les autorisations requises. L'exemple suivant vérifie si l'autorisation android.permission.ACCESS_FINE_LOCATION est accordée. Sinon, l'utilisateur est invité à donner son consentement.

   if (ContextCompat.checkSelfPermission(
               MainActivity.this,
               Manifest.permission.ACCESS_FINE_LOCATION) !=
               PackageManager.PERMISSION_GRANTED) {
           ActivityCompat.requestPermissions(
                   MainActivity.this,
                   new String[]{Manifest.permission.ACCESS_FINE_LOCATION},
                   MY_PERMISSION_LOCATION
           );
           return;
       }
   

2. Définissez un BeaconState.TypeFilter. Cette opération ne renvoie que les balises avec des pièces jointes enregistrées avec l'espace de noms et le type spécifiés. Vous pouvez également filtrer en fonction d'une correspondance octet par octet sur le contenu de la pièce jointe. L'exemple suivant montre comment créer un filtre de type:

   private static final List<BeaconState.TypeFilter> BEACON_TYPE_FILTERS = Arrays.asList(
           BeaconState.TypeFilter.with(
               "my.beacon.namespace",
               "my-attachment-type"),
           BeaconState.TypeFilter.with(
               "my.other.namespace",
               "my-attachment-type"));
   

3. Appelez getSnapshotClient.getBeaconState().

4. Utilisez addOnSuccessListener pour créer un OnSuccessListener pouvant écouter un BeaconStateResponse.

5. Appelez getStatus() pour vous assurer que le résultat est valide.

6. Appelez BeaconStateResponse.getBeaconState() pour renvoyer l'état de la balise.

7. Appelez BeaconState.getBeaconInfo() pour obtenir un BeaconState.BeaconInfo.

L'exemple suivant montre comment obtenir des informations sur les balises:

Awareness.getSnapshotClient(this).getBeaconState(BEACON_TYPE_FILTERS)
    .addOnSuccessListener(new OnSuccessListener<BeaconStateResponse>() {
        @Override
        public void onSuccess(BeaconStateResponse beaconStateResponse) {
            BeaconStateResult beaconStateResult = beaconStateResponse.getBeaconState();
            BeaconState.BeaconInfo beaconInfo = beaconStateResponse.getBeaconInfo();
        }
    })

Obtenir l'état du casque

Pour détecter si des écouteurs sont branchés à l'appareil, appelez getHeadphoneState(), qui crée un état de détection HeadphoneStateResponse avec OnSuccessListener défini sur "détection". Vous pouvez ensuite appeler getHeadphoneState() pour obtenir HeadphoneState.

Pour obtenir l'état actuel des écouteurs, procédez comme suit:

1. Appelez getSnapshotClient.getHeadphoneState().
2. Utilisez addOnSuccessListener pour créer un OnSuccessListener pouvant écouter un HeadphoneStateResponse.
3. Appelez getStatus() pour vous assurer que le résultat est valide.
4. En cas de réussite, appelez HeadphoneStateResponse.getHeadphoneState() pour renvoyer l'état des écouteurs. Cette valeur est PLUGGED_IN ou UNPLUGGED.

L'exemple de code suivant montre comment utiliser getHeadphoneState():

Awareness.getSnapshotClient(this).getHeadphoneState()
    .addOnSuccessListener(new OnSuccessListener<HeadphoneStateResponse>() {
        @Override
        public void onSuccess(HeadphoneStateResponse headphoneStateResponse) {
            HeadphoneState headphoneState = headphoneStateResponse.getHeadphoneState();
            boolean pluggedIn = headphoneState.getState() == HeadphoneState.PLUGGED_IN;
            String stateStr =
                "Headphones are " + (pluggedIn ? "plugged in" : "unplugged");
            mLogFragment.getLogView().println(stateStr);
        }
    })
    .addOnFailureListener(new OnFailureListener() {
        @Override
        public void onFailure(@NonNull Exception e) {
            Log.e(TAG, "Could not get headphone state: " + e);
        }
    });

Obtenir l'emplacement

Vous pouvez obtenir la position actuelle de l'utilisateur (latitude-longitude) en appelant getLocation(), qui renvoie un LocationResponse. Vous pouvez ensuite appeler LocationResponse.getLocation() pour obtenir un Location avec les données de localisation actuelles.

La méthode getLocation() nécessite l'autorisation android.permission.ACCESS_FINE_LOCATION. Ajoutez cette autorisation à AndroidManifest.xml.

Pour obtenir la position actuelle, procédez comme suit:

1. Vérifiez si l'utilisateur a accordé les autorisations requises. L'exemple suivant vérifie si l'autorisation android.permission.ACCESS_FINE_LOCATION a été accordée. Sinon, l'utilisateur est invité à donner son consentement.

   
   if (ContextCompat.checkSelfPermission(
               MainActivity.this,
               Manifest.permission.ACCESS_FINE_LOCATION) !=
               PackageManager.PERMISSION_GRANTED) {
           ActivityCompat.requestPermissions(
                   MainActivity.this,
                   new String[]{Manifest.permission.ACCESS_FINE_LOCATION},
                   MY_PERMISSION_LOCATION
           );
           return;
       }
   

2. Appelez getSnapshotClient.getLocation().

3. Utilisez addOnSuccessListener pour créer un OnSuccessListener pouvant écouter un LocationResponse.

4. Appelez getStatus() pour vous assurer que le résultat est valide.

5. Appelez LocationResponse.getLocation() pour renvoyer l'Location actuelle.

L'exemple suivant montre comment obtenir l'emplacement actuel:

Awareness.getSnapshotClient(this).getLocation()
    .addOnSuccessListener(new OnSuccessListener<LocationResponse>() {
        @Override
        public void onSuccess(LocationResponse locationResponse) {
            Location loc = locationResponse.getLocationResult();
        }
    })