am e4eb23ec: am 84e594f7: Merge "Unhide Bluetooth Low Energy public APIs" into jb-mr2-dev (3f956026) · Commits · e / os / android_frameworks_base

api/current.txt

+178 −0

Original line number	Diff line number	Diff line
		@@ -4614,8 +4614,13 @@ package android.bluetooth {
		method public boolean isEnabled();
		method public android.bluetooth.BluetoothServerSocket listenUsingInsecureRfcommWithServiceRecord(java.lang.String, java.util.UUID) throws java.io.IOException;
		method public android.bluetooth.BluetoothServerSocket listenUsingRfcommWithServiceRecord(java.lang.String, java.util.UUID) throws java.io.IOException;
		method public boolean registerCallback(android.bluetooth.BluetoothAdapterCallback);
		method public boolean setName(java.lang.String);
		method public boolean startDiscovery();
		method public boolean startLeScan();
		method public boolean startLeScan(java.util.UUID[]);
		method public void stopLeScan();
		method public boolean unRegisterCallback(android.bluetooth.BluetoothAdapterCallback);
		field public static final java.lang.String ACTION_CONNECTION_STATE_CHANGED = "android.bluetooth.adapter.action.CONNECTION_STATE_CHANGED";
		field public static final java.lang.String ACTION_DISCOVERY_FINISHED = "android.bluetooth.adapter.action.DISCOVERY_FINISHED";
		field public static final java.lang.String ACTION_DISCOVERY_STARTED = "android.bluetooth.adapter.action.DISCOVERY_STARTED";
		@@ -4646,6 +4651,14 @@ package android.bluetooth {
		field public static final int STATE_TURNING_ON = 11; // 0xb
		}

		public abstract class BluetoothAdapterCallback {
		ctor public BluetoothAdapterCallback();
		method public void onCallbackRegistration(int);
		method public void onLeScan(android.bluetooth.BluetoothDevice, int, byte[]);
		field public static final int CALLBACK_REGISTERED = 0; // 0x0
		field public static final int CALLBACK_REGISTRATION_FAILURE = 1; // 0x1
		}

		public class BluetoothAssignedNumbers {
		field public static final int ACCEL_SEMICONDUCTOR = 74; // 0x4a
		field public static final int ALCATEL = 36; // 0x24
		@@ -4838,6 +4851,7 @@ package android.bluetooth {
		}

		public final class BluetoothDevice implements android.os.Parcelable {
		method public android.bluetooth.BluetoothGatt connectGattServer(android.content.Context, boolean, android.bluetooth.BluetoothGattCallback);
		method public android.bluetooth.BluetoothSocket createInsecureRfcommSocketToServiceRecord(java.util.UUID) throws java.io.IOException;
		method public android.bluetooth.BluetoothSocket createRfcommSocketToServiceRecord(java.util.UUID) throws java.io.IOException;
		method public int describeContents();
		@@ -4870,6 +4884,159 @@ package android.bluetooth {
		field public static final java.lang.String EXTRA_UUID = "android.bluetooth.device.extra.UUID";
		}

		public final class BluetoothGatt implements android.bluetooth.BluetoothProfile {
		method public void abortReliableWrite(android.bluetooth.BluetoothDevice);
		method public boolean beginReliableWrite();
		method public void disconnect();
		method public boolean discoverServices();
		method public boolean executeReliableWrite();
		method public java.util.List<android.bluetooth.BluetoothDevice> getConnectedDevices();
		method public int getConnectionState(android.bluetooth.BluetoothDevice);
		method public java.util.List<android.bluetooth.BluetoothDevice> getDevicesMatchingConnectionStates(int[]);
		method public android.bluetooth.BluetoothGattService getService(java.util.UUID);
		method public java.util.List<android.bluetooth.BluetoothGattService> getServices();
		method public boolean readCharacteristic(android.bluetooth.BluetoothGattCharacteristic);
		method public boolean readDescriptor(android.bluetooth.BluetoothGattDescriptor);
		method public boolean readRemoteRssi();
		method public boolean setCharacteristicNotification(android.bluetooth.BluetoothGattCharacteristic, boolean);
		method public boolean writeCharacteristic(android.bluetooth.BluetoothGattCharacteristic);
		method public boolean writeDescriptor(android.bluetooth.BluetoothGattDescriptor);
		field public static final int GATT_FAILURE = 0; // 0x0
		field public static final int GATT_INSUFFICIENT_AUTHENTICATION = 5; // 0x5
		field public static final int GATT_INSUFFICIENT_ENCRYPTION = 15; // 0xf
		field public static final int GATT_INVALID_ATTRIBUTE_LENGTH = 13; // 0xd
		field public static final int GATT_INVALID_OFFSET = 7; // 0x7
		field public static final int GATT_READ_NOT_PERMITTED = 2; // 0x2
		field public static final int GATT_REQUEST_NOT_SUPPORTED = 6; // 0x6
		field public static final int GATT_SUCCESS = 0; // 0x0
		field public static final int GATT_WRITE_NOT_PERMITTED = 3; // 0x3
		}

		public abstract class BluetoothGattCallback {
		ctor public BluetoothGattCallback();
		method public void onCharacteristicChanged(android.bluetooth.BluetoothGattCharacteristic);
		method public void onCharacteristicRead(android.bluetooth.BluetoothGattCharacteristic, int);
		method public void onCharacteristicWrite(android.bluetooth.BluetoothGattCharacteristic, int);
		method public void onConnectionStateChange(android.bluetooth.BluetoothDevice, int, int);
		method public void onDescriptorRead(android.bluetooth.BluetoothGattDescriptor, int);
		method public void onDescriptorWrite(android.bluetooth.BluetoothGattDescriptor, int);
		method public void onReadRemoteRssi(android.bluetooth.BluetoothDevice, int, int);
		method public void onReliableWriteCompleted(android.bluetooth.BluetoothDevice, int);
		method public void onServicesDiscovered(android.bluetooth.BluetoothDevice, int);
		}

		public class BluetoothGattCharacteristic {
		ctor public BluetoothGattCharacteristic(java.util.UUID, int, int);
		method public boolean addDescriptor(android.bluetooth.BluetoothGattDescriptor);
		method public android.bluetooth.BluetoothGattDescriptor getDescriptor(java.util.UUID);
		method public java.util.List<android.bluetooth.BluetoothGattDescriptor> getDescriptors();
		method public java.lang.Float getFloatValue(int, int);
		method public int getInstanceId();
		method public java.lang.Integer getIntValue(int, int);
		method public int getPermissions();
		method public int getProperties();
		method public android.bluetooth.BluetoothGattService getService();
		method public java.lang.String getStringValue(int);
		method public java.util.UUID getUuid();
		method public byte[] getValue();
		method public int getWriteType();
		method public boolean setValue(byte[]);
		method public boolean setValue(int, int, int);
		method public boolean setValue(int, int, int, int);
		method public boolean setValue(java.lang.String);
		method public void setWriteType(int);
		field public static final int FORMAT_FLOAT = 52; // 0x34
		field public static final int FORMAT_SFLOAT = 50; // 0x32
		field public static final int FORMAT_SINT16 = 34; // 0x22
		field public static final int FORMAT_SINT32 = 36; // 0x24
		field public static final int FORMAT_SINT8 = 33; // 0x21
		field public static final int FORMAT_UINT16 = 18; // 0x12
		field public static final int FORMAT_UINT32 = 20; // 0x14
		field public static final int FORMAT_UINT8 = 17; // 0x11
		field public static final int PERMISSION_READ = 1; // 0x1
		field public static final int PERMISSION_READ_ENCRYPTED = 2; // 0x2
		field public static final int PERMISSION_READ_ENCRYPTED_MITM = 4; // 0x4
		field public static final int PERMISSION_WRITE = 16; // 0x10
		field public static final int PERMISSION_WRITE_ENCRYPTED = 32; // 0x20
		field public static final int PERMISSION_WRITE_ENCRYPTED_MITM = 64; // 0x40
		field public static final int PERMISSION_WRITE_SIGNED = 128; // 0x80
		field public static final int PERMISSION_WRITE_SIGNED_MITM = 256; // 0x100
		field public static final int PROPERTY_BROADCAST = 1; // 0x1
		field public static final int PROPERTY_EXTENDED_PROPS = 128; // 0x80
		field public static final int PROPERTY_INDICATE = 32; // 0x20
		field public static final int PROPERTY_NOTIFY = 16; // 0x10
		field public static final int PROPERTY_READ = 2; // 0x2
		field public static final int PROPERTY_SIGNED_WRITE = 64; // 0x40
		field public static final int PROPERTY_WRITE = 8; // 0x8
		field public static final int PROPERTY_WRITE_NO_RESPONSE = 4; // 0x4
		field public static final int WRITE_TYPE_DEFAULT = 2; // 0x2
		field public static final int WRITE_TYPE_NO_RESPONSE = 1; // 0x1
		field public static final int WRITE_TYPE_SIGNED = 4; // 0x4
		field protected java.util.List mDescriptors;
		}

		public class BluetoothGattDescriptor {
		ctor public BluetoothGattDescriptor(java.util.UUID, int);
		method public android.bluetooth.BluetoothGattCharacteristic getCharacteristic();
		method public int getPermissions();
		method public java.util.UUID getUuid();
		method public byte[] getValue();
		method public boolean setValue(byte[]);
		field public static final byte[] DISABLE_NOTIFICATION_VALUE;
		field public static final byte[] ENABLE_INDICATION_VALUE;
		field public static final byte[] ENABLE_NOTIFICATION_VALUE;
		field public static final int PERMISSION_READ = 1; // 0x1
		field public static final int PERMISSION_READ_ENCRYPTED = 2; // 0x2
		field public static final int PERMISSION_READ_ENCRYPTED_MITM = 4; // 0x4
		field public static final int PERMISSION_WRITE = 16; // 0x10
		field public static final int PERMISSION_WRITE_ENCRYPTED = 32; // 0x20
		field public static final int PERMISSION_WRITE_ENCRYPTED_MITM = 64; // 0x40
		field public static final int PERMISSION_WRITE_SIGNED = 128; // 0x80
		field public static final int PERMISSION_WRITE_SIGNED_MITM = 256; // 0x100
		}

		public final class BluetoothGattServer implements android.bluetooth.BluetoothProfile {
		method public boolean addService(android.bluetooth.BluetoothGattService);
		method public void cancelConnection(android.bluetooth.BluetoothDevice);
		method public void clearServices();
		method public boolean connect(android.bluetooth.BluetoothDevice, boolean);
		method public java.util.List<android.bluetooth.BluetoothDevice> getConnectedDevices();
		method public int getConnectionState(android.bluetooth.BluetoothDevice);
		method public java.util.List<android.bluetooth.BluetoothDevice> getDevicesMatchingConnectionStates(int[]);
		method public android.bluetooth.BluetoothGattService getService(java.util.UUID);
		method public java.util.List<android.bluetooth.BluetoothGattService> getServices();
		method public boolean notifyCharacteristicChanged(android.bluetooth.BluetoothDevice, android.bluetooth.BluetoothGattCharacteristic, boolean);
		method public boolean removeService(android.bluetooth.BluetoothGattService);
		method public boolean sendResponse(android.bluetooth.BluetoothDevice, int, int, int, byte[]);
		}

		public abstract class BluetoothGattServerCallback {
		ctor public BluetoothGattServerCallback();
		method public void onCharacteristicReadRequest(android.bluetooth.BluetoothDevice, int, int, android.bluetooth.BluetoothGattCharacteristic);
		method public void onCharacteristicWriteRequest(android.bluetooth.BluetoothDevice, int, android.bluetooth.BluetoothGattCharacteristic, boolean, boolean, int, byte[]);
		method public void onConnectionStateChange(android.bluetooth.BluetoothDevice, int, int);
		method public void onDescriptorReadRequest(android.bluetooth.BluetoothDevice, int, int, android.bluetooth.BluetoothGattDescriptor);
		method public void onDescriptorWriteRequest(android.bluetooth.BluetoothDevice, int, android.bluetooth.BluetoothGattDescriptor, boolean, boolean, int, byte[]);
		method public void onExecuteWrite(android.bluetooth.BluetoothDevice, int, boolean);
		method public void onServiceAdded(int, android.bluetooth.BluetoothGattService);
		}

		public class BluetoothGattService {
		ctor public BluetoothGattService(java.util.UUID, int);
		method public boolean addCharacteristic(android.bluetooth.BluetoothGattCharacteristic);
		method public boolean addService(android.bluetooth.BluetoothGattService);
		method public android.bluetooth.BluetoothGattCharacteristic getCharacteristic(java.util.UUID);
		method public java.util.List<android.bluetooth.BluetoothGattCharacteristic> getCharacteristics();
		method public java.util.List<android.bluetooth.BluetoothGattService> getIncludedServices();
		method public int getInstanceId();
		method public int getType();
		method public java.util.UUID getUuid();
		field public static final int SERVICE_TYPE_PRIMARY = 0; // 0x0
		field public static final int SERVICE_TYPE_SECONDARY = 1; // 0x1
		field protected java.util.List mCharacteristics;
		field protected java.util.List mIncludedServices;
		}

		public final class BluetoothHeadset implements android.bluetooth.BluetoothProfile {
		method public java.util.List<android.bluetooth.BluetoothDevice> getConnectedDevices();
		method public int getConnectionState(android.bluetooth.BluetoothDevice);
		@@ -4932,6 +5099,14 @@ package android.bluetooth {
		method public void onHealthChannelStateChange(android.bluetooth.BluetoothHealthAppConfiguration, android.bluetooth.BluetoothDevice, int, int, android.os.ParcelFileDescriptor, int);
		}

		public final class BluetoothManager {
		method public android.bluetooth.BluetoothAdapter getAdapter();
		method public java.util.List<android.bluetooth.BluetoothDevice> getConnectedDevices(int);
		method public int getConnectionState(android.bluetooth.BluetoothDevice, int);
		method public java.util.List<android.bluetooth.BluetoothDevice> getDevicesMatchingConnectionStates(int, int[]);
		method public android.bluetooth.BluetoothGattServer openGattServer(android.content.Context, android.bluetooth.BluetoothGattServerCallback);
		}

		public abstract interface BluetoothProfile {
		method public abstract java.util.List<android.bluetooth.BluetoothDevice> getConnectedDevices();
		method public abstract int getConnectionState(android.bluetooth.BluetoothDevice);
		@@ -4939,6 +5114,8 @@ package android.bluetooth {
		field public static final int A2DP = 2; // 0x2
		field public static final java.lang.String EXTRA_PREVIOUS_STATE = "android.bluetooth.profile.extra.PREVIOUS_STATE";
		field public static final java.lang.String EXTRA_STATE = "android.bluetooth.profile.extra.STATE";
		field public static final int GATT = 7; // 0x7
		field public static final int GATT_SERVER = 8; // 0x8
		field public static final int HEADSET = 1; // 0x1
		field public static final int HEALTH = 3; // 0x3
		field public static final int STATE_CONNECTED = 2; // 0x2
		@@ -5496,6 +5673,7 @@ package android.content {
		field public static final int BIND_IMPORTANT = 64; // 0x40
		field public static final int BIND_NOT_FOREGROUND = 4; // 0x4
		field public static final int BIND_WAIVE_PRIORITY = 32; // 0x20
		field public static final java.lang.String BLUETOOTH_SERVICE = "bluetooth";
		field public static final java.lang.String CLIPBOARD_SERVICE = "clipboard";
		field public static final java.lang.String CONNECTIVITY_SERVICE = "connectivity";
		field public static final int CONTEXT_IGNORE_SECURITY = 2; // 0x2

core/java/android/app/ContextImpl.java

+2 −2

Original line number	Diff line number	Diff line
		@@ -19,7 +19,7 @@ package android.app;
		import com.android.internal.policy.PolicyManager;
		import com.android.internal.util.Preconditions;

		import android.bluetooth.BluetoothAdapter;
		import android.bluetooth.BluetoothManager;
		import android.content.BroadcastReceiver;
		import android.content.ComponentName;
		import android.content.ContentResolver;
		@@ -319,7 +319,7 @@ class ContextImpl extends Context {

		registerService(BLUETOOTH_SERVICE, new ServiceFetcher() {
		public Object createService(ContextImpl ctx) {
		return BluetoothAdapter.getDefaultAdapter();
		return new BluetoothManager(ctx);
		}});

		registerService(CLIPBOARD_SERVICE, new ServiceFetcher() {

core/java/android/bluetooth/BluetoothAdapter.java

+230 −8

File changed.

Preview size limit exceeded, changes collapsed.

core/java/android/bluetooth/MutableBluetoothGattDescriptor.java→core/java/android/bluetooth/BluetoothAdapterCallback.java

+57 −0

Original line number	Diff line number	Diff line
		@@ -16,30 +16,42 @@

		package android.bluetooth;

		import java.util.UUID;
		import android.bluetooth.BluetoothDevice;

		/**
		* Mutable variant of a Bluetooth Gatt Descriptor
		* @hide
		* This abstract class is used to implement {@link BluetoothAdapter} callbacks.
		*/
		public class MutableBluetoothGattDescriptor extends BluetoothGattDescriptor {
		public abstract class BluetoothAdapterCallback {

		/**
		* Create a new BluetoothGattDescriptor.
		* <p>Requires {@link android.Manifest.permission#BLUETOOTH} permission.
		* Indicates the callback has been registered successfully
		*/
		public static final int CALLBACK_REGISTERED = 0;

		/**
		* Indicates the callback registration has failed
		*/
		public static final int CALLBACK_REGISTRATION_FAILURE = 1;

		/**
		* Callback to inform change in registration state of the application.
		*
		* @param uuid The UUID for this descriptor
		* @param permissions Permissions for this descriptor
		* @param status Returns {@link #CALLBACK_REGISTERED} if the application
		* was successfully registered.
		*/
		public MutableBluetoothGattDescriptor(UUID uuid, int permissions) {
		super(null, uuid, permissions);
		public void onCallbackRegistration(int status) {
		}

		/**
		* Set the back-reference to the associated characteristic
		* @hide
		* Callback reporting an LE device found during a device scan initiated
		* by the {@link BluetoothAdapter#startLeScan} function.
		*
		* @param device Identifies the remote device
		* @param rssi The RSSI value for the remote device as reported by the
		* Bluetooth hardware. 0 if no RSSI value is available.
		* @param scanRecord The content of the advertisement record offered by
		* the remote device.
		*/
		/package/ void setCharacteristic(BluetoothGattCharacteristic characteristic) {
		mCharacteristic = characteristic;
		public void onLeScan(BluetoothDevice device, int rssi, byte[] scanRecord) {
		}
		}

core/java/android/bluetooth/BluetoothDevice.java

+27 −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.IBinder;
		import android.os.Parcel;
		import android.os.Parcelable;
		@@ -1126,4 +1127,30 @@ public final class BluetoothDevice implements Parcelable {
		return pinBytes;
		}

		/**
		* Connect to GATT Server hosted by this device. Caller acts as GATT client.
		* The callback is used to deliver results to Caller, such as connection status as well
		* as any further GATT client operations.
		* The method returns a BluetoothGatt instance. You can use BluetoothGatt to conduct
		* GATT client operations.
		* @param callback GATT callback handler that will receive asynchronous callbacks.
		* @param autoConnect Whether to directly connect to the remote device (false)
		* or to automatically connect as soon as the remote
		* device becomes available (true).
		* @throws IllegalArgumentException if callback is null
		*/
		public BluetoothGatt connectGattServer(Context context, boolean autoConnect,
		BluetoothGattCallback callback) {
		// TODO(Bluetooth) check whether platform support BLE
		// Do the check here or in GattServer?
		BluetoothAdapter adapter = BluetoothAdapter.getDefaultAdapter();
		IBluetoothManager managerService = adapter.getBluetoothManager();
		try {
		IBluetoothGatt iGatt = managerService.getBluetoothGatt();
		BluetoothGatt gatt = new BluetoothGatt(context, iGatt, this);
		gatt.connect(autoConnect, callback);
		return gatt;
		} catch (RemoteException e) {Log.e(TAG, "", e);}
		return null;
		}
		}