Mit der Snapshot API können Sie Informationen zur aktuellen Umgebung des Nutzers abrufen. Mit der Snapshot API haben Sie Zugriff auf verschiedene Kontextsignale:
- Erkannte Nutzeraktivitäten, z. B. wenn sie zu Fuß oder mit dem Auto unterwegs sind
- Beacons in der Nähe, die Sie registriert haben
- Kopfhörerstatus, angeschlossen oder nicht
- Standort, einschließlich des Längen- und Breitengrads
Diese Werte werden vom System im Cache gespeichert, sodass sie schnell zurückgegeben werden können. Wenn keine Daten vorhanden sind, werden Sensoren und Inferenzen verwendet, um aktuelle Statuswerte zurückzugeben. Die Awareness API gibt den vorhandenen Datentyp für Kontexttypen zurück, die eine öffentliche API haben.
Für jedes Kontextsignal gibt es eine entsprechende Snapshot API-Methode. Wenn Sie beispielsweise die aktuell erkannte Aktivität abrufen möchten, rufen Sie getDetectedActivity() auf. Rufen Sie mit SuccessListener ein DetectedActivityResponse ab. Rufen Sie dann getActivityRecognitionResult() auf, um ActivityRecognitionResult abzurufen, von dem Sie die tatsächlichen Anfragedaten abrufen können.
Das folgende Beispiel zeigt, wie Sie die letzte erkannte Aktivität abrufen:
Awareness.getSnapshotClient(this).getDetectedActivity()
.addOnSuccessListener(new OnSuccessListener<DetectedActivityResponse>() {
@Override
public void onSuccess(DetectedActivityResponse dar) {
ActivityRecognitionResult arr = dar.getActivityRecognitionResult();
}
})
Weitere Informationen zu den Funktionen von Anfragedaten finden Sie unter Snapshot-Daten abrufen.