Visão geral da API Snapshot

É possível usar 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 ao caminhar ou dirigir.
  • 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 possam ser retornados com rapidez. 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 existente 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, em seguida, chame getActivityRecognitionResult() para retornar um ActivityRecognitionResult do qual você pode receber os dados da solicitação real.

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 é possível fazer com os dados da solicitação, consulte Receber dados de snapshot.