Panoramica dell'API Snapshot

Puoi utilizzare l'API Snapshot per ottenere informazioni sull'ambiente attuale dell'utente. Con l'API Snapshot, puoi accedere a una serie di indicatori di contesto:

  • Attività utente rilevate, ad esempio quando cammina o guida.
  • Beacon nelle vicinanze che hai registrato.
  • Stato delle cuffie, collegate o meno.
  • Posizione, che include latitudine e longitudine.

Il sistema memorizza nella cache questi valori in modo che possano essere restituiti rapidamente. Se non sono disponibili dati, vengono eseguiti il rilevamento e l'inferenza per restituire valori di stato aggiornati. L'API Awareness restituisce il tipo di dati esistente per i tipi di contesto che dispongono di un'API pubblica.

Ogni indicatore di contesto ha un metodo API Snapshot corrispondente. Ad esempio, per recuperare l'attività rilevata corrente, chiami getDetectedActivity(), utilizzi un SuccessListener per ottenere un DetectedActivityResponse e poi chiami getActivityRecognitionResult() per restituire un ActivityRecognitionResult da cui puoi ottenere i dati effettivi della richiesta.

L'esempio seguente mostra come ottenere l'attività rilevata più recente:

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

Per ulteriori informazioni su cosa puoi fare con i dati della richiesta, consulta Ottenere i dati degli snapshot.