Übersicht über die Snapshot API

Mit der Snapshot API können Sie Informationen zur aktuellen Umgebung des Nutzers abrufen. Mit der Snapshot API können Sie auf eine Vielzahl von Kontextsignalen zugreifen:

  • Erkannte Nutzeraktivitäten, z. B. wenn sie gehen oder fahren.
  • Beacons in der Nähe, die Sie registriert haben.
  • Status der Kopfhörer, ob sie angeschlossen sind oder nicht.
  • Standort, einschließlich Breiten- und Längengrad

Das System speichert diese Werte im Cache, damit 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, verwenden ein SuccessListener, um ein DetectedActivityResponse abzurufen, und rufen dann getActivityRecognitionResult() auf, um ein ActivityRecognitionResult zurückzugeben, aus dem Sie die tatsächlichen Anfragedaten abrufen können.

Im folgenden Beispiel wird gezeigt, wie Sie die zuletzt 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 Möglichkeiten, die sich mit den Anfragedaten bieten, finden Sie unter Snapshot-Daten abrufen.