Présentation de l'API Snapshot

Vous pouvez utiliser l'API Snapshot pour obtenir des informations sur l'environnement actuel de l'utilisateur. Avec l'API Snapshot, vous pouvez accéder à divers signaux de contexte:

  • Activité utilisateur détectée (par exemple, la marche ou le trajet en voiture).
  • Les balises à proximité que vous avez enregistrées.
  • État du casque, branché ou non.
  • Emplacement, y compris la latitude et la longitude.

Le système met en cache ces valeurs afin de les renvoyer rapidement. En l'absence de données, la détection et l'inférence sont effectuées pour renvoyer de nouvelles valeurs d'état. L'API Awareness renvoie le type de données existant pour les types de contexte ayant une API publique.

Chaque signal de contexte est associé à une méthode de l'API Snapshot. Par exemple, pour obtenir l'activité détectée actuelle, appelez getDetectedActivity(), utilisez un SuccessListener pour obtenir un DetectedActivityResponse, puis appelez getActivityRecognitionResult() pour renvoyer un ActivityRecognitionResult à partir duquel vous pouvez obtenir les données réelles de la requête.

L'exemple suivant montre comment obtenir la dernière activité détectée:

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

Pour en savoir plus sur ce que vous pouvez faire avec les données de requête, consultez la section Obtenir des données d'instantané.