Présentation de l'API Snapshot

Vous pouvez utiliser l'API Snapshot pour obtenir des informations sur l'environnement actuel de l'utilisateur. L'API Snapshot vous permet d'accéder à différents signaux contextuels :

  • Activité de l'utilisateur détectée, par exemple lorsqu'il marche ou conduit.
  • Les balises à proximité que vous avez enregistrées.
  • État du casque (branché ou non).
  • Emplacement, qui inclut la latitude et la longitude.

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

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

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 Obtenir des données d'instantané.