Bluetooth Data Transfer with Android

To develop an Android application making use of data transfers via Bluetooth (BT), one would logically start at the Android Developer’s Bluetooth page, where all the required steps are described in details: device discovery, pairing, client/server sockets, RFCOMM channels, etc.

But before jumping into sockets and threads programming just to perform a basic BT operation, let’s consider a simpler alternative, based on one of Android’s most important features: the ability for a given application to send the user to another one, which, in this case, would be the device’s default BT application. Doing so will have the Android OS itself do all the low-level work for us.

First things first, a bit of defensive programming:

import android.bluetooth.BluetoothAdapter;
//...
// inside method
// Check if bluetooth is supported
BluetoothAdapter btAdapter = BluetoothAdapter.getDefaultAdapter();

if (btAdapter == null) {
   // Device does not support Bluetooth
   // Inform user that we're done.     	
 }

The above is the first check we need to perform. Done that, let’s see how he can start BT from within our own application.

In a previous post on SMS programming, we talked about implicit intents, which basically allow us to specify the action we would like the system to handle for us. Android will then display all the activities that are able to complete the action we want, in a chooser list.  Here’s an example:

// bring up Android chooser
Intent intent = new Intent();
intent.setAction(Intent.ACTION_SEND);
intent.setType("text/plain");
intent.putExtra(Intent.EXTRA_STREAM, Uri.fromFile(file_to_transfer) );
//...
startActivity(intent);

In the code snippet above, we are letting the Android system know that we intend to send a text file. The system then displays all installed applications capable of handling that action:

chooser

We can see that the BT application is among those handlers. We could of course let the user pick that application from the list and be done with it.  But if we feel  we should be a tad more user-friendly, we need to go further and start the application ourselves, instead of simply displaying it in a midst of other unnecessary options…But how?

One way to do that would be to use Android’s PackageManager this way:

//list of apps that can handle our intent
PackageManager pm = getPackageManager();
List appsList = pm.queryIntentActivities( intent, 0);

if(appsList.size() > 0 {
   // proceed
}

The above PackageManager method returns the list we saw earlier of all activities susceptible to handle our file transfer intent, in the form of a list of ResolveInfo objects that encapsulate information we need:

//select bluetooth
String packageName = null;
String className = null;
boolean found = false;

for(ResolveInfo info: appsList){
  packageName = info.activityInfo.packageName;
  if( packageName.equals("com.android.bluetooth")){
     className = info.activityInfo.name;
     found = true;
     break;// found
  }
}
if(! found){
  Toast.makeText(this, R.string.blu_notfound_inlist,
                 Toast.LENGTH_SHORT).show();
  // exit
}

We now have the necessary information to start BT ourselves:

//set our intent to launch Bluetooth
intent.setClassName(packageName, className);
startActivity(intent);

What we did was to use the package and its corresponding class retrieved earlier. Since we are a curious bunch, we may wonder what the class name for the “com.android.bluetooth” package is. This is what we would get if we were to print it out: com.broadcom.bt.app.opp.OppLauncherActivityOPP stands for Object Push Profile, and is the Android component allowing to wirelessly share files.

All fine and dandy, but in order for all the above code to be of any use, BT doesn’t simply need to be supported by the device, but also enabled by the user. So one of the first things we want to do, is to ask the user to enable BT for the time we deem necessary (here, 300 seconds):

import android.bluetooth.BluetoothAdapter;
//...
// duration that the device is discoverable
private static final int DISCOVER_DURATION = 300;

// our request code (must be greater than zero)
private static final int REQUEST_BLU = 1;

//...

public void enableBlu(){
// enable device discovery - this will automatically enable Bluetooth
Intent discoveryIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_DISCOVERABLE);

discoveryIntent.putExtra(BluetoothAdapter.EXTRA_DISCOVERABLE_DURATION,
                            DISCOVER_DURATION );

startActivityForResult(discoveryIntent, REQUEST_BLU);
}

Once we specify that we want to get a result back from our activity with startActivityForResult, the following enabling dialog is presented to the user:

blu2

Now whenever the activity finishes, it will return the request code we have sent (REQUEST_BLU), along with the data and a result code to our main activity through the onActivityResult callback method.  We know which request code we have to check against, but how about the result code?  Simple: if the user responds “No” to the above permission request (or if an error occurs), the result code will be RESULT_CANCELED. On the other hand, if the user accepts,  the BT documentation specifies that the result code will be equal to the duration that the device is discoverable (i.e. DISCOVER_DURATION, i.e. 300).

So the way to process the BT dialog above would be:

// When startActivityForResult completes...
protected void onActivityResult (int requestCode,
                                 int resultCode,
                                 Intent data) {

  if (resultCode == DISCOVER_DURATION
       && requestCode == REQUEST_BLU) {

      // processing code goes here
  }
  else{ // cancelled or error
    Toast.makeText(this, R.string.blu_cancelled,
                   Toast.LENGTH_SHORT).show();
  }

}

Putting all our processing flow in order, here’s what we are basically doing:

bt-processflow

Are we done yet? Almost. Last but not least, we need to ask for the BT permissions in the Android manifest:

<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />

We’re ready to deploy now. To test all this, we need to use at least two Android devices, one being the file sender (where our application is installed) and the other any receiving device supporting BT. Here are the screen shots. For the sender:

send-shots1

And the corresponding receiving device :

recv-shots2
Note that, once the receiver accepts the connection. the received file (kmemo.dat) is saved inside the BT folder on the SD card. All the lower-level data transfer has been handled by the Android OS.
 

Reference: Bluetooth Data Transfer with Android from our JCG partner Tony Sicilian at the Tony’s Blog blog.
Related Whitepaper:

Rapid Android Development: Build Rich, Sensor-Based Applications with Processing

Create mobile apps for Android phones and tablets faster and more easily than you ever imagined

Use 'Processing', the free, award-winning, graphics-savvy language and development environment, to work with the touchscreens, hardware sensors, cameras, network transceivers, and other devices and software in the latest Android phones and tablets.

Get it Now!  

2 Responses to "Bluetooth Data Transfer with Android"

  1. Harshal says:

    I want to devlop an app which should first ask for BT connection of another device and after pairing both device when user press a Button in the app an data will be sent to paired BT device which is connected to user’s device.

  2. Juan says:

    I keep getting the error “Bluetooth share file unknown file not sent”, anyone knows why could it be?

Leave a Reply


five − 1 =



Java Code Geeks and all content copyright © 2010-2014, Exelixis Media Ltd | Terms of Use | Privacy Policy
All trademarks and registered trademarks appearing on Java Code Geeks are the property of their respective owners.
Java is a trademark or registered trademark of Oracle Corporation in the United States and other countries.
Java Code Geeks is not connected to Oracle Corporation and is not sponsored by Oracle Corporation.

Sign up for our Newsletter

20,709 insiders are already enjoying weekly updates and complimentary whitepapers! Join them now to gain exclusive access to the latest news in the Java world, as well as insights about Android, Scala, Groovy and other related technologies.

As an extra bonus, by joining you will get our brand new e-books, published by Java Code Geeks and their JCG partners for your reading pleasure! Enter your info and stay on top of things,

  • Fresh trends
  • Cases and examples
  • Research and insights
  • Two complimentary e-books