1 /*
2  * Copyright 2008 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 package android.bluetooth;
18 
19 import android.bluetooth.BluetoothDevice;
20 
21 /**
22  * API for Bluetooth Headset service
23  *
24  * Note before adding anything new:
25  *   Internal interactions within com.android.bluetooth should be handled through
26  *   HeadsetService directly instead of going through binder
27  *
28  * {@hide}
29  */
30 interface IBluetoothHeadset {
31     // Public API
32     @UnsupportedAppUsage
getConnectedDevices()33     List<BluetoothDevice> getConnectedDevices();
getDevicesMatchingConnectionStates(in int[] states)34     List<BluetoothDevice> getDevicesMatchingConnectionStates(in int[] states);
35     @UnsupportedAppUsage
getConnectionState(in BluetoothDevice device)36     int getConnectionState(in BluetoothDevice device);
startVoiceRecognition(in BluetoothDevice device)37     boolean startVoiceRecognition(in BluetoothDevice device);
stopVoiceRecognition(in BluetoothDevice device)38     boolean stopVoiceRecognition(in BluetoothDevice device);
isAudioConnected(in BluetoothDevice device)39     boolean isAudioConnected(in BluetoothDevice device);
sendVendorSpecificResultCode(in BluetoothDevice device, in String command, in String arg)40     boolean sendVendorSpecificResultCode(in BluetoothDevice device,
41                                          in String command,
42                                          in String arg);
43 
44     // Hidden API
45     @UnsupportedAppUsage
connect(in BluetoothDevice device)46     boolean connect(in BluetoothDevice device);
47     @UnsupportedAppUsage
disconnect(in BluetoothDevice device)48     boolean disconnect(in BluetoothDevice device);
setConnectionPolicy(in BluetoothDevice device, int connectionPolicy)49     boolean setConnectionPolicy(in BluetoothDevice device, int connectionPolicy);
getConnectionPolicy(in BluetoothDevice device)50     int getConnectionPolicy(in BluetoothDevice device);
getAudioState(in BluetoothDevice device)51     int getAudioState(in BluetoothDevice device);
isAudioOn()52     boolean isAudioOn();
connectAudio()53     boolean connectAudio();
disconnectAudio()54     boolean disconnectAudio();
setAudioRouteAllowed(boolean allowed)55     void setAudioRouteAllowed(boolean allowed);
getAudioRouteAllowed()56     boolean getAudioRouteAllowed();
setForceScoAudio(boolean forced)57     void setForceScoAudio(boolean forced);
startScoUsingVirtualVoiceCall()58     boolean startScoUsingVirtualVoiceCall();
stopScoUsingVirtualVoiceCall()59     boolean stopScoUsingVirtualVoiceCall();
phoneStateChanged(int numActive, int numHeld, int callState, String number, int type, String name)60     oneway void phoneStateChanged(int numActive, int numHeld, int callState, String number, int type, String name);
clccResponse(int index, int direction, int status, int mode, boolean mpty, String number, int type)61     void clccResponse(int index, int direction, int status, int mode, boolean mpty,
62                       String number, int type);
setActiveDevice(in BluetoothDevice device)63     boolean setActiveDevice(in BluetoothDevice device);
getActiveDevice()64     BluetoothDevice getActiveDevice();
isInbandRingingEnabled()65     boolean isInbandRingingEnabled();
setPriority(in BluetoothDevice device, int connectionPolicy)66     boolean setPriority(in BluetoothDevice device, int connectionPolicy);
getPriority(in BluetoothDevice device)67     int getPriority(in BluetoothDevice device);
68 }
69