BleApi

Class Overview

API for scanning, claiming, and using Bluetooth Low Energy devices in Google Fit.

Most BLE devices will accept connections from any other device, without the need for pairing. To prevent Google Fit from using data from a device the user does not own, we require a device to be claimed before it can be used in the platform.

The API supports scanning and claiming devices. Once a device is claimed, its data sources are exposed via the Sensors and Recording APIs, similar to local sensors.

The BLE API should be accessed from the Fitness entry point. Example:

     GoogleApiClient client = new GoogleApiClient.Builder(context)
         .addApi(Fitness.API)
         ...
         .build();
     client.connect();

     PendingResult<Status> pendingResult = Fitness.BleApi.startBleScan(
         client,
         new StartBleScanRequest.Builder()
             .setDataTypes(DataTypes.STEP_COUNT_DELTA)
             .setBleScanCallback(bleScanCallback)
             .build());
 

Enabling Bluetooth

Many methods in this class require Bluetooth to be enabled. In case it isn't, the method will return a result with status code set to DISABLED_BLUETOOTH. In this case, the app should use startResolutionForResult(Activity, int) to show the dialog allowing the user to enable Bluetooth.

Example:

     public class MyActivity extends FragmentActivity {

         private static final int REQUEST_BLUETOOTH = 1001;

         private GoogleApiClient mGoogleApiClient;
         ...

         private final ResultCallback mResultCallback = new ResultCallback() {
             @Override
             public void onResult(Status status) {
                 ...
                 if (!status.isSuccess()) {
                     switch (status.getStatusCode()) {
                         case FitnessStatusCodes.DISABLED_BLUETOOTH:
                             try {
                                 status.startResolutionForResult(
                                         MyActivity.this, REQUEST_BLUETOOTH);
                             } catch (SendIntentException e) {
                                 ...
                             }
                             break;
                         ...
                     }
                 }
             }
         };

         @Override
         protected void onActivityResult(int requestCode, int resultCode, Intent data) {
             super.onActivityResult(requestCode, resultCode, data);
             switch (requestCode) {
                 case REQUEST_BLUETOOTH:
                     startBleScan();
                     break;
                 ...
             }
         }

         private void startBleScan() {
             StartBleScanRequest request = ...
             PendingResult result =
                     Fitness.BleApi.startBleScan(mGoogleApiClient, request);
             result.setResultCallback(mResultCallback);
         }
     }
 

Summary

Public Methods
abstract PendingResult<Status>	claimBleDevice(GoogleApiClient client, BleDevice bleDevice) Associates a BLE device with the current user.
abstract PendingResult<Status>	claimBleDevice(GoogleApiClient client, String deviceAddress) Associates a BLE device with the current user, using only the device address.
abstract PendingResult<BleDevicesResult>	listClaimedBleDevices(GoogleApiClient client) Lists all BLE devices that are associated with the current user.
abstract PendingResult<Status>	startBleScan(GoogleApiClient client, StartBleScanRequest request) Starts a scan for BLE devices compatible with Google Fit.
abstract PendingResult<Status>	stopBleScan(GoogleApiClient client, BleScanCallback callback) Stops a BLE devices scan.
abstract PendingResult<Status>	unclaimBleDevice(GoogleApiClient client, String deviceAddress) Disassociates a BLE device with the current user, using the device's address.
abstract PendingResult<Status>	unclaimBleDevice(GoogleApiClient client, BleDevice bleDevice) Disassociates a BLE device with the current user.