ch.aplu.android.bluetooth

Class BluetoothDiscovery

java.lang.Object

ch.aplu.android.bluetooth.BluetoothDiscovery

public class BluetoothDiscovery
extends java.lang.Object

Class for finding remote Bluetooth devices by an device discovery process.

You must add the following two lines as second to last lines in AndroidManifest.xml (the line before </manifest>):
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />

Constructor Summary

Constructors

Constructor and Description
BluetoothDiscovery(android.app.Activity activity) Creates a BluetoothDiscovery instance to perform Bluetooth discovery actions.

Method Summary

Methods

Modifier and Type	Method and Description
android.bluetooth.BluetoothDevice	discoverBluetoothDevice(java.lang.String deviceName) If a Bluetooth device is supported and it is enabled, starts the discovery of remote Bluetooth device with given Bluetooth friendly name.
static android.bluetooth.BluetoothAdapter	getBluetoothAdapter(android.app.Activity activity) Returns the default Bluetooth adapter of the given activity.
android.bluetooth.BluetoothDevice	getPairedDevice(java.lang.String deviceName) Retrieves the Bluetooth device with given friendly Bluetooth name from the database of paired devices.
java.util.ArrayList<android.bluetooth.BluetoothDevice>	getPairedDevices() Returns a list of all remote Bluetooth devices that are paired with the local device.
int	startBluetoothDiscovery(BluetoothDiscoveryListener listener) If a Bluetooth device is supported and it is enabled, registers the given BluetoothDiscoveryListener and starts the discovery of remote Bluetooth devices.
void	unregisterBroadcastReceiver() Unregisters the broadcast receiver used for device discovery.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BluetoothDiscovery

public BluetoothDiscovery(android.app.Activity activity)

Creates a BluetoothDiscovery instance to perform Bluetooth discovery actions.

Parameters:

activity - the Activity from where to get the BluetoothAdapter

Method Detail

startBluetoothDiscovery

public int startBluetoothDiscovery(BluetoothDiscoveryListener listener)

If a Bluetooth device is supported and it is enabled, registers the given BluetoothDiscoveryListener and starts the discovery of remote Bluetooth devices. Returns immediately with a information return code.

Parameters:

listener - the BluetoothDiscoveryListener that will be notified when Bluetooth devices are detected and when the discovery process is finished

Returns:

0, if discovery is successfully started, -1 if Bluetooth is not supported, 1 if Bluetooth device is disabled

discoverBluetoothDevice

public android.bluetooth.BluetoothDevice discoverBluetoothDevice(java.lang.String deviceName)

If a Bluetooth device is supported and it is enabled, starts the discovery of remote Bluetooth device with given Bluetooth friendly name. Blocks until the device is found or the discovering is finished. Return a reference to the detected BluetoothDevice or null, if detection failed.

Parameters:

deviceName - the friedly Bluetooth device name of the device to search for

Returns:

a reference to the detected device or null, if detection failed because of no Bluetooth support, device not enabled or remote device not found.

getPairedDevices

public java.util.ArrayList<android.bluetooth.BluetoothDevice> getPairedDevices()

Returns a list of all remote Bluetooth devices that are paired with the local device. To retrieve the Bluetooth friendly name, use BluetoothDevice.getName(), to retrieve the MAC address, use BluetoothDevice.getAddress(). Once the address is known, a connection to the remote device can be engaged without a prior device discovery.

Returns:

a list of all paired (bonded) BluetoothDevices

getPairedDevice

public android.bluetooth.BluetoothDevice getPairedDevice(java.lang.String deviceName)

Retrieves the Bluetooth device with given friendly Bluetooth name from the database of paired devices.

Returns:

the BluetoothDevice with given name; null, if the device is not found in the database of paired (bonded) devices

getBluetoothAdapter

public static android.bluetooth.BluetoothAdapter getBluetoothAdapter(android.app.Activity activity)

Returns the default Bluetooth adapter of the given activity.

Returns:

the reference to the default BluetoothAdapter; null, if Bluetooth is not supported

unregisterBroadcastReceiver

public void unregisterBroadcastReceiver()

Unregisters the broadcast receiver used for device discovery.