java.lang.Object | |
↳ | android.bluetooth.BluetoothHeadset |
Public API for controlling the Bluetooth Headset Service. This includes both Bluetooth Headset and Handsfree (v1.5) profiles.
BluetoothHeadset is a proxy object for controlling the Bluetooth Headset Service via IPC.
Use getProfileProxy(Context, BluetoothProfile.ServiceListener, int)
to get
the BluetoothHeadset proxy object. Use
closeProfileProxy(int, BluetoothProfile)
to close the service connection.
Android only supports one connected Bluetooth Headset at a time. Each method is protected with its appropriate permission.
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
String | ACTION_AUDIO_STATE_CHANGED | Intent used to broadcast the change in the Audio Connection state of the A2DP profile. | |||||||||
String | ACTION_CONNECTION_STATE_CHANGED | Intent used to broadcast the change in connection state of the Headset profile. | |||||||||
String | ACTION_VENDOR_SPECIFIC_HEADSET_EVENT | Intent used to broadcast that the headset has posted a vendor-specific event. | |||||||||
int | AT_CMD_TYPE_ACTION | AT command type ACTION used with
EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD_TYPE
For example, AT+CHUP. |
|||||||||
int | AT_CMD_TYPE_BASIC | AT command type BASIC used with
EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD_TYPE
For example, ATD. |
|||||||||
int | AT_CMD_TYPE_READ | AT command type READ used with
EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD_TYPE
For example, AT+VGM?. |
|||||||||
int | AT_CMD_TYPE_SET | AT command type SET used with
EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD_TYPE
For example, AT+VGM= |
|||||||||
int | AT_CMD_TYPE_TEST | AT command type TEST used with
EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD_TYPE
For example, AT+VGM=?. |
|||||||||
String | EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_ARGS | A Parcelable String array extra field in
ACTION_VENDOR_SPECIFIC_HEADSET_EVENT intents that contains
the arguments to the vendor-specific command. |
|||||||||
String | EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD | A String extra field in ACTION_VENDOR_SPECIFIC_HEADSET_EVENT
intents that contains the name of the vendor-specific command. |
|||||||||
String | EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD_TYPE | An int extra field in ACTION_VENDOR_SPECIFIC_HEADSET_EVENT
intents that contains the AT command type of the vendor-specific command. |
|||||||||
int | STATE_AUDIO_CONNECTED | Headset state when SCO audio is connected. | |||||||||
int | STATE_AUDIO_CONNECTING | Headset state when SCO audio is connecting. | |||||||||
int | STATE_AUDIO_DISCONNECTED | Headset state when SCO audio is not connected. | |||||||||
String | VENDOR_RESULT_CODE_COMMAND_ANDROID | A vendor-specific command for unsolicited result code. | |||||||||
String | VENDOR_SPECIFIC_HEADSET_EVENT_COMPANY_ID_CATEGORY | The intent category to be used with ACTION_VENDOR_SPECIFIC_HEADSET_EVENT
for the companyId
|
[Expand]
Inherited Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From interface
android.bluetooth.BluetoothProfile
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Get connected devices for this specific profile.
| |||||||||||
Get the current connection state of the profile
Requires | |||||||||||
Get a list of devices that match any of the given connection
states.
| |||||||||||
Check if Bluetooth SCO audio is connected.
| |||||||||||
Sends a vendor-specific unsolicited result code to the headset.
| |||||||||||
Start Bluetooth voice recognition.
| |||||||||||
Stop Bluetooth Voice Recognition mode, and shut down the
Bluetooth audio path.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
| |||||||||||
From interface
android.bluetooth.BluetoothProfile
|
Intent used to broadcast the change in the Audio Connection state of the A2DP profile.
This intent will have 3 extras:
EXTRA_STATE
- The current state of the profile. EXTRA_PREVIOUS_STATE
- The previous state of the profile. EXTRA_DEVICE
- The remote device. EXTRA_STATE
or EXTRA_PREVIOUS_STATE
can be any of
STATE_AUDIO_CONNECTED
, STATE_AUDIO_DISCONNECTED
,
Requires BLUETOOTH
permission
to receive.
Intent used to broadcast the change in connection state of the Headset profile.
This intent will have 3 extras:
EXTRA_STATE
- The current state of the profile. EXTRA_PREVIOUS_STATE
- The previous state of the profile. EXTRA_DEVICE
- The remote device. EXTRA_STATE
or EXTRA_PREVIOUS_STATE
can be any of
STATE_DISCONNECTED
, STATE_CONNECTING
,
STATE_CONNECTED
, STATE_DISCONNECTING
.
Requires BLUETOOTH
permission to
receive.
Intent used to broadcast that the headset has posted a vendor-specific event.
This intent will have 4 extras and 1 category.
EXTRA_DEVICE
- The remote Bluetooth Device
EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD
- The vendor
specific command EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD_TYPE
- The AT
command type which can be one of AT_CMD_TYPE_READ
,
AT_CMD_TYPE_TEST
, or AT_CMD_TYPE_SET
,
AT_CMD_TYPE_BASIC
,AT_CMD_TYPE_ACTION
. EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_ARGS
- Command
arguments. The category is the Company ID of the vendor defining the
vendor-specific command. BluetoothAssignedNumbers
For example, for Plantronics specific events
Category will be VENDOR_SPECIFIC_HEADSET_EVENT_COMPANY_ID_CATEGORY
.55
For example, an AT+XEVENT=foo,3 will get translated into
Requires BLUETOOTH
permission
to receive.
AT command type ACTION used with
EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD_TYPE
For example, AT+CHUP. There are no arguments for action commands.
AT command type BASIC used with
EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD_TYPE
For example, ATD. Single character commands and everything following the
character are arguments.
AT command type READ used with
EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD_TYPE
For example, AT+VGM?. There are no arguments for this command type.
AT command type SET used with
EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD_TYPE
For example, AT+VGM=
AT command type TEST used with
EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD_TYPE
For example, AT+VGM=?. There are no arguments for this command type.
A Parcelable String array extra field in
ACTION_VENDOR_SPECIFIC_HEADSET_EVENT
intents that contains
the arguments to the vendor-specific command.
A String extra field in ACTION_VENDOR_SPECIFIC_HEADSET_EVENT
intents that contains the name of the vendor-specific command.
An int extra field in ACTION_VENDOR_SPECIFIC_HEADSET_EVENT
intents that contains the AT command type of the vendor-specific command.
Headset state when SCO audio is connected.
This state can be one of
EXTRA_STATE
or EXTRA_PREVIOUS_STATE
of
ACTION_AUDIO_STATE_CHANGED
intent.
Headset state when SCO audio is connecting.
This state can be one of
EXTRA_STATE
or EXTRA_PREVIOUS_STATE
of
ACTION_AUDIO_STATE_CHANGED
intent.
Headset state when SCO audio is not connected.
This state can be one of
EXTRA_STATE
or EXTRA_PREVIOUS_STATE
of
ACTION_AUDIO_STATE_CHANGED
intent.
A vendor-specific command for unsolicited result code.
The intent category to be used with ACTION_VENDOR_SPECIFIC_HEADSET_EVENT
for the companyId
Get connected devices for this specific profile.
Return the set of devices which are in state STATE_CONNECTED
Requires BLUETOOTH
permission.
Get the current connection state of the profile
Requires BLUETOOTH
permission.
device | Remote bluetooth device. |
---|
STATE_CONNECTED
, STATE_CONNECTING
,
STATE_DISCONNECTED
, STATE_DISCONNECTING
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.
Requires BLUETOOTH
permission.
states | Array of states. States can be one of
STATE_CONNECTED , STATE_CONNECTING ,
STATE_DISCONNECTED , STATE_DISCONNECTING , |
---|
Check if Bluetooth SCO audio is connected.
Requires BLUETOOTH
permission.
device | Bluetooth headset |
---|
Sends a vendor-specific unsolicited result code to the headset.
The actual string to be sent is command + ": " + arg
.
For example, if command
is VENDOR_RESULT_CODE_COMMAND_ANDROID
and arg
is "0"
, the string "+ANDROID: 0"
will be sent.
Currently only VENDOR_RESULT_CODE_COMMAND_ANDROID
is allowed as command
.
Requires BLUETOOTH
permission.
device | Bluetooth headset. |
---|---|
command | A vendor-specific command. |
arg | The argument that will be attached to the command. |
false
if there is no headset connected, or if the command is not an allowed
vendor-specific unsolicited result code, or on error. true
otherwise.IllegalArgumentException | if command is null .
|
---|
Start Bluetooth voice recognition. This methods sends the voice recognition AT command to the headset and establishes the audio connection.
Users can listen to ACTION_AUDIO_STATE_CHANGED
.
If this function returns true, this intent will be broadcasted with
EXTRA_STATE
set to STATE_AUDIO_CONNECTING
.
EXTRA_STATE
will transition from
STATE_AUDIO_CONNECTING
to STATE_AUDIO_CONNECTED
when
audio connection is established and to STATE_AUDIO_DISCONNECTED
in case of failure to establish the audio connection.
Requires BLUETOOTH
permission.
device | Bluetooth headset |
---|
Stop Bluetooth Voice Recognition mode, and shut down the Bluetooth audio path.
Requires BLUETOOTH
permission.
device | Bluetooth headset |
---|