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 sinais de contexto:

  • Atividade do usuário detectada, como quando eles caminham ou dirigem.
  • 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 rapidamente. Se não houver dados, a detecção e a inferência serão realizadas para retornar valores de estado novos. 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 de solicitação reais.

O exemplo a seguir mostra como receber 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 snapshots.