Obtener datos de instantáneas

En esta sección, se muestra cómo usar la API de Snapshot para obtener el estado actual de cada uno de los tipos de contexto admitidos. Para obtener más información, consulta Cómo comenzar. Para obtener detalles sobre los indicadores contextuales que dejaron de estar disponibles, abre el siguiente aviso desplegable:

Aviso de baja: Indicadores contextuales de Clima y Lugares

Advertencia: Los indicadores contextuales de lugares y clima, expuestos por los métodos getPlaces() y getWeather(), quedaron obsoletos.

• Se desactivó el indicador contextual de Lugares. El uso continuo de este indicador se restringió a los clientes con implementaciones existentes hasta el 30 de octubre de 2019. Las nuevas implementaciones deben usar el SDK de Places para Android en lugar del indicador contextual de Places.
• También se desactivó el indicador contextual del clima. El uso continuo de este indicador se restringió a los clientes con implementaciones existentes hasta el 31 de enero de 2020. Google no ofrece una funcionalidad alternativa para el indicador contextual del clima.

Obtén la actividad actual

Para obtener la actividad actual del usuario, llama a getDetectedActivity(), que devuelve un ActivityRecognitionResult que contiene información sobre las actividades más recientes del usuario.

El método getDetectedActivity() requiere el permiso com.google.android.gms.permission.ACTIVITY_RECOGNITION. Agrega este permiso a AndroidManifest.xml.

Para obtener la actividad actual del usuario, sigue estos pasos:

1. Llama a getSnapshotClient() para crear una instancia de SnapshotClient.
2. Usa addOnSuccessListener para crear un OnSuccessListener que pueda escuchar un DetectedActivityResponse.
3. Llama a getStatus() para asegurarte de que el resultado sea válido.

4. Llama a DetectedActivityResponse.getActivityRecognitionResult() para devolver un ActivityRecognitionResult. Puedes usarlo para obtener muchos aspectos de la actividad actual del usuario. Por ejemplo:

   • Llama a getMostProbableActivity() para obtener solo la actividad más probable.
   • Llama a getProbableActivities() para obtener una lista de las actividades recientes clasificadas por probabilidad.
   • Llama a getActivityConfidence() para devolver el valor de confianza de un tipo de actividad determinado.
   • Llama a hasResult() para detectar si un Intent contiene un ActivityRecognitionResult.

En el siguiente ejemplo de código, se usa getMostProbableActivity() para obtener la actividad detectada más probable y registrar el resultado en la consola:

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

            int confidence = probableActivity.getConfidence();
            String activityStr = probableActivity.toString();
            mLogFragment.getLogView().println("Activity: " + activityStr
                + ", Confidence: " + confidence + "/100");
        }
    })

Obtener balizas cercanas

Para obtener información sobre las balizas cercanas, llama a getBeaconState(). Los datos de baliza incluyen el contenido, el tipo y el espacio de nombres de los archivos adjuntos.

El método getBeaconState() requiere el permiso android.permission.ACCESS_FINE_LOCATION. Agrega este permiso a AndroidManifest.xml. Además, debes activar la API de Nearby Messages para tu proyecto de Google Developers Console. Para obtener más información, consulta Registro y claves de API y Comienza a usar la API.

Precaución: getBeaconState() solo se admite en dispositivos que ejecutan el nivel de API 18 (Jelly Bean) o versiones posteriores. Si llamas desde un dispositivo que ejecuta una versión anterior, getStatus() devuelve el código de estado API_NOT_AVAILABLE.

Para obtener información sobre las balizas cercanas, sigue estos pasos:

1. Verifica si el usuario otorgó los permisos necesarios. En el siguiente ejemplo, se verifica si se otorgó el permiso android.permission.ACCESS_FINE_LOCATION. De lo contrario, se le pedirá al usuario que brinde su consentimiento.

   if (ContextCompat.checkSelfPermission(
               MainActivity.this,
               Manifest.permission.ACCESS_FINE_LOCATION) !=
               PackageManager.PERMISSION_GRANTED) {
           ActivityCompat.requestPermissions(
                   MainActivity.this,
                   new String[]{Manifest.permission.ACCESS_FINE_LOCATION},
                   MY_PERMISSION_LOCATION
           );
           return;
       }
   

2. Define un BeaconState.TypeFilter. Esto solo devuelve balizas con archivos adjuntos que están registrados con el espacio de nombres y el tipo especificados. También puedes filtrar según una coincidencia byte por byte en el contenido del archivo adjunto. En el siguiente ejemplo, se muestra cómo crear un filtro de tipo:

   private static final List<BeaconState.TypeFilter> BEACON_TYPE_FILTERS = Arrays.asList(
           BeaconState.TypeFilter.with(
               "my.beacon.namespace",
               "my-attachment-type"),
           BeaconState.TypeFilter.with(
               "my.other.namespace",
               "my-attachment-type"));
   

3. Llama a getSnapshotClient.getBeaconState().

4. Usa addOnSuccessListener para crear un OnSuccessListener que pueda escuchar un BeaconStateResponse.

5. Llama a getStatus() para asegurarte de que el resultado sea válido.

6. Llama a BeaconStateResponse.getBeaconState() para devolver el estado de la baliza.

7. Llama a BeaconState.getBeaconInfo() para obtener un BeaconState.BeaconInfo.

En el siguiente ejemplo, se muestra cómo obtener información de balizas:

Awareness.getSnapshotClient(this).getBeaconState(BEACON_TYPE_FILTERS)
    .addOnSuccessListener(new OnSuccessListener<BeaconStateResponse>() {
        @Override
        public void onSuccess(BeaconStateResponse beaconStateResponse) {
            BeaconStateResult beaconStateResult = beaconStateResponse.getBeaconState();
            BeaconState.BeaconInfo beaconInfo = beaconStateResponse.getBeaconInfo();
        }
    })

Obtener el estado de los auriculares

Para detectar si los auriculares están conectados al dispositivo, llama a getHeadphoneState(), que crea un estado de detección HeadphoneStateResponse con OnSuccessListener configurado para detectar. Luego, puedes llamar a getHeadphoneState() para obtener el HeadphoneState.

Para obtener el estado actual de los auriculares, sigue estos pasos:

1. Llama a getSnapshotClient.getHeadphoneState().
2. Usa addOnSuccessListener para crear un OnSuccessListener que pueda escuchar un HeadphoneStateResponse.
3. Llama a getStatus() para asegurarte de que el resultado sea válido.
4. Si la operación se realiza correctamente, llama a HeadphoneStateResponse.getHeadphoneState() para devolver el estado de los auriculares. Este valor es PLUGGED_IN o UNPLUGGED.

En el siguiente ejemplo de código, se muestra cómo usar getHeadphoneState():

Awareness.getSnapshotClient(this).getHeadphoneState()
    .addOnSuccessListener(new OnSuccessListener<HeadphoneStateResponse>() {
        @Override
        public void onSuccess(HeadphoneStateResponse headphoneStateResponse) {
            HeadphoneState headphoneState = headphoneStateResponse.getHeadphoneState();
            boolean pluggedIn = headphoneState.getState() == HeadphoneState.PLUGGED_IN;
            String stateStr =
                "Headphones are " + (pluggedIn ? "plugged in" : "unplugged");
            mLogFragment.getLogView().println(stateStr);
        }
    })
    .addOnFailureListener(new OnFailureListener() {
        @Override
        public void onFailure(@NonNull Exception e) {
            Log.e(TAG, "Could not get headphone state: " + e);
        }
    });

Obtener ubicación

Puedes obtener la ubicación actual del usuario (latitud y longitud) con una llamada a getLocation(), que devuelve un LocationResponse. Luego, puedes llamar a LocationResponse.getLocation() para obtener un Location con los datos de ubicación actuales.

El método getLocation() requiere el permiso android.permission.ACCESS_FINE_LOCATION. Agrega este permiso a AndroidManifest.xml.

Para obtener la ubicación actual, sigue estos pasos:

1. Verifica si el usuario otorgó los permisos necesarios. En el siguiente ejemplo, se verifica si se otorgó el permiso android.permission.ACCESS_FINE_LOCATION. De lo contrario, se le pedirá al usuario que brinde su consentimiento.

   
   if (ContextCompat.checkSelfPermission(
               MainActivity.this,
               Manifest.permission.ACCESS_FINE_LOCATION) !=
               PackageManager.PERMISSION_GRANTED) {
           ActivityCompat.requestPermissions(
                   MainActivity.this,
                   new String[]{Manifest.permission.ACCESS_FINE_LOCATION},
                   MY_PERMISSION_LOCATION
           );
           return;
       }
   

2. Llama a getSnapshotClient.getLocation().

3. Usa addOnSuccessListener para crear un OnSuccessListener que pueda escuchar un LocationResponse.

4. Llama a getStatus() para asegurarte de que el resultado sea válido.

5. Llama a LocationResponse.getLocation() para devolver el Location actual.

En el siguiente ejemplo, se muestra cómo obtener la ubicación actual:

Awareness.getSnapshotClient(this).getLocation()
    .addOnSuccessListener(new OnSuccessListener<LocationResponse>() {
        @Override
        public void onSuccess(LocationResponse locationResponse) {
            Location loc = locationResponse.getLocationResult();
        }
    })