Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 62c37efc authored by Jaikumar Ganesh's avatar Jaikumar Ganesh
Browse files

New public APIs for BluetoothA2dp and BluetoothHeadset profiles. 

Change-Id: I1cc4b109542dfd62473cb95797c8c3d0d15725f4
parent d362391b

api/current.xml

+514 −0
Original line number Diff line number Diff line
@@ -38675,6 +38675,111 @@ 
</package>

<package name="android.bluetooth"

>

<class name="BluetoothA2dp"

 extends="java.lang.Object"

 abstract="false"

 static="false"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

<implements name="android.bluetooth.BluetoothProfile">

</implements>

<method name="getConnectedDevices"

 return="java.util.Set&lt;android.bluetooth.BluetoothDevice&gt;"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

</method>

<method name="getConnectionState"

 return="int"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<parameter name="device" type="android.bluetooth.BluetoothDevice">

</parameter>

</method>

<method name="getDevicesMatchingConnectionStates"

 return="java.util.Set&lt;android.bluetooth.BluetoothDevice&gt;"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<parameter name="states" type="int[]">

</parameter>

</method>

<method name="isA2dpPlaying"

 return="boolean"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<parameter name="device" type="android.bluetooth.BluetoothDevice">

</parameter>

</method>

<field name="ACTION_CONNECTION_STATE_CHANGED"

 type="java.lang.String"

 transient="false"

 volatile="false"

 value="&quot;android.bluetooth.a2dp.profile.action.CONNECTION_STATE_CHANGED&quot;"

 static="true"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

</field>

<field name="ACTION_PLAYING_STATE_CHANGED"

 type="java.lang.String"

 transient="false"

 volatile="false"

 value="&quot;android.bluetooth.a2dp.profile.action.PLAYING_STATE_CHANGED&quot;"

 static="true"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

</field>

<field name="STATE_NOT_PLAYING"

 type="int"

 transient="false"

 volatile="false"

 value="11"

 static="true"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

</field>

<field name="STATE_PLAYING"

 type="int"

 transient="false"

 volatile="false"

 value="10"

 static="true"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

</field>

</class>

<class name="BluetoothAdapter"

 extends="java.lang.Object"

 abstract="false"
@@ -38707,6 +38812,21 @@ 
<parameter name="address" type="java.lang.String">

</parameter>

</method>

<method name="closeProfileProxy"

 return="void"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<parameter name="profile" type="int">

</parameter>

<parameter name="proxy" type="android.bluetooth.BluetoothProfile">

</parameter>

</method>

<method name="disable"

 return="boolean"

 abstract="false"
@@ -38773,6 +38893,23 @@ 
 visibility="public"

>

</method>

<method name="getProfileProxy"

 return="boolean"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<parameter name="context" type="android.content.Context">

</parameter>

<parameter name="listener" type="android.bluetooth.BluetoothProfile.ServiceListener">

</parameter>

<parameter name="profile" type="int">

</parameter>

</method>

<method name="getRemoteDevice"

 return="android.bluetooth.BluetoothDevice"

 abstract="false"
@@ -38871,6 +39008,17 @@ 
 visibility="public"

>

</method>

<field name="ACTION_CONNECTION_STATE_CHANGED"

 type="java.lang.String"

 transient="false"

 volatile="false"

 value="&quot;android.bluetooth.adapter.action.CONNECTION_STATE_CHANGED&quot;"

 static="true"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

</field>

<field name="ACTION_DISCOVERY_FINISHED"

 type="java.lang.String"

 transient="false"
@@ -38959,6 +39107,17 @@ 
 visibility="public"

>

</field>

<field name="EXTRA_CONNECTION_STATE"

 type="java.lang.String"

 transient="false"

 volatile="false"

 value="&quot;android.bluetooth.adapter.extra.CONNECTION_STATE&quot;"

 static="true"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

</field>

<field name="EXTRA_DISCOVERABLE_DURATION"

 type="java.lang.String"

 transient="false"
@@ -38981,6 +39140,17 @@ 
 visibility="public"

>

</field>

<field name="EXTRA_PREVIOUS_CONNECTION_STATE"

 type="java.lang.String"

 transient="false"

 volatile="false"

 value="&quot;android.bluetooth.adapter.extra.PREVIOUS_CONNECTION_STATE&quot;"

 static="true"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

</field>

<field name="EXTRA_PREVIOUS_SCAN_MODE"

 type="java.lang.String"

 transient="false"
@@ -39058,6 +39228,50 @@ 
 visibility="public"

>

</field>

<field name="STATE_CONNECTED"

 type="int"

 transient="false"

 volatile="false"

 value="2"

 static="true"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

</field>

<field name="STATE_CONNECTING"

 type="int"

 transient="false"

 volatile="false"

 value="1"

 static="true"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

</field>

<field name="STATE_DISCONNECTED"

 type="int"

 transient="false"

 volatile="false"

 value="0"

 static="true"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

</field>

<field name="STATE_DISCONNECTING"

 type="int"

 transient="false"

 volatile="false"

 value="3"

 static="true"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

</field>

<field name="STATE_OFF"

 type="int"

 transient="false"
@@ -40299,6 +40513,306 @@ 
>

</field>

</class>

<class name="BluetoothHeadset"

 extends="java.lang.Object"

 abstract="false"

 static="false"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

<implements name="android.bluetooth.BluetoothProfile">

</implements>

<method name="getConnectedDevices"

 return="java.util.Set&lt;android.bluetooth.BluetoothDevice&gt;"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

</method>

<method name="getConnectionState"

 return="int"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<parameter name="device" type="android.bluetooth.BluetoothDevice">

</parameter>

</method>

<method name="getDevicesMatchingConnectionStates"

 return="java.util.Set&lt;android.bluetooth.BluetoothDevice&gt;"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<parameter name="states" type="int[]">

</parameter>

</method>

<method name="isAudioConnected"

 return="boolean"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<parameter name="device" type="android.bluetooth.BluetoothDevice">

</parameter>

</method>

<method name="startVoiceRecognition"

 return="boolean"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<parameter name="device" type="android.bluetooth.BluetoothDevice">

</parameter>

</method>

<method name="stopVoiceRecognition"

 return="boolean"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<parameter name="device" type="android.bluetooth.BluetoothDevice">

</parameter>

</method>

<field name="ACTION_AUDIO_STATE_CHANGED"

 type="java.lang.String"

 transient="false"

 volatile="false"

 value="&quot;android.bluetooth.headset.profile.action.AUDIO_STATE_CHANGED&quot;"

 static="true"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

</field>

<field name="ACTION_CONNECTION_STATE_CHANGED"

 type="java.lang.String"

 transient="false"

 volatile="false"

 value="&quot;android.bluetooth.headset.profile.action.CONNECTION_STATE_CHANGED&quot;"

 static="true"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

</field>

<field name="STATE_AUDIO_CONNECTED"

 type="int"

 transient="false"

 volatile="false"

 value="10"

 static="true"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

</field>

<field name="STATE_AUDIO_DISCONNECTED"

 type="int"

 transient="false"

 volatile="false"

 value="11"

 static="true"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

</field>

</class>

<interface name="BluetoothProfile"

 abstract="true"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<method name="getConnectedDevices"

 return="java.util.Set&lt;android.bluetooth.BluetoothDevice&gt;"

 abstract="true"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

</method>

<method name="getConnectionState"

 return="int"

 abstract="true"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<parameter name="device" type="android.bluetooth.BluetoothDevice">

</parameter>

</method>

<method name="getDevicesMatchingConnectionStates"

 return="java.util.Set&lt;android.bluetooth.BluetoothDevice&gt;"

 abstract="true"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<parameter name="states" type="int[]">

</parameter>

</method>

<field name="A2DP"

 type="int"

 transient="false"

 volatile="false"

 value="2"

 static="true"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

</field>

<field name="EXTRA_PREVIOUS_STATE"

 type="java.lang.String"

 transient="false"

 volatile="false"

 value="&quot;android.bluetooth.profile.extra.PREVIOUS_STATE&quot;"

 static="true"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

</field>

<field name="EXTRA_STATE"

 type="java.lang.String"

 transient="false"

 volatile="false"

 value="&quot;android.bluetooth.profile.extra.STATE&quot;"

 static="true"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

</field>

<field name="HEADSET"

 type="int"

 transient="false"

 volatile="false"

 value="1"

 static="true"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

</field>

<field name="STATE_CONNECTED"

 type="int"

 transient="false"

 volatile="false"

 value="2"

 static="true"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

</field>

<field name="STATE_CONNECTING"

 type="int"

 transient="false"

 volatile="false"

 value="1"

 static="true"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

</field>

<field name="STATE_DISCONNECTED"

 type="int"

 transient="false"

 volatile="false"

 value="0"

 static="true"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

</field>

<field name="STATE_DISCONNECTING"

 type="int"

 transient="false"

 volatile="false"

 value="3"

 static="true"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

</field>

</interface>

<interface name="BluetoothProfile.ServiceListener"

 abstract="true"

 static="true"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<method name="onServiceConnected"

 return="void"

 abstract="true"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<parameter name="profile" type="int">

</parameter>

<parameter name="proxy" type="android.bluetooth.BluetoothProfile">

</parameter>

</method>

<method name="onServiceDisconnected"

 return="void"

 abstract="true"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<parameter name="profile" type="int">

</parameter>

</method>

</interface>

<class name="BluetoothServerSocket"

 extends="java.lang.Object"

 abstract="false"

core/java/android/bluetooth/BluetoothA2dp.java

+263 −173

File changed.

Preview size limit exceeded, changes collapsed.

core/java/android/bluetooth/BluetoothAdapter.java

+104 −0
Original line number Diff line number Diff line
@@ -18,6 +18,7 @@ package android.bluetooth; 


import android.annotation.SdkConstant;

import android.annotation.SdkConstant.SdkConstantType;

import android.content.Context;

import android.os.Binder;

import android.os.Handler;

import android.os.IBinder;
@@ -279,6 +280,61 @@ public final class BluetoothAdapter { 
     */

    public static final String EXTRA_LOCAL_NAME = "android.bluetooth.adapter.extra.LOCAL_NAME";



    /**

     * Intent used to broadcast the change in connection state of the local

     * Bluetooth adapter to a profile of the remote device. When the adapter is

     * not connected to any profiles of any remote devices and it attempts a

     * connection to a profile this intent will sent. Once connected, this intent

     * will not be sent for any more connection attempts to any profiles of any

     * remote device. When the adapter disconnects from the last profile its

     * connected to of any remote device, this intent will be sent.

     *

     * <p> This intent is useful for applications that are only concerned about

     * whether the local adapter is connected to any profile of any device and

     * are not really concerned about which profile. For example, an application

     * which displays an icon to display whether Bluetooth is connected or not

     * can use this intent.

     *

     * <p>This intent will have 3 extras:

     * {@link #EXTRA_STATE} - The current state.

     * {@link #EXTRA_PREVIOUS_STATE}- The previous.

     * {@link BluetoothDevice#EXTRA_DEVICE} - The remote device.

     *

     * {@link #EXTRA_STATE} or {@link #EXTRA_PREVIOUS_STATE} can be any of

     * {@link #STATE_DISCONNECTED}, {@link #STATE_CONNECTING},

     * {@link #STATE_CONNECTED}, {@link #STATE_DISCONNECTING}.

     *

     * <p>Requires {@link android.Manifest.permission#BLUETOOTH} to receive.

     */

    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)

    public static final String ACTION_CONNECTION_STATE_CHANGED =

        "android.bluetooth.adapter.action.CONNECTION_STATE_CHANGED";



    /**

     * Extra used by {@link #ACTION_CONNECTION_STATE_CHANGED}

     *

     * This extra represents the current connection state.

     */

    public static final String EXTRA_CONNECTION_STATE =

        "android.bluetooth.adapter.extra.CONNECTION_STATE";



    /**

     * Extra used by {@link #ACTION_CONNECTION_STATE_CHANGED}

     *

     * This extra represents the previous connection state.

     */

    public static final String EXTRA_PREVIOUS_CONNECTION_STATE =

          "android.bluetooth.adapter.extra.PREVIOUS_CONNECTION_STATE";



    /** The profile is in disconnected state */

    public static final int STATE_DISCONNECTED  = 0;

    /** The profile is in connecting state */

    public static final int STATE_CONNECTING    = 1;

    /** The profile is in connected state */

    public static final int STATE_CONNECTED     = 2;

    /** The profile is in disconnecting state */

    public static final int STATE_DISCONNECTING = 3;



    /** @hide */

    public static final String BLUETOOTH_SERVICE = "bluetooth";
@@ -896,6 +952,54 @@ public final class BluetoothAdapter { 
        return null;

    }



    /*

     * Get the profile proxy object associated with the profile.

     *

     * <p>Profile can be one of {@link BluetoothProfile.HEADSET} or

     * {@link BluetoothProfile.A2DP}. Clients must implements

     * {@link BluetoothProfile.ServiceListener} to get notified of

     * the connection status and to get the proxy object.

     *

     * @param context Context of the application

     * @param listener The service Listener for connection callbacks.

     * @param profile

     * @return true on success, false on error

     */

    public boolean getProfileProxy(Context context, BluetoothProfile.ServiceListener listener,

                                   int profile) {

        if (context == null || listener == null) return false;



        if (profile == BluetoothProfile.HEADSET) {

            BluetoothHeadset headset = new BluetoothHeadset(context, listener);

            return true;

        } else if (profile == BluetoothProfile.A2DP) {

            BluetoothA2dp a2dp = new BluetoothA2dp(context, listener);

            return true;

        } else {

            return false;

        }

    }



    /**

     * Close the connection of the profile proxy to the Service.

     *

     * <p> Clients should call this when they are no longer using

     * the proxy obtained from {@link #getProfileProxy}.

     * Profile can be one of {@link BluetoothProfile#HEADSET} or

     * {@link BluetoothProfile#A2DP}

     *

     * @param profile

     * @param proxy Profile proxy object

     */

    public void closeProfileProxy(int profile, BluetoothProfile proxy) {

        if (profile == BluetoothProfile.HEADSET) {

            BluetoothHeadset headset = (BluetoothHeadset)proxy;

            if (headset != null) {

                headset.close();

            }

        }

    }



    private Set<BluetoothDevice> toDeviceSet(String[] addresses) {

        Set<BluetoothDevice> devices = new HashSet<BluetoothDevice>(addresses.length);

        for (int i = 0; i < addresses.length; i++) {

core/java/android/bluetooth/BluetoothHeadset.java

+285 −260

File changed.

Preview size limit exceeded, changes collapsed.

core/java/android/bluetooth/BluetoothProfile.java

0 → 100644
+239 −0
Original line number Diff line number Diff line 
/*

 * Copyright (C) 2010 The Android Open Source Project

 *

 * Licensed under the Apache License, Version 2.0 (the "License");

 * you may not use this file except in compliance with the License.

 * You may obtain a copy of the License at

 *

 *      http://www.apache.org/licenses/LICENSE-2.0

 *

 * Unless required by applicable law or agreed to in writing, software

 * distributed under the License is distributed on an "AS IS" BASIS,

 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

 * See the License for the specific language governing permissions and

 * limitations under the License.

 */





package android.bluetooth;



import android.annotation.SdkConstant;

import android.annotation.SdkConstant.SdkConstantType;



import java.util.Set;



/**

 * Public APIs for the Bluetooth Profiles.

 *

 * <p> Clients should call {@link BluetoothAdapter#getProfileProxy},

 * to get the Profile Proxy. Each public profile implements this

 * interface.

 */

public interface BluetoothProfile {



    /**

     * Extra for the connection state intents of the individual profiles.

     *

     * This extra represents the current connection state of the profile of the

     * Bluetooth device.

     */

    public static final String EXTRA_STATE = "android.bluetooth.profile.extra.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.

     */

    public static final String EXTRA_PREVIOUS_STATE =

        "android.bluetooth.profile.extra.PREVIOUS_STATE";



    /** The profile is in disconnected state */

    public static final int STATE_DISCONNECTED  = 0;

    /** The profile is in connecting state */

    public static final int STATE_CONNECTING    = 1;

    /** The profile is in connected state */

    public static final int STATE_CONNECTED     = 2;

    /** The profile is in disconnecting state */

    public static final int STATE_DISCONNECTING = 3;



    /**

     * Headset and Handsfree profile

     */

    public static final int HEADSET = 1;

    /**

     * A2DP profile.

     */

    public static final int A2DP = 2;



    /**

     * Default priority for devices that we try to auto-connect to and

     * and allow incoming connections for the profile

     * @hide

     **/

    public static final int PRIORITY_AUTO_CONNECT = 1000;



    /**

     *  Default priority for devices that allow incoming

     * and outgoing connections for the profile

     * @hide

     **/

    public static final int PRIORITY_ON = 100;



    /**

     * Default priority for devices that does not allow incoming

     * connections and outgoing connections for the profile.

     * @hide

     **/

    public static final int PRIORITY_OFF = 0;



    /**

     * Default priority when not set or when the device is unpaired

     * @hide

     * */

    public static final int PRIORITY_UNDEFINED = -1;



    /**

     * Initiate connection to a profile of the remote bluetooth device.

     *

     * <p> Currently, the system supports only 1 connection to the

     * A2DP and Headset/Handsfree profile. The API will automatically

     * disconnect connected devices before connecting.

     *

     * <p> This API returns false in scenarios like the profile on the

     * device is already connected or Bluetooth is not turned on.

     * When this API returns true, it is guaranteed that

     * connection state intent for the profile will be broadcasted with

     * the state. Users can get the connection state of the profile

     * from this intent.

     *

     * <p>Requires {@link android.Manifest.permission#BLUETOOTH_ADMIN}

     *

     * @param device Remote Bluetooth Device

     * @return false on immediate error,

     *               true otherwise

     * @hide

     */

    public boolean connect(BluetoothDevice device);



    /**

     * Initiate disconnection from a profile

     *

     * <p> This API will return false in scenarios like the profile on the

     * Bluetooth device is not in connected state etc. When this API returns,

     * true, it is guaranteed that the connection state change

     * intent will be broadcasted with the state. Users can get the

     * disconnection state of the profile from this intent.

     *

     * <p> If the disconnection is initiated by a remote device, the state

     * will transition from {@link #STATE_CONNECTED} to

     * {@link #STATE_DISCONNECTED}. If the disconnect is initiated by the

     * host (local) device the state will transition from

     * {@link #STATE_CONNECTED} to state {@link #STATE_DISCONNECTING} to

     * state {@link #STATE_DISCONNECTED}. The transition to

     * {@link #STATE_DISCONNECTING} can be used to distinguish between the

     * two scenarios.

     *

     * <p>Requires {@link android.Manifest.permission#BLUETOOTH_ADMIN}

     *

     * @param device Remote Bluetooth Device

     * @return false on immediate error,

     *               true otherwise

     * @hide

     */

    public boolean disconnect(BluetoothDevice device);



    /**

     * Get connected devices for this specific profile.

     *

     * <p> Return the set of devices which are in state {@link #STATE_CONNECTED}

     *

     * <p>Requires {@link android.Manifest.permission#BLUETOOTH}

     *

     * @return An unmodifiable set of devices. The set will be empty on error.

     */

    public Set<BluetoothDevice> getConnectedDevices();



    /**

     * Get a set of devices that match any of the given connection

     * states.

     *

     * <p> If none of devices match any of the given states,

     * an empty set will be returned.

     *

     * <p>Requires {@link android.Manifest.permission#BLUETOOTH}

     *

     * @param states Array of states. States can be one of

     *              {@link #STATE_CONNECTED}, {@link #STATE_CONNECTING},

     *              {@link #STATE_DISCONNECTED}, {@link #STATE_DISCONNECTING},

     * @return An unmodifiable set of devices. The set will be empty on error.

     */

    public Set<BluetoothDevice> getDevicesMatchingConnectionStates(int[] states);



    /**

     * Get the current connection state of the profile

     *

     * <p>Requires {@link android.Manifest.permission#BLUETOOTH}

     *

     * @param device Remote bluetooth device.

     * @return State of the profile connection. One of

     *               {@link #STATE_CONNECTED}, {@link #STATE_CONNECTING},

     *               {@link #STATE_DISCONNECTED}, {@link #STATE_DISCONNECTING}

     */

    public int getConnectionState(BluetoothDevice device);



    /**

     * Set priority of the profile

     *

     * <p> The device should already be paired.

     *  Priority can be one of {@link #PRIORITY_ON} or

     * {@link #PRIORITY_OFF},

     *

     * <p>Requires {@link android.Manifest.permission#BLUETOOTH_ADMIN}

     *

     * @param device Paired bluetooth device

     * @param priority

     * @return true if priority is set, false on error

     * @hide

     */

    public boolean setPriority(BluetoothDevice device, int priority);



    /**

     * Get the priority of the profile.

     *

     * <p> The priority can be any of:

     * {@link #PRIORITY_AUTO_CONNECT}, {@link #PRIORITY_OFF},

     * {@link #PRIORITY_ON}, {@link #PRIORITY_UNDEFINED}

     *

     * <p>Requires {@link android.Manifest.permission#BLUETOOTH}

     *

     * @param device Bluetooth device

     * @return priority of the device

     * @hide

     */

    public int getPriority(BluetoothDevice device);



    /**

     * An interface for notifying BluetoothProfile IPC clients when they have

     * been connected or disconnected to the service.

     */

    public interface ServiceListener {

        /**

         * Called to notify the client when the proxy object has been

         * connected to the service.

         * @param profile - One of {@link #HEADSET} or

         *                  {@link #A2DP}

         * @param proxy - One of {@link BluetoothHeadset} or

         *                {@link BluetoothA2dp}

         */

        public void onServiceConnected(int profile, BluetoothProfile proxy);



        /**

         * Called to notify the client that this proxy object has been

         * disconnected from the service.

         * @param profile - One of {@link #HEADSET} or

         *                  {@link #A2DP}

         */

        public void onServiceDisconnected(int profile);

    }

}