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 à différents signaux contextuels:
- Activité de l'utilisateur détectée, par exemple lorsqu'il marche ou conduit.
- 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 qu'elles puissent être renvoyées rapidement. S'il n'y a pas 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 qui disposent d'une API publique.
Chaque signal de contexte possède une méthode d'API Snapshot 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é.