ej.bluetooth

Class BluetoothDevice

java.lang.Object

ej.bluetooth.BluetoothDevice

public class BluetoothDevice
extends java.lang.Object

The BluetoothDevice class represents a remote Bluetooth device.

Devices may be retrieved from the Bluetooth adapter by scanning or advertising.

This class provides methods to get information on the remote device. It also allows to manage the connection with this device, to manage pairing and to discover the services that the device provides.

Method Summary

Modifier and Type	Method and Description
boolean	connect(ConnectionCallbacks connectionCallbacks) Initiates connection with this device.
boolean	disconnect() Initiates disconnection with this device.
boolean	discoverServices() Initiates the discovery of the services provided by this device.
BluetoothService	findService(BluetoothUuid serviceUuid) Returns the service with the given UUID.
java.lang.String	getAddress() Returns the Bluetooth address of this device.
BluetoothService[]	getServices() Returns the list of services provided by this device.
boolean	isConnected() Returns whether the adapter is currently connected to this device.
boolean	pair() Initiates pairing with this device.
boolean	pairReply(boolean accept) Replies to the pairing request of this device.
boolean	passkeyReply(boolean accept, int passkey) Replies to the passkey request of this device.

Methods inherited from class java.lang.Object

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

Method Detail

getAddress

public java.lang.String getAddress()

Returns the Bluetooth address of this device.

Returns:

the Bluetooth address of this device.

getServices

public BluetoothService[] getServices()

Returns the list of services provided by this device.

This method does not perform a services discovery and only returns the services which have been found earlier by discovering services. If the adapter is not connected to this device or if the services of this device have not been discovered so far, an empty list will be returned.

The GATT events related to these services may be handled by setting the client callbacks.

Returns:

the list of services provided by this device.

See Also:

findService(BluetoothUuid)

findService

public BluetoothService findService(BluetoothUuid serviceUuid)

Returns the service with the given UUID.

This method is equivalent of looking up the service with the given UUID in the list returned by getServices().

The GATT events related to this service may be handled by setting the client callbacks.

Parameters:

serviceUuid - the UUID of the service to look for.

Returns:

the service with the given UUID, or null if it not in the services list.

See Also:

getServices()

connect

public boolean connect(ConnectionCallbacks connectionCallbacks)

Initiates connection with this device.

The connectionCallbacks object will receive the connection events.

Parameters:

connectionCallbacks - the object which will receive the connection events.

Returns:

true if connection was initiated successfully, false otherwise.

See Also:

ConnectionCallbacks.onConnectFailed(BluetoothDevice), ConnectionCallbacks.onConnected(BluetoothDevice)

disconnect

public boolean disconnect()

Initiates disconnection with this device.

Returns:

true if disconnection was initiated successfully, false otherwise.

See Also:

ConnectionCallbacks.onDisconnected(BluetoothDevice)

isConnected

public boolean isConnected()

Returns whether the adapter is currently connected to this device.

Returns:

true if the adapter is connected to this device, false otherwise.

pair

public boolean pair()

Initiates pairing with this device.

This operation may only be performed while connected to this device.

Returns:

true if pairing was initiated successfully, false otherwise.

See Also:

ConnectionCallbacks.onPairCompleted(BluetoothDevice, boolean), ConnectionCallbacks.onPasskeyRequest(BluetoothDevice)

pairReply

public boolean pairReply(boolean accept)

Replies to the pairing request of this device.

This operation may only be performed after received a pairing request.

Parameters:

accept - true if the pairing request should be accepted, false otherwise.

Returns:

true if the reply was sent successfully, false otherwise.

See Also:

ConnectionCallbacks.onPairCompleted(BluetoothDevice, boolean), ConnectionCallbacks.onPasskeyGenerated(BluetoothDevice, int)

passkeyReply

public boolean passkeyReply(boolean accept,
                            int passkey)

Replies to the passkey request of this device.

This operation may only be performed after received a passkey request.

Parameters:

accept - true if the passkey request should be accepted, false otherwise.

passkey - the passkey value (6-digits PIN code).

Returns:

true if the reply was sent successfully, false otherwise.

See Also:

ConnectionCallbacks.onPairCompleted(BluetoothDevice, boolean)

discoverServices

public boolean discoverServices()

Initiates the discovery of the services provided by this device.

This operation may only be performed while connected to this device.

Returns:

true if services discovery was initiated successfully, false otherwise.

See Also:

ConnectionCallbacks.onServicesDiscovered(BluetoothDevice)