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(), SuccessListenerDetectedActivityResponse, 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.