Visão geral da API Snapshot

Use a API Snapshot para receber informações sobre o ambiente atual do usuário. Com a API Snapshot, é possível acessar vários indicadores de contexto:

  • Atividade do usuário detectada, como quando ele caminha ou dirige.
  • Beacons próximos que você registrou.
  • Estado do fone de ouvido, conectado ou não.
  • Local, que inclui latitude e longitude.

O sistema armazena esses valores em cache para que eles possam ser retornados rapidamente. Se não houver dados, a detecção e a inferência serão realizadas para retornar valores de estado atualizados. A API Awareness retorna o tipo de dados atual para tipos de contexto que têm uma API pública.

Cada indicador de contexto tem um método correspondente da API Snapshot. Por exemplo, para receber a atividade detectada atual, chame getDetectedActivity(), use um SuccessListener para receber um DetectedActivityResponse e chame getActivityRecognitionResult() para retornar um ActivityRecognitionResult, do qual você pode receber os dados reais da solicitação.

O exemplo a seguir mostra como acessar a atividade detectada mais recente:

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

Para mais informações sobre o que você pode fazer com os dados da solicitação, consulte Receber dados do Snapshot.