ch.aplu.android.bluetooth

Class BluetoothPeer

java.lang.Object

ch.aplu.android.bluetooth.BluetoothPeer

public class BluetoothPeer
extends java.lang.Object

Class that implements a Bluetooth peer-to-peer communication based on the client-server model. When started, an running server is searched with a specified Bluetooth service. If found, the connection is established in a client mode. Otherwise a server mode with the given service name is started.

Data is exchanged as integer blocks of arbitrary length.

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
BluetoothPeer(android.app.Activity activity, android.bluetooth.BluetoothDevice partnerDevice, java.lang.String serviceName, BluetoothPeerListener listener, boolean isVerbose) Creates a BluetoothPeer instance that tries to connect to the given node using the given service name.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	isConnected() Returns the connection status.
boolean	isServer() Checks if the current instance acts as server.
void	releaseConnection() Releases a connection as client or server.
void	sendDataBlock(int[] data) Send a block of data to the connected node.

Methods inherited from class java.lang.Object

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

Constructor Detail

BluetoothPeer

public BluetoothPeer(android.app.Activity activity,
             android.bluetooth.BluetoothDevice partnerDevice,
             java.lang.String serviceName,
             BluetoothPeerListener listener,
             boolean isVerbose)

Creates a BluetoothPeer instance that tries to connect to the given node using the given service name. When the call returns, the connection is established or we are waiting as server for an incoming connection. isPeerConnected() can be called to check the case.

The given listener receives notifications about connection status and incoming data blocks.

Parameters:

activity - the Activity from where to get the BluetoothAdapter

partnerDevice - the BluetoothDevice of the partner node. If null, starts immediately as Bluetooth server

serviceName - the Bluetooth service name used for the communication channel

listener - the BluetoothPeerListener that receives notifications

isVerbose - if true, information of all data exchanged is displayed in debug console

Method Detail

sendDataBlock

public void sendDataBlock(int[] data)

Send a block of data to the connected node. Returns immediately if not connected.

Parameters:

data - the data block to send

isConnected

public boolean isConnected()

Returns the connection status. If the current instance is a server, returns true, if a client is connected. If the current instance is a client, returns true, if it is connected to a server.

Returns:

true, if connected; otherwise false

releaseConnection

public void releaseConnection()

Releases a connection as client or server. If no connection is established, nothing happens. You should call this cleanup method to be sure that the Bluetooth service is shutdown.

isServer

public boolean isServer()

Checks if the current instance acts as server.

Returns:

true, if the current instance behaves like a BluetoothServer; false, if it behaves like a BluetoothClient