The Android platform includes support for the Bluetooth network stack, which
allows a device to wirelessly exchange data with other Bluetooth devices. The
app framework provides access to the Bluetooth functionality through Bluetooth
APIs. These APIs let apps connect to other Bluetooth devices, enabling
point-to-point and multipoint wireless features.

Using the Bluetooth APIs, an app can perform the following:

- Scan for other Bluetooth devices.
- Query the local Bluetooth adapter for paired Bluetooth devices.
- Establish RFCOMM channels.
- Connect to other devices through service discovery.
- Transfer data to and from other devices.
- Manage multiple connections.

This topic focuses on *Classic Bluetooth* . Classic Bluetooth is the right choice
for more battery-intensive operations, which include streaming and communicating
between devices. For Bluetooth devices with low power requirements, consider
using [Bluetooth Low Energy](https://developer.android.com/develop/connectivity/bluetooth/ble-overview)
connections.

This documentation describes different Bluetooth
[profiles](https://developer.android.com/develop/connectivity/bluetooth/profiles) and explains how to
use the Bluetooth APIs to accomplish the four major tasks necessary to
communicate using Bluetooth:

- Setting up Bluetooth.
- Finding devices that are either paired or available in the local area.
- Connecting devices.
- Transferring data between devices.

For a demonstration of using the Bluetooth APIs, see the [Bluetooth Chat sample
app](https://github.com/android/connectivity-samples/tree/master/BluetoothChat).

## The basics

For Bluetooth-enabled devices to transmit data between each other, they must
first form a channel of communication using a pairing process. One device, a
discoverable device, makes itself available for incoming connection requests.
Another device finds the discoverable device using a service discovery process.
After the discoverable device accepts the pairing request, the two devices
complete a bonding process in which they exchange security keys. The devices
cache these keys for later use. After the pairing and bonding processes are
complete, the two devices exchange information. When the session is complete,
the device that initiated the pairing request releases the channel that had
linked it to the discoverable device. The two devices remain bonded, however, so
they can reconnect automatically during a future session as long as they're in
range of each other and neither device has removed the bond.

Use of the Bluetooth APIs requires
[declaring several permissions](https://developer.android.com/develop/connectivity/bluetooth/bt-permissions#declare)
in your manifest file. Once your app has permission to use Bluetooth, your app
needs to access the
[`BluetoothAdapter`](https://developer.android.com/reference/android/bluetooth/BluetoothAdapter) and
[determine if Bluetooth is available on the device](https://developer.android.com/develop/connectivity/bluetooth/setup).
If Bluetooth is available, there are three steps to make a connection:

- [Find nearby Bluetooth
  devices](https://developer.android.com/develop/connectivity/bluetooth/find-bluetooth-devices), either devices that are already paired or new ones.
- [Connect to a Bluetooth
  device](https://developer.android.com/develop/connectivity/bluetooth/connect-bluetooth-devices).
- [Transfer data with the connected
  device](https://developer.android.com/develop/connectivity/bluetooth/transfer-data).

Certain devices use a specific [Bluetooth
profile](https://developer.android.com/develop/connectivity/bluetooth/profiles) that declares the data
it provides.

## Key classes and interfaces

All of the Bluetooth APIs are available in the
[`android.bluetooth`](https://developer.android.com/reference/android/bluetooth/package-summary) package.
The following are the classes and interfaces you need in order to create
Bluetooth connections:

[`BluetoothAdapter`](https://developer.android.com/reference/android/bluetooth/BluetoothAdapter)
:   Represents the local Bluetooth adapter (Bluetooth radio). The
    `BluetoothAdapter` is the entry-point for all Bluetooth interaction. Using
    this, you can discover other Bluetooth devices, query a list of bonded
    (paired) devices, instantiate a
    `BluetoothDevice` using a known MAC address, and create a
    `BluetoothServerSocket` to listen for communications from other devices.

[`BluetoothDevice`](https://developer.android.com/reference/android/bluetooth/BluetoothDevice)
:   Represents a remote Bluetooth device. Use this to request a connection with a
    remote device through a `BluetoothSocket` or query information about the
    device such as its name, address, class, and bonding state.

[`BluetoothSocket`](https://developer.android.com/reference/android/bluetooth/BluetoothSocket)
:   Represents the interface for a Bluetooth socket (similar to a TCP
    [`Socket`](https://developer.android.com/reference/java/net/Socket)). This is the connection point that
    allows an app to exchange data with another Bluetooth device using
    [`InputStream`](https://developer.android.com/reference/java/io/InputStream) and
    [`OutputStream`](https://developer.android.com/reference/java/io/OutputStream).

[`BluetoothServerSocket`](https://developer.android.com/reference/android/bluetooth/BluetoothServerSocket)
:   Represents an open server socket that listens for incoming requests (similar
    to a TCP [`ServerSocket`](https://developer.android.com/reference/java/net/ServerSocket)). In order to
    connect two devices, one device must open a server socket with this
    class. When a remote Bluetooth device makes a connection request to this
    device, the device accepts the connection and then returns a connected
    `BluetoothSocket`.

[`BluetoothClass`](https://developer.android.com/reference/android/bluetooth/BluetoothClass)
:   Describes the general characteristics and capabilities of a Bluetooth device.
    This is a read-only set of properties that defines the device's classes and
    services. Although this information provides a useful hint regarding a
    device's type, the attributes of this class don't necessarily describe all
    Bluetooth profiles and services that the device supports.

[`BluetoothProfile`](https://developer.android.com/reference/android/bluetooth/BluetoothProfile)
:   An interface that represents a Bluetooth profile. A Bluetooth profile is a
    wireless interface specification for Bluetooth-based communication between
    devices. An example is the Hands-Free profile. For more discussion of
    profiles, see [Bluetooth profiles](https://developer.android.com/develop/connectivity/bluetooth/profiles).

[`BluetoothHeadset`](https://developer.android.com/reference/android/bluetooth/BluetoothHeadset)
:   Provides support for Bluetooth headsets to be used with mobile phones. This
    includes both the Bluetooth Headset profile and the Hands-Free (v1.5) profile.

[`BluetoothA2dp`](https://developer.android.com/reference/android/bluetooth/BluetoothA2dp)
:   Defines how high-quality audio can be streamed from one device to another over
    a Bluetooth connection using the Advanced Audio Distribution Profile (A2DP).

[`BluetoothHealth`](https://developer.android.com/reference/android/bluetooth/BluetoothHealth)
:   Represents a Health Device Profile proxy that controls the Bluetooth service.

[`BluetoothHealthCallback`](https://developer.android.com/reference/android/bluetooth/BluetoothHealthCallback)
:   An abstract class that you use to implement `BluetoothHealth` callbacks. You
    must extend this class and implement the callback methods to receive updates
    about changes in the app's registration state and Bluetooth channel
    state.

[`BluetoothHealthAppConfiguration`](https://developer.android.com/reference/android/bluetooth/BluetoothHealthAppConfiguration)
:   Represents an app configuration that the Bluetooth Health third-party
    app registers to communicate with a remote Bluetooth health device.

[`BluetoothProfile.ServiceListener`](https://developer.android.com/reference/android/bluetooth/BluetoothProfile.ServiceListener)
:   An interface that notifies `BluetoothProfile` interprocess communication (IPC)
    clients when they have been connected to or disconnected from the internal
    service that runs a particular profile.