Przegląd interfejsu API zrzutu

Za pomocą interfejsu Snapshot API możesz uzyskać informacje o bieżącym środowisku użytkownika. Dzięki Snapshot API masz dostęp do różnych sygnałów kontekstowych:

  • Wykryto aktywność użytkownika, np. podczas chodzenia lub jazdy samochodem.
  • Obrazy typu beacon w pobliżu, które zarejestrujesz.
  • Stan słuchawek podłączony.
  • Lokalizacja zawierająca szerokość i długość geograficzną.

System zapisuje je w pamięci podręcznej, aby można je było szybko zwrócić. Jeśli nie ma danych, wykrywane i wnioskowane jest zwracanie wartości świeżości. Interfejs Speech API zwraca istniejący typ danych w przypadku typów kontekstu, które mają publiczny interfejs API.

Każdy sygnał kontekstowy ma odpowiednią metodę interfejsu Snapshot API. Aby na przykład uzyskać informacje o bieżącej aktywności, wywołaj getDetectedActivity(), SuccessListener – DetectedActivityResponse, a potem wywołaj getActivityRecognitionResult() i zwróć ActivityRecognitionResult z rzeczywistych danych żądania.

Ten przykład pokazuje, jak pobrać najnowszą wykrytą aktywność:

        Awareness.getSnapshotClient(this).getDetectedActivity()
            .addOnSuccessListener(new OnSuccessListener<DetectedActivityResponse>() {
                @Override
                public void onSuccess(DetectedActivityResponse dar) {
                    ActivityRecognitionResult arr = dar.getActivityRecognitionResult();
                }
            })

Więcej informacji o tym, co możesz zrobić z danymi żądania, znajdziesz w artykule Uzyskiwanie danych z migawki.