Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)
Android APIs
public final class

BluetoothManager

extends Object
java.lang.Object
   ↳ android.bluetooth.BluetoothManager

Class Overview

High level manager used to obtain an instance of an BluetoothAdapter and to conduct overall Bluetooth Management.

Use getSystemService(java.lang.String) with BLUETOOTH_SERVICE to create an BluetoothManager , then call getAdapter() to obtain the BluetoothAdapter .

Alternately, you can just call the static helper getDefaultAdapter() .

Developer Guides

For more information about using BLUETOOTH, read the Bluetooth developer guide.

See Also

Summary

Public Methods
BluetoothAdapter getAdapter ()
Get the default BLUETOOTH Adapter for this device.
List < BluetoothDevice > getConnectedDevices (int profile)
Get connected devices for the specified profile.
int getConnectionState ( BluetoothDevice device, int profile)
Get the current connection state of the profile to the remote device.
List < BluetoothDevice > getDevicesMatchingConnectionStates (int profile, int[] states)
Get a list of devices that match any of the given connection states.
BluetoothGattServer openGattServer ( Context context, BluetoothGattServerCallback callback)
Open a GATT Server The callback is used to deliver results to Caller, such as connection status as well as the results of any other GATT server operations.
[Expand]
Inherited Methods
From class java.lang.Object

Public Methods

public BluetoothAdapter getAdapter ()

Get the default BLUETOOTH Adapter for this device.

Returns
  • the default BLUETOOTH Adapter

public List < BluetoothDevice > getConnectedDevices (int profile)

Get connected devices for the specified profile.

Return the set of devices which are in state STATE_CONNECTED

This is not specific to any application configuration but represents the connection state of Bluetooth for this profile. This can be used by applications like status bar which would just like to know the state of Bluetooth.

Requires BLUETOOTH permission.

Parameters
profile GATT or GATT_SERVER
Returns
  • List of devices. The list will be empty on error.

public int getConnectionState ( BluetoothDevice device, int profile)

Get the current connection state of the profile to the remote device.

This is not specific to any application configuration but represents the connection state of the local Bluetooth adapter for certain profile. This can be used by applications like status bar which would just like to know the state of Bluetooth.

Requires BLUETOOTH permission.

Parameters
device Remote bluetooth device.
profile GATT or GATT_SERVER
Returns

public List < BluetoothDevice > getDevicesMatchingConnectionStates (int profile, int[] states)

Get a list of devices that match any of the given connection states.

If none of the devices match any of the given states, an empty list will be returned.

This is not specific to any application configuration but represents the connection state of the local Bluetooth adapter for this profile. This can be used by applications like status bar which would just like to know the state of the local adapter.

Requires BLUETOOTH permission.

Parameters
profile GATT or GATT_SERVER
states Array of states. States can be one of STATE_CONNECTED , STATE_CONNECTING , STATE_DISCONNECTED , STATE_DISCONNECTING ,
Returns
  • List of devices. The list will be empty on error.

public BluetoothGattServer openGattServer ( Context context, BluetoothGattServerCallback callback)

Open a GATT Server The callback is used to deliver results to Caller, such as connection status as well as the results of any other GATT server operations. The method returns a BluetoothGattServer instance. You can use BluetoothGattServer to conduct GATT server operations.

Parameters
context App context
callback GATT server callback handler that will receive asynchronous callbacks.
Returns
  • BluetoothGattServer instance