Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge "Expose Vendor Specific Headset Event Intent."

Browse Source
This commit is contained in:
Jaikumar Ganesh
2010-10-25 16:43:41 -07:00
committed by Android (Google) Code Review
parent 9bb1278696 e775b3daab
commit 657dbfaedb
3 changed files with 1261 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1186
api/current.xml
View File

File diff suppressed because it is too large Load Diff

4
core/java/android/bluetooth/BluetoothAssignedNumbers.java
View File

@@ -23,12 +23,10 @@ package android.bluetooth;
* @see <a href="https://www.bluetooth.org/technical/assignednumbers/identifiers.htm">
* The Official Bluetooth SIG Member Website | Company Identifiers</a>
*
* @hide
*/
public class BluetoothAssignedNumbers {
//// Bluetooth SIG Company ID values
// Bluetooth SIG Company ID values
/*
* Ericsson Technology Licensing.
*/

88
core/java/android/bluetooth/BluetoothHeadset.java
View File

@@ -86,12 +86,35 @@ public final class BluetoothHeadset implements BluetoothProfile {
/**
* Broadcast Action: Indicates a headset has posted a vendor-specific event.
* <p>Always contains the extra fields {@link #EXTRA_DEVICE},
* {@link #EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD}, and
* {@link #EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_ARGS}.
* Intent used to broadcast that the headset has posted a
* vendor-specific event.
*
* <p>This intent will have 4 extras and 1 category.
* {@link BluetoothDevice#EXTRA_DEVICE} - The remote Bluetooth Device
* {@link #EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD} - The vendor specific
* command
* {@link #EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD_TYPE} - The AT command
* type.
* Can be one of {@link #AT_CMD_TYPE_READ}, {@link #AT_CMD_TYPE_TEST},
* or {@link #AT_CMD_TYPE_SET}, {@link #AT_CMD_TYPE_BASIC},
* {@link #AT_CMD_TYPE_ACTION}.
*
* {@link #EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_ARGS} - Command arguments.
*
* The category is the Company ID of the vendor defining the
* vendor-specific command. {@link BluetoothAssignedNumbers}
* @see <a href="https://www.bluetooth.org/Technical/AssignedNumbers/identifiers.htm">
* Bluetooth SIG Assigned Numbers - Company Identifiers</a>
*
* For example, for Plantronics specific events
* Category will be {@link #VENDOR_SPECIFIC_HEADSET_EVENT_COMPANY_ID_CATEGORY}.55
*
* <p> For example, an AT+XEVENT=foo,3 will get translated into
* EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD = +XEVENT
* EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD_TYPE = AT_CMD_TYPE_SET
* EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_ARGS = foo, 3
*
* <p>Requires {@link android.Manifest.permission#BLUETOOTH} to receive.
* @hide
*/
@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
public static final String ACTION_VENDOR_SPECIFIC_HEADSET_EVENT =
@@ -100,31 +123,68 @@ public final class BluetoothHeadset implements BluetoothProfile {
/**
* A String extra field in {@link #ACTION_VENDOR_SPECIFIC_HEADSET_EVENT}
* intents that contains the name of the vendor-specific command.
* @hide
*/
public static final String EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD =
"android.bluetooth.headset.extra.VENDOR_SPECIFIC_HEADSET_EVENT_CMD";
/**
* An int extra field in {@link #ACTION_VENDOR_SPECIFIC_HEADSET_EVENT}
* intents that contains the Company ID of the vendor defining the vendor-specific
* command.
* @see <a href="https://www.bluetooth.org/Technical/AssignedNumbers/identifiers.htm">
* Bluetooth SIG Assigned Numbers - Company Identifiers</a>
* @hide
* intents that contains the AT command type of the vendor-specific command.
*/
public static final String EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_COMPANY_ID =
"android.bluetooth.headset.extra.VENDOR_SPECIFIC_HEADSET_EVENT_COMPANY_ID";
public static final String EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD_TYPE =
"android.bluetooth.headset.extra.VENDOR_SPECIFIC_HEADSET_EVENT_CMD_TYPE";
/**
* AT command type READ used with
* {@link #EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD_TYPE}
* For example, AT+VGM?. There are no arguments for this command type.
*/
public static final int AT_CMD_TYPE_READ = 0;
/**
* AT command type TEST used with
* {@link #EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD_TYPE}
* For example, AT+VGM=?. There are no arguments for this command type.
*/
public static final int AT_CMD_TYPE_TEST = 1;
/**
* AT command type SET used with
* {@link #EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD_TYPE}
* For example, AT+VGM=<args>.
*/
public static final int AT_CMD_TYPE_SET = 2;
/**
* AT command type BASIC used with
* {@link #EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD_TYPE}
* For example, ATD. Single character commands and everything following the
* character are arguments.
*/
public static final int AT_CMD_TYPE_BASIC = 3;
/**
* AT command type ACTION used with
* {@link #EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD_TYPE}
* For example, AT+CHUP. There are no arguments for action commands.
*/
public static final int AT_CMD_TYPE_ACTION = 4;
/**
* A Parcelable String array extra field in
* {@link #ACTION_VENDOR_SPECIFIC_HEADSET_EVENT} intents that contains
* the arguments to the vendor-specific command.
* @hide
*/
public static final String EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_ARGS =
"android.bluetooth.headset.extra.VENDOR_SPECIFIC_HEADSET_EVENT_ARGS";
/**
* The intent category to be used with {@link #ACTION_VENDOR_SPECIFIC_HEADSET_EVENT}
* for the companyId
*/
public static final String VENDOR_SPECIFIC_HEADSET_EVENT_COMPANY_ID_CATEGORY =
"android.bluetooth.headset.intent.category.companyid";
/*
* Headset state when SCO audio is connected
* This state can be one of