ch.aplu.android.bluetooth

Class BluetoothClient

java.lang.Object

ch.aplu.android.bluetooth.BluetoothClient

public class BluetoothClient
extends java.lang.Object

Class to create a client that connects to a server via Bluetooth. Keep in mind that a server must be up and running before any client can connect.

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
BluetoothClient(android.bluetooth.BluetoothAdapter adapter, java.lang.String serverAddressHex) Creates a BluetoothClient instance for the given server's MAC address.
BluetoothClient(android.bluetooth.BluetoothDevice serverDevice) Creates a BluetoothClient instance for the given server's Bluetooth name.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	connect() Attemps to connect the client to the server.
void	disconnect() Closes the opened input and output stream and releases the Bluetooth connection.
java.lang.String	getAddressHex() Returns the server address in colon hex format (NN:NN:NN:NN:NN:NN).
long	getAddressLong() Returns the server address as long.
java.io.InputStream	getInputStream() Returns the InputStream of the Bluetooth connection.
java.io.OutputStream	getOutputStream() Returns the OutputStream of the Bluetooth connection.
android.bluetooth.BluetoothSocket	getSocket() Returns the BluetoothSocket of the Bluetooth connection.
boolean	isConnected() Returns the connection state.

Methods inherited from class java.lang.Object

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

Constructor Detail

BluetoothClient

public BluetoothClient(android.bluetooth.BluetoothDevice serverDevice)

Creates a BluetoothClient instance for the given server's Bluetooth name. No connection is established before connect() is called.

Parameters:

serverDevice - the valid BluetoothDevice reference of the server, obtained by a Bluetooth search

BluetoothClient

public BluetoothClient(android.bluetooth.BluetoothAdapter adapter,
               java.lang.String serverAddressHex)

Creates a BluetoothClient instance for the given server's MAC address. No connection is established before connect() is called.

Parameters:

adapter - the BluetoothAdapter for this device

serverAddressHex - the Bluetooth MAC address of the server in colon hex format (NN:NN:NN:NN:NN:NN)

Method Detail

connect

public boolean connect()

Attemps to connect the client to the server. The standard RFCOMM UUID 00001101-0000-1000-8000-00805F9B34FB is used. If the devices are not yet paired (bonded), a pairing dialog is automatically opened. Because the GameGrid's activity onPause() is called, the running application will terminate (unless GameGrid.enableKill(false) is invoked).

Returns:

true, if successful; false, if connection cannot be established or already connected

disconnect

public void disconnect()

Closes the opened input and output stream and releases the Bluetooth connection. Any blocking read method of a connected server will return with an end of stream value that informs the server that the client connection is lost. Closing the input stream will cause an IOException thrown by any blocking read method. If you forget to disconnect to release all resources, the next call of connect() may block for ever.

isConnected

public boolean isConnected()

Returns the connection state.

Returns:

true, if connected; otherwise false

getSocket

public android.bluetooth.BluetoothSocket getSocket()

Returns the BluetoothSocket of the Bluetooth connection.

Returns:

the BluetoothSocket or null, if not connected

getInputStream

public java.io.InputStream getInputStream()

Returns the InputStream of the Bluetooth connection.

Returns:

InputStream or null, if not connected

getOutputStream

public java.io.OutputStream getOutputStream()

Returns the OutputStream of the Bluetooth connection.

Returns:

OutputStream or null, if not connected

getAddressHex

public java.lang.String getAddressHex()

Returns the server address in colon hex format (NN:NN:NN:NN:NN:NN).

Returns:

server address in hex format (32 bits), even when the client is not connected to the server

getAddressLong

public long getAddressLong()

Returns the server address as long.

Returns:

server address as 32 bit long, even when the client is not connected to the server