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.

Do you want to know how to develop your skillset to become a Java Rockstar?

Subscribe to our newsletter to start Rocking right now!

To get you started we give you two of our best selling eBooks for FREE!

JPA Mini Book

Learn how to leverage the power of JPA in order to create robust and flexible Java applications. With this Mini Book, you will get introduced to JPA and smoothly transition to more advanced concepts.

JVM Troubleshooting Guide

The Java virtual machine is really the foundation of any Java EE platform. Learn how to master it with this advanced guide!

Given email address is already subscribed, thank you!
Oops. Something went wrong. Please try again later.
Please provide a valid email address.
Thank you, your sign-up request was successful! Please check your e-mail inbox.
Please complete the CAPTCHA.
Please fill in the required fields.

3 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?

  3. Filipe Sampaio says:

    Hello…
    Tanks to the explanation…

    But now, i need an handler example to catch the file from intent extra_stream…

    Can you help???

    Tanks again…

Leave a Reply


3 + two =



Java Code Geeks and all content copyright © 2010-2014, Exelixis Media Ltd | Terms of Use | Privacy Policy | Contact
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.
Do you want to know how to develop your skillset and become a ...
Java Rockstar?

Subscribe to our newsletter to start Rocking right now!

To get you started we give you two of our best selling eBooks for FREE!

Get ready to Rock!
You can download the complementary eBooks using the links below:
Close