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 rilevata, ad esempio quando camminano o guidano.
  • Beacon nelle vicinanze registrati.
  • Stato delle cuffie, collegato o meno.
  • Posizione, che include latitudine e longitudine.

Il sistema memorizza nella cache questi valori in modo che possano essere restituiti rapidamente. In assenza di dati, vengono eseguite l'inferenza, il rilevamento e il reso dei valori aggiornati per lo stato. L'API Aware restituisce il tipo di dati esistente per i tipi di contesto con un'API pubblica.

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

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

        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, vedi Ottenere i dati degli snapshot.