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 de contexte :
- Activité détectée de l'utilisateur, par exemple lorsqu'il marche ou conduit.
- Balises à proximité que vous avez enregistrées.
- État du casque (branché ou non)
- Lieu, qui inclut la latitude et la longitude.
Le système met en cache ces valeurs afin qu'elles puissent être renvoyées rapidement. En l'absence de données, la détection et l'inférence sont effectuées pour renvoyer des valeurs d'état actualisées. L'API Awareness renvoie le type de données existant pour les types de contexte disposant d'une API publique.
Chaque signal de contexte dispose d'une méthode d'API Snapshot correspondante. Par exemple, pour obtenir l'activité actuellement détectée, vous devez appeler getDetectedActivity(), utiliser un SuccessListener pour obtenir un DetectedActivityResponse, puis appeler getActivityRecognitionResult() pour renvoyer un ActivityRecognitionResult à partir duquel vous pouvez obtenir les données de la requête réelle.
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 la requête, consultez Obtenir des données d'instantané.