Ü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, eingesteckt 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 Erfassung und Inferenz durchgeführt, 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 Sie SuccessListener, um DetectedActivityResponse abzurufen, und rufen Sie dann getActivityRecognitionResult() auf, um ActivityRecognitionResult zurückzugeben, aus dem Sie die tatsächlichen Anforderungsdaten abrufen können.

Das folgende Beispiel zeigt, 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 dazu, was Sie mit den Anfragedaten tun können, finden Sie unter Snapshot-Daten abrufen.