Google Fit para Android: Leyendo los Datos del Sensor

Introducción

Google Fit es una plataforma que permite a los desarrolladores construir aplicaciones enfocadas en datos de fitness. Una de las herramientas que Google provee es Google Fit para Android, que está disponible como un paquete en Google Play Services.

Mientras que hay muchas APIs diferentes disponibles para Google Fit, como discutimos en este artículo de Envato Tuts+, este tutorial se enfoca en iniciarte y utilizar la data del sensor de lectura de Google Fit en un dispositivo Android. Un proyecto de ejemplo para este tutorial se encuentra en GitHub.

1. Configurando la Consola de Desarrollador

Para poder utilizar Google Fit pra Android, necesitas:

• habilitar la Fitness API en la Consola Google Developers
• crear un ID de cliente en OAuth 2.0
• conectar la Fitness API en tu aplicación Android

Esta sección muestra como configurar tu aplicación Android y la Fitness API. Puedes empezar visitando la Consola Google Developers. Si ya tienes un proyecto para trabajar, puedes saltear el siguiente paso. Si no, continúa y crea un nuevo proyecto para tu aplicación Google Fit.

Paso 1: Crear un Proyecto

Para crear un nuevo proyecto, haz click en el botón azul Create Project en la esquina superior izquierda de la pantalla.

Esto te mostrará un diálogo que pide un nombre de proyecto. Para este tutorial, creé un proyecto llamado TutsPlusGoogleFit. Hay algunas restricciones en cuanto a cómo puedes llamar tu proyecto. Solo letras, números, comillas, guiones, espacios y signos de exclamación son permitidos.

Una vez que presionas Create, un diálogo aparece en la esquina inferior derecha de la página, indicando que el proyecto fue creado.

Paso 2: Habilitar la API de Google Fit

Con el proyecto configurado, te llevará a la página de Overview. La forma más fácil de encontrar la API de Google Fit es buscando la palabra clave "fit". Selecciona Fitness API de los resultados que aparezcan.

Haz click en Enable API para habilitar la Fitness API.

Después de habilitar la Fitness API, recibirás una alerta que te informa que también necesitas crear credenciales para utilizar la Fitness API. Afortunadamente, el alerta incluye un botón que nos lleva a la página de Credenciales.

Paso 3: Crear Credenciales

En la página de Credenciales, necesitas proveer cierta información general acerca de tu aplicación en el Credentials Wizard. Especifica que estás usando la Fitness API, que la API se llamará desde una aplicación Android, y que esa aplicación necesita acceso a User Data.

A continuación, haz click en What credentials do I need? (Qué credenciales necesito?) en la parte inferior y crea una client ID de OAuth 2.0 para tu aplicación Android. Necesitas dos piezas de información importantes para este paso:

• huella de certificado de registro
• nombre del paquete para la aplicación

Puedes obtener una huella de certificado de registro abriendo la terminal o la consola de comando, y navegando a la localización del certificado de registro de tu aplicación. Esto puede ser tu llave de release o el certificado por default debug.keystore que utiliza Android Studio. Una vez que hayas navegado a tu keystore, puedes generar la SHA1 necesaria con el siguiente comando, donde debug.keystore es el nombre del certificado de registro.

1

keytool -list -v -keystore debug.keystore

Pega la llave SHA1 en el campo SHA1 e ingresa com.tutsplus.googlefit en el campo de nombre del paquete.

Finalmente, necesitas configurar la pantalla de consentimiento de OAuth 2.0 Esta es la pantalla que muestra al usuario para que pueda garantizar el permiso para que tu aplicación utilice su data de fitness. Este paso requiere tu email y el nombre del producto para mostrar a los usuarios. Para este tutorial, he ingresado Tuts+ Google Fit.

Haz click en Continue, y en la siguiente página, haz click en Done para finalizar el proceso de configuración.

Paso 4: Configurar el Proyecto Android

Con tu proyecto preparado y configurado en la Consola de Google Developer, puedes comenzar a crear un nuevo proyecto Android. Asegúrate que el nombre del paquete es igual al que ingresaste en la Consola de Google Developers y configura la aplicación para que utilice aplicaciones Phone y Tablet con una versión de SDK mínima de 14. El nivel mínimo de API para Google Fit es 9. Crea una Empty Activity (Actividad Vacía) para mantener la base del proyecto limpia así te puedes enfocar en la API de Google Fit en este tutorial.

Luego de configurar el proyecto, abre el archivo build.gradle del proyecto e importa el paquete de fitness desde Google Play Services añadiendo la siguiente línea en el nodo de dependencies.

1

compile 'com.google.android.gms:play-services-fitness:8.4.0'

A continuación, abre MainActivity.java y agrega las siguientes interfaces:

• OnDataPointListener
• GoogleApiClient.ConnectionCallback
• GoogleApiClient.OnConnectionFailedListener

Una vez que hayas agregado los métodos requeridos para estas interfaces, tu clase debería verse así:

1

public class MainActivity extends AppCompatActivity implements OnDataPointListener,

2

        GoogleApiClient.ConnectionCallbacks,

3

        GoogleApiClient.OnConnectionFailedListener {

4

5

    @Override

6

    protected void onCreate(Bundle savedInstanceState) {

7

        super.onCreate(savedInstanceState);

8

        setContentView(R.layout.activity_main);

9

    }

10

11

    @Override

12

    public void onConnected(Bundle bundle) {

13

14

    }

15

16

    @Override

17

    public void onConnectionSuspended(int i) {

18

19

    }

20

21

    @Override

22

    public void onConnectionFailed(ConnectionResult connectionResult) {

23

24

    }

25

26

    @Override

27

    public void onDataPoint(DataPoint dataPoint) {

28

29

    }

30

}

Finalmente, crea las variables miembro que utilizaras para este tutorial. Puedes copiar las siguientes líneas en el inicio de la clase:

1

private static final int REQUEST_OAUTH = 1;

2

private static final String AUTH_PENDING = "auth_state_pending";

3

private boolean authInProgress = false;

4

private GoogleApiClient mApiClient;

En el siguiente paso, te conectarás a Google Play Services y aprenderás cómo acceder a los datos de fitness del usuario desde tu aplicación.

2. Usando la API de Fitness

Paso 1: Conectado con Google Play Services

Con el proyecto configurado en el Android Studio y la Consola de Google Developer, es momento de sumergirnos en la API de Fitness. En el método onCreate(), confirmas que la aplicación ya está intentando autorizar con la API de Fitness. Luego inicia la instancia GoogleApiClient añadiendo la API de Fitness Sensors, definiendo un scope, y registrando los callbacks de la aplicación. Si no solicitas un scope, tu aplicación fallará al autorizar contra la API de Fitness Sensors.

1

@Override

2

protected void onCreate(Bundle savedInstanceState) {

3

    super.onCreate(savedInstanceState);

4

    setContentView(R.layout.activity_main);

5

6

    if (savedInstanceState != null) {

7

        authInProgress = savedInstanceState.getBoolean(AUTH_PENDING);

8

    }

9

10

    mApiClient = new GoogleApiClient.Builder(this)

11

            .addApi(Fitness.SENSORS_API)

12

            .addScope(new Scope(Scopes.FITNESS_ACTIVITY_READ_WRITE))

13

            .addConnectionCallbacks(this)

14

            .addOnConnectionFailedListener(this)

15

            .build();

16

17

}

Luego de iniciar la instancia de GoogleApiClient, necesitas hacerlo conectar con el backend de Google. Puedes hacer esto en onStart().

1

@Override

2

protected void onStart() {

3

    super.onStart();

4

    mApiClient.connect();

5

}

La primera vez que el usuario corre la aplicación, la conexión con la API de Fitness fallará porque el usuario debe autorizar tu aplicación para acceder a su data de fitness. Puede escuchar este evento en onConnectionFailed() y reaccionar acorde chequeando si la autorización está en progreso. Si es así, llama a startResolutionForResult() así Google Play Services puede manejar apropiadamente al usuario garantizando el permiso para usar su información.

1

@Override

2

public void onConnectionFailed(ConnectionResult connectionResult) {

3

    if( !authInProgress ) {

4

        try {

5

            authInProgress = true;

6

            connectionResult.startResolutionForResult( MainActivity.this, REQUEST_OAUTH );

7

        } catch(IntentSender.SendIntentException e ) {

8

9

        }

10

    } else {

11

        Log.e( "GoogleFit", "authInProgress" );

12

    }

13

}

Si corres tu aplicación ahora, quizás se te presente un diálogo pidiendo seleccionar una cuenta de Google para utilizar si tienes más de una cuenta en tu dispositivo.

Cuando el sistema operativo sabe qué cuenta usar, tu aplicación presentará un nuevo diálogo solicitando al usuario garantizar el permiso para que la aplicación lea sus datos de fitness.

En este punto, el usuario o bien garantiza el permiso a tu aplicación para leer sus datos o cierra el diálogo, cancelando el proceso. Puedes escuchar ambos eventos en onActivityResult() y manipular el resultado. Si el usuario le otorga permiso a tu aplicación, la aplicación recibe una respuesta RESULT_OK y puede intentar conectar con el cliente de API de Google.

1

@Override

2

protected void onActivityResult(int requestCode, int resultCode, Intent data) {

3

    if( requestCode == REQUEST_OAUTH ) {

4

        authInProgress = false;

5

        if( resultCode == RESULT_OK ) {

6

            if( !mApiClient.isConnecting() && !mApiClient.isConnected() ) {

7

                mApiClient.connect();

8

            }

9

        } else if( resultCode == RESULT_CANCELED ) {

10

            Log.e( "GoogleFit", "RESULT_CANCELED" );

11

        }

12

    } else {

13

        Log.e("GoogleFit", "requestCode NOT request_oauth");

14

    }

15

}

Tu aplicación ahora debe ser capaz de conectarse exitosamente a Google Play Services. Con eso fuera del camino, puedes comenzar a enfocarte en la API de Fitness.

Paso 2: Accediendo a los Datos de Pasos con la API de Fitness

Cuando tu instancia GoogleApiClient se ha conectado a Google, el callback onConnected() es disparado. En este callback, necesitas crear un nuevo objeto DataSourcesRequest que define el tipo de datos en los que tu aplicación está interesada. También necesitas crear un ResultCallback que maneja lo que la app debe hacer si los pasos pueden ser recuperados del dispositivo. Con los objetos creados, llama Fitness.SensorsApi.findDataSources() para comenzar a buscar una fuente de datos de pasos válida.

1

@Override

2

public void onConnected(Bundle bundle) {

3

    DataSourcesRequest dataSourceRequest = new DataSourcesRequest.Builder()

4

            .setDataTypes( DataType.TYPE_STEP_COUNT_CUMULATIVE )

5

            .setDataSourceTypes( DataSource.TYPE_RAW )

6

            .build();

7

8

    ResultCallback<DataSourcesResult> dataSourcesResultCallback = new ResultCallback<DataSourcesResult>() {

9

        @Override

10

        public void onResult(DataSourcesResult dataSourcesResult) {

11

            for( DataSource dataSource : dataSourcesResult.getDataSources() ) {

12

                if( DataType.TYPE_STEP_COUNT_CUMULATIVE.equals( dataSource.getDataType() ) ) {

13

                    registerFitnessDataListener(dataSource, DataType.TYPE_STEP_COUNT_CUMULATIVE);

14

                }

15

            }

16

        }

17

    };

18

19

    Fitness.SensorsApi.findDataSources(mApiClient, dataSourceRequest)

20

            .setResultCallback(dataSourcesResultCallback);

21

}

Quizás notes que el método registerFitnessDataListener() en realidad no existe. Este es un método helper que es llamado cuando la fuente de los datos para el cuenta pasos es encontrada, lo que luego crea un objeto SensorRequest para solicitar los datos del sensor cuenta pasos.

En el siguiente fragmento de código, el objeto SensorRequest intenta encontrar un conteo de pasos cada tres segundos. El Fitness.SensorApi luego agrega un request con un nuevo onDataPointListener entonces, cuando nuevos datos están disponibles, el listener es disparado. Si no se encuentran nuevos datos, el OnDataPointListener no se dispara y la API de Fitness espera otros tres segundos antes de volver a comprobar.

1

private void registerFitnessDataListener(DataSource dataSource, DataType dataType) {

2

3

    SensorRequest request = new SensorRequest.Builder()

4

            .setDataSource( dataSource )

5

            .setDataType( dataType )

6

            .setSamplingRate( 3, TimeUnit.SECONDS )

7

            .build();

8

9

    Fitness.SensorsApi.add( mApiClient, request, this )

10

            .setResultCallback(new ResultCallback<Status>() {

11

                @Override

12

                public void onResult(Status status) {

13

                    if (status.isSuccess()) {

14

                        Log.e( "GoogleFit", "SensorApi successfully added" );

15

                    }

16

                }

17

            });

18

}

Cuando se detecta un cambio en el conteo de pasos, onDataPoint() es invocado. En este método, haces un bucle por los campos en el parámetro DataPoint y muestra un mensaje Toast con el nombre del campo y el valor. En este ejemplo, eso será el cuenta pasos. En tu propia app, usarás una lógica más apropiada para ejecutar tu tarea. Notarás que el comando Toast está envuelto en un Runnable que es pasado a runOnUiThread. Esto es porque el callback no se dispara en el hilo principal de UI.

1

@Override

2

public void onDataPoint(DataPoint dataPoint) {

3

    for( final Field field : dataPoint.getDataType().getFields() ) {

4

        final Value value = dataPoint.getValue( field );

5

        runOnUiThread(new Runnable() {

6

            @Override

7

            public void run() {

8

                Toast.makeText(getApplicationContext(), "Field: " + field.getName() + " Value: " + value, Toast.LENGTH_SHORT).show();

9

            }

10

        });

11

    }

12

}

Hay dos cosas más que necesitas hacer para esta prueba. El primero es desconectarte de la SensorApi y Google Play Services cuando terminaste de usarlos. En este ejemplo, haces eso cuando se llama a onStop(). La segunda es guardar el valor de authInProgress que es comprobado por onCreate() en onSavedInstanceState().

1

@Override

2

protected void onStop() {

3

    super.onStop();

4

5

    Fitness.SensorsApi.remove( mApiClient, this )

6

            .setResultCallback(new ResultCallback<Status>() {

7

                @Override

8

                public void onResult(Status status) {

9

                    if (status.isSuccess()) {

10

                        mApiClient.disconnect();

11

                    }

12

                }

13

            });

14

}

15

16

@Override

17

protected void onSaveInstanceState(Bundle outState) {

18

    super.onSaveInstanceState(outState);

19

    outState.putBoolean(AUTH_PENDING, authInProgress);

20

}

Conclusión

En este tutorial, aprendiste como conectar con Google Play Services Fitness API y leer datos del sensor de fitness del dispositivo del usuario. Hasta algo tan simple como datos de pasos para tu usuario puede ser de increíble valor para aplicaciones como Android Wear watch faces o registradores de objetivos. Hay docenas de otros tipos de fuentes de datos que puedes usar y muchas otras APIs con Google Fit para hacer tus aplicaciones mejores todavía.

¡Sé el primero en conocer las nuevas traducciones–sigue @tutsplus_es en Twitter!