# BluetoothProfile Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary:[Nested Classes](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#nestedclasses)\|[Constants](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#constants)\|[Methods](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#pubmethods) # BluetoothProfile *** ** * ** *** [Kotlin](https://developer.android.com/reference/kotlin/android/bluetooth/BluetoothProfile "View this page in Kotlin")\|Java ` public interface BluetoothProfile ` ` ` |------------------------------------| | android.bluetooth.BluetoothProfile | |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Known indirect subclasses [BluetoothA2dp](https://developer.android.com/reference/android/bluetooth/BluetoothA2dp),[BluetoothCsipSetCoordinator](https://developer.android.com/reference/android/bluetooth/BluetoothCsipSetCoordinator),[BluetoothGatt](https://developer.android.com/reference/android/bluetooth/BluetoothGatt),[BluetoothGattServer](https://developer.android.com/reference/android/bluetooth/BluetoothGattServer),[BluetoothHeadset](https://developer.android.com/reference/android/bluetooth/BluetoothHeadset),[BluetoothHealth](https://developer.android.com/reference/android/bluetooth/BluetoothHealth),[BluetoothHearingAid](https://developer.android.com/reference/android/bluetooth/BluetoothHearingAid),[BluetoothHidDevice](https://developer.android.com/reference/android/bluetooth/BluetoothHidDevice),[BluetoothLeAudio](https://developer.android.com/reference/android/bluetooth/BluetoothLeAudio) |----------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [BluetoothA2dp](https://developer.android.com/reference/android/bluetooth/BluetoothA2dp) | This class provides the public APIs to control the Bluetooth A2DP profile. | | [BluetoothCsipSetCoordinator](https://developer.android.com/reference/android/bluetooth/BluetoothCsipSetCoordinator) | This class provides the public APIs to control the Bluetooth CSIP set coordinator. | | [BluetoothGatt](https://developer.android.com/reference/android/bluetooth/BluetoothGatt) | Public API for the Bluetooth GATT Profile. | | [BluetoothGattServer](https://developer.android.com/reference/android/bluetooth/BluetoothGattServer) | Public API for the Bluetooth GATT Profile server role. | | [BluetoothHeadset](https://developer.android.com/reference/android/bluetooth/BluetoothHeadset) | Public API for controlling the Bluetooth Headset Service. | | [BluetoothHealth](https://developer.android.com/reference/android/bluetooth/BluetoothHealth) | *This class was deprecated in API level 29. Health Device Profile (HDP) and MCAP protocol are no longer used. New apps should use Bluetooth Low Energy based solutions such as[BluetoothGatt](https://developer.android.com/reference/android/bluetooth/BluetoothGatt),[BluetoothAdapter.listenUsingL2capChannel()](https://developer.android.com/reference/android/bluetooth/BluetoothAdapter#listenUsingL2capChannel()), or[BluetoothDevice.createL2capChannel(int)](https://developer.android.com/reference/android/bluetooth/BluetoothDevice#createL2capChannel(int))* | | [BluetoothHearingAid](https://developer.android.com/reference/android/bluetooth/BluetoothHearingAid) | This class provides the public APIs to control the Hearing Aid profile. | | [BluetoothHidDevice](https://developer.android.com/reference/android/bluetooth/BluetoothHidDevice) | Provides the public APIs to control the Bluetooth HID Device profile. | | [BluetoothLeAudio](https://developer.android.com/reference/android/bluetooth/BluetoothLeAudio) | This class provides the public APIs to control the LeAudio profile. | |
*** ** * ** *** Public APIs for the Bluetooth Profiles. Clients should call[BluetoothAdapter.getProfileProxy](https://developer.android.com/reference/android/bluetooth/BluetoothAdapter#getProfileProxy(android.content.Context,%20android.bluetooth.BluetoothProfile.ServiceListener,%20int)), to get the Profile Proxy. Each public profile implements this interface. ## Summary | ### Nested classes || |--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` interface` | [BluetoothProfile.ServiceListener](https://developer.android.com/reference/android/bluetooth/BluetoothProfile.ServiceListener) An interface for notifying BluetoothProfile IPC clients when they have been connected or disconnected to the service. | | ### Constants || |--------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `int` | [A2DP](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#A2DP) Advanced Audio Distribution Profile (A2DP) | | `int` | [CSIP_SET_COORDINATOR](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#CSIP_SET_COORDINATOR) Coordinated Set Identification Profile (CSIP) set coordinator | | [String](https://developer.android.com/reference/java/lang/String) | [EXTRA_PREVIOUS_STATE](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#EXTRA_PREVIOUS_STATE) Extra for the connection state intents of the individual profiles. | | [String](https://developer.android.com/reference/java/lang/String) | [EXTRA_PROFILE](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#EXTRA_PROFILE) Extra for the[BluetoothProfile](https://developer.android.com/reference/android/bluetooth/BluetoothProfile)that the intent applies to. | | [String](https://developer.android.com/reference/java/lang/String) | [EXTRA_STATE](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#EXTRA_STATE) Extra for the connection state intents of the individual profiles. | | `int` | [GATT](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#GATT) Generic Attribute Profile (GATT) | | `int` | [GATT_SERVER](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#GATT_SERVER) Generic Attribute Profile (GATT) Server | | `int` | [HAP_CLIENT](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#HAP_CLIENT)
| | `int` | [HEADSET](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#HEADSET) Headset and Handsfree profile | | `int` | [HEALTH](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#HEALTH) *This constant was deprecated in API level 29. Health Device Profile (HDP) and MCAP protocol are no longer used. New apps should use Bluetooth Low Energy based solutions such as[BluetoothGatt](https://developer.android.com/reference/android/bluetooth/BluetoothGatt),[BluetoothAdapter.listenUsingL2capChannel()](https://developer.android.com/reference/android/bluetooth/BluetoothAdapter#listenUsingL2capChannel()), or[BluetoothDevice.createL2capChannel(int)](https://developer.android.com/reference/android/bluetooth/BluetoothDevice#createL2capChannel(int))* | | `int` | [HEARING_AID](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#HEARING_AID) Hearing Aid Device | | `int` | [HID_DEVICE](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#HID_DEVICE) Human Interface Device (HID) Device | | `int` | [LE_AUDIO](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#LE_AUDIO) LE Audio Device | | `int` | [SAP](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#SAP) SIM Access Profile (SAP) | | `int` | [STATE_CONNECTED](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#STATE_CONNECTED) The profile is in connected state | | `int` | [STATE_CONNECTING](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#STATE_CONNECTING) The profile is in connecting state | | `int` | [STATE_DISCONNECTED](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#STATE_DISCONNECTED) The profile is in disconnected state | | `int` | [STATE_DISCONNECTING](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#STATE_DISCONNECTING) The profile is in disconnecting state | | ### Public methods || |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` abstract `[List](https://developer.android.com/reference/java/util/List)`<`[BluetoothDevice](https://developer.android.com/reference/android/bluetooth/BluetoothDevice)`>` | ` `[getConnectedDevices](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#getConnectedDevices())`() ` Get connected devices for this specific profile. | | ` abstract int` | ` `[getConnectionState](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#getConnectionState(android.bluetooth.BluetoothDevice))`(`[BluetoothDevice](https://developer.android.com/reference/android/bluetooth/BluetoothDevice)` device) ` Get the current connection state of the profile | | ` abstract `[List](https://developer.android.com/reference/java/util/List)`<`[BluetoothDevice](https://developer.android.com/reference/android/bluetooth/BluetoothDevice)`>` | ` `[getDevicesMatchingConnectionStates](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#getDevicesMatchingConnectionStates(int[]))`(int[] states) ` Get a list of devices that match any of the given connection states. | ## Constants ### A2DP Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static final int A2DP ``` Advanced Audio Distribution Profile (A2DP)
Constant Value: 2 (0x00000002) ### CSIP_SET_COORDINATOR Added in[API level 33](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static final int CSIP_SET_COORDINATOR ``` Coordinated Set Identification Profile (CSIP) set coordinator
Constant Value: 25 (0x00000019) ### EXTRA_PREVIOUS_STATE Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static final String EXTRA_PREVIOUS_STATE ``` Extra for the connection state intents of the individual profiles. This extra represents the previous connection state of the profile of the Bluetooth device.
Constant Value: "android.bluetooth.profile.extra.PREVIOUS_STATE" ### EXTRA_PROFILE Added in[version 36.1](https://developer.android.com/topic/libraries/support-library/revisions) ``` public static final String EXTRA_PROFILE ``` Extra for the[BluetoothProfile](https://developer.android.com/reference/android/bluetooth/BluetoothProfile)that the intent applies to. This extra represents the Bluetooth profile that the intent applies to.
Constant Value: "android.bluetooth.profile.extra.PROFILE" ### EXTRA_STATE Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static final String EXTRA_STATE ``` Extra for the connection state intents of the individual profiles. This extra represents the current connection state of the profile of the Bluetooth device.
Constant Value: "android.bluetooth.profile.extra.STATE" ### GATT Added in[API level 18](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static final int GATT ``` Generic Attribute Profile (GATT)
Constant Value: 7 (0x00000007) ### GATT_SERVER Added in[API level 18](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static final int GATT_SERVER ``` Generic Attribute Profile (GATT) Server
Constant Value: 8 (0x00000008) ### HAP_CLIENT Added in[API level 33](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static final int HAP_CLIENT ```

Constant Value: 28 (0x0000001c) ### HEADSET Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static final int HEADSET ``` Headset and Handsfree profile
Constant Value: 1 (0x00000001) ### HEALTH Added in[API level 14](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Deprecated in[API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static final int HEALTH ```
**This constant was deprecated in API level 29.** Health Device Profile (HDP) and MCAP protocol are no longer used. New apps should use Bluetooth Low Energy based solutions such as[BluetoothGatt](https://developer.android.com/reference/android/bluetooth/BluetoothGatt),[BluetoothAdapter.listenUsingL2capChannel()](https://developer.android.com/reference/android/bluetooth/BluetoothAdapter#listenUsingL2capChannel()), or[BluetoothDevice.createL2capChannel(int)](https://developer.android.com/reference/android/bluetooth/BluetoothDevice#createL2capChannel(int)) Health Profile
Constant Value: 3 (0x00000003) ### HEARING_AID Added in[API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static final int HEARING_AID ``` Hearing Aid Device
Constant Value: 21 (0x00000015) ### HID_DEVICE Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static final int HID_DEVICE ``` Human Interface Device (HID) Device
Constant Value: 19 (0x00000013) ### LE_AUDIO Added in[API level 33](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static final int LE_AUDIO ``` LE Audio Device
Constant Value: 22 (0x00000016) ### SAP Added in[API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static final int SAP ``` SIM Access Profile (SAP)
Constant Value: 10 (0x0000000a) ### STATE_CONNECTED Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static final int STATE_CONNECTED ``` The profile is in connected state
Constant Value: 2 (0x00000002) ### STATE_CONNECTING Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static final int STATE_CONNECTING ``` The profile is in connecting state
Constant Value: 1 (0x00000001) ### STATE_DISCONNECTED Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static final int STATE_DISCONNECTED ``` The profile is in disconnected state
Constant Value: 0 (0x00000000) ### STATE_DISCONNECTING Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static final int STATE_DISCONNECTING ``` The profile is in disconnecting state
Constant Value: 3 (0x00000003) ## Public methods ### getConnectedDevices Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract List getConnectedDevices () ``` Get connected devices for this specific profile. Return the set of devices which are in state[STATE_CONNECTED](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#STATE_CONNECTED)
| Returns || |------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------| | [List](https://developer.android.com/reference/java/util/List)`<`[BluetoothDevice](https://developer.android.com/reference/android/bluetooth/BluetoothDevice)`>` | List of devices. The list will be empty on error.
| ### getConnectionState Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract int getConnectionState (BluetoothDevice device) ``` Get the current connection state of the profile
| Parameters || |----------|----------------------------------------------------| | `device` | `BluetoothDevice`: Remote bluetooth device.
| | Returns || |-------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `int` | State of the profile connection. One of[STATE_CONNECTED](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#STATE_CONNECTED),[STATE_CONNECTING](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#STATE_CONNECTING),[STATE_DISCONNECTED](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#STATE_DISCONNECTED),[STATE_DISCONNECTING](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#STATE_DISCONNECTING)Value is[STATE_DISCONNECTED](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#STATE_DISCONNECTED),[STATE_CONNECTING](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#STATE_CONNECTING),[STATE_CONNECTED](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#STATE_CONNECTED), or[STATE_DISCONNECTING](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#STATE_DISCONNECTING)
| ### getDevicesMatchingConnectionStates Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract List getDevicesMatchingConnectionStates (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.
| Parameters || |----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `states` | `int`: Array of states. States can be one of[STATE_CONNECTED](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#STATE_CONNECTED),[STATE_CONNECTING](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#STATE_CONNECTING),[STATE_DISCONNECTED](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#STATE_DISCONNECTED),[STATE_DISCONNECTING](https://developer.android.com/reference/android/bluetooth/BluetoothProfile#STATE_DISCONNECTING),
| | Returns || |------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------| | [List](https://developer.android.com/reference/java/util/List)`<`[BluetoothDevice](https://developer.android.com/reference/android/bluetooth/BluetoothDevice)`>` | List of devices. The list will be empty on error.
|