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 à divers 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 des écouteurs (branchés 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, la détection et l'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 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 la requête, consultez Obtenir des données d'instantané.