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é 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, y compris latitude et 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 contextes disposant d'une API publique.

Chaque signal de contexte a 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 la section Obtenir des données d'instantané.