Descripción general de la API de Snapshot

Puedes usar la API de Snapshot para obtener información sobre el entorno actual del usuario. Con la API de Snapshot, puedes acceder a una variedad de indicadores de contexto:

  • Actividad del usuario detectada, por ejemplo, cuando camina o conduce
  • Balizas cercanas que registraste
  • Estado de los auriculares, conectados o no.
  • Ubicación, que incluye la latitud y la longitud

El sistema almacena en caché estos valores para que se puedan devolver rápidamente. Si no hay datos, se realizan la detección y la inferencia para devolver valores de estado actualizados. La API de Awareness devuelve el tipo de datos existente para los tipos de contexto que tienen una API pública.

Cada indicador de contexto tiene un método de la API de Snapshot correspondiente. Por ejemplo, para obtener la actividad detectada actual, llamas a getDetectedActivity(), usas un SuccessListener para obtener un DetectedActivityResponse y, luego, llamas a getActivityRecognitionResult() para devolver un ActivityRecognitionResult desde el que puedes obtener los datos de la solicitud real.

En el siguiente ejemplo, se muestra cómo obtener la actividad detectada más reciente:

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

Para obtener más información sobre lo que puedes hacer con los datos de la solicitud, consulta Cómo obtener datos de instantáneas.