Summary: Ctors | Methods | Inherited Methods | [Expand All]

Added in API level 18

public abstract class

BluetoothGattServerCallback

extends Object

java.lang.Object
↳	android.bluetooth.BluetoothGattServerCallback

Class Overview

This abstract class is used to implement BluetoothGattServer callbacks.

Summary

Public Constructors
	BluetoothGattServerCallback()

Public Methods
void	onCharacteristicReadRequest(BluetoothDevice device, int requestId, int offset, BluetoothGattCharacteristic characteristic) A remote client has requested to read a local characteristic.
void	onCharacteristicWriteRequest(BluetoothDevice device, int requestId, BluetoothGattCharacteristic characteristic, boolean preparedWrite, boolean responseNeeded, int offset, byte[] value) A remote client has requested to write to a local characteristic.
void	onConnectionStateChange(BluetoothDevice device, int status, int newState) Callback indicating when a remote device has been connected or disconnected.
void	onDescriptorReadRequest(BluetoothDevice device, int requestId, int offset, BluetoothGattDescriptor descriptor) A remote client has requested to read a local descriptor.
void	onDescriptorWriteRequest(BluetoothDevice device, int requestId, BluetoothGattDescriptor descriptor, boolean preparedWrite, boolean responseNeeded, int offset, byte[] value) A remote client has requested to write to a local descriptor.
void	onExecuteWrite(BluetoothDevice device, int requestId, boolean execute) Execute all pending write operations for this device.
void	onMtuChanged(BluetoothDevice device, int mtu) Callback indicating the MTU for a given device connection has changed.
void	onNotificationSent(BluetoothDevice device, int status) Callback invoked when a notification or indication has been sent to a remote device.
void	onServiceAdded(int status, BluetoothGattService service) Indicates whether a local service has been added successfully.

[Expand]

Inherited Methods

From class java.lang.Object

Object	clone() Creates and returns a copy of this `Object`.
boolean	equals(Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of `Class` that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait(long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

Public Constructors

public BluetoothGattServerCallback ()

Added in API level 18

Public Methods

public void onCharacteristicReadRequest (BluetoothDevice device, int requestId, int offset, BluetoothGattCharacteristic characteristic)

Added in API level 18

A remote client has requested to read a local characteristic.

An application must call sendResponse(BluetoothDevice, int, int, int, byte[]) to complete the request.

Parameters

device	The remote device that has requested the read operation
requestId	The Id of the request
offset	Offset into the value of the characteristic
characteristic	Characteristic to be read

public void onCharacteristicWriteRequest (BluetoothDevice device, int requestId, BluetoothGattCharacteristic characteristic, boolean preparedWrite, boolean responseNeeded, int offset, byte[] value)

Added in API level 18

A remote client has requested to write to a local characteristic.

An application must call sendResponse(BluetoothDevice, int, int, int, byte[]) to complete the request.

Parameters

device	The remote device that has requested the write operation
requestId	The Id of the request
characteristic	Characteristic to be written to.
preparedWrite	true, if this write operation should be queued for later execution.
responseNeeded	true, if the remote device requires a response
offset	The offset given for the value
value	The value the client wants to assign to the characteristic

public void onConnectionStateChange (BluetoothDevice device, int status, int newState)

Added in API level 18

Callback indicating when a remote device has been connected or disconnected.

Parameters

device	Remote device that has been connected or disconnected.
status	Status of the connect or disconnect operation.
newState	Returns the new connection state. Can be one of `STATE_DISCONNECTED` or `STATE_CONNECTED`

public void onDescriptorReadRequest (BluetoothDevice device, int requestId, int offset, BluetoothGattDescriptor descriptor)

Added in API level 18

A remote client has requested to read a local descriptor.

An application must call sendResponse(BluetoothDevice, int, int, int, byte[]) to complete the request.

Parameters

device	The remote device that has requested the read operation
requestId	The Id of the request
offset	Offset into the value of the characteristic
descriptor	Descriptor to be read

public void onDescriptorWriteRequest (BluetoothDevice device, int requestId, BluetoothGattDescriptor descriptor, boolean preparedWrite, boolean responseNeeded, int offset, byte[] value)

Added in API level 18

A remote client has requested to write to a local descriptor.

An application must call sendResponse(BluetoothDevice, int, int, int, byte[]) to complete the request.

Parameters

device	The remote device that has requested the write operation
requestId	The Id of the request
descriptor	Descriptor to be written to.
preparedWrite	true, if this write operation should be queued for later execution.
responseNeeded	true, if the remote device requires a response
offset	The offset given for the value
value	The value the client wants to assign to the descriptor

public void onExecuteWrite (BluetoothDevice device, int requestId, boolean execute)

Added in API level 18

Execute all pending write operations for this device.

An application must call sendResponse(BluetoothDevice, int, int, int, byte[]) to complete the request.

Parameters

device	The remote device that has requested the write operations
requestId	The Id of the request
execute	Whether the pending writes should be executed (true) or cancelled (false)

public void onMtuChanged (BluetoothDevice device, int mtu)

Callback indicating the MTU for a given device connection has changed.

This callback will be invoked if a remote client has requested to change the MTU for a given connection.

Parameters

device	The remote device that requested the MTU change
mtu	The new MTU size

public void onNotificationSent (BluetoothDevice device, int status)

Added in API level 21

Callback invoked when a notification or indication has been sent to a remote device.

When multiple notifications are to be sent, an application must wait for this callback to be received before sending additional notifications.

Parameters

device	The remote device the notification has been sent to
status	`GATT_SUCCESS` if the operation was successful

public void onServiceAdded (int status, BluetoothGattService service)

Added in API level 18

Indicates whether a local service has been added successfully.

Parameters

status	Returns `GATT_SUCCESS` if the service was added successfully.
service	The service that has been added

Results

Interfaces

Classes

BluetoothGattServerCallback

Class Overview

Summary

Public Constructors

public BluetoothGattServerCallback ()

Public Methods

public void onCharacteristicReadRequest (BluetoothDevice device, int requestId, int offset, BluetoothGattCharacteristic characteristic)

Parameters

public void onCharacteristicWriteRequest (BluetoothDevice device, int requestId, BluetoothGattCharacteristic characteristic, boolean preparedWrite, boolean responseNeeded, int offset, byte[] value)

Parameters

public void onConnectionStateChange (BluetoothDevice device, int status, int newState)

Parameters

public void onDescriptorReadRequest (BluetoothDevice device, int requestId, int offset, BluetoothGattDescriptor descriptor)

Parameters

public void onDescriptorWriteRequest (BluetoothDevice device, int requestId, BluetoothGattDescriptor descriptor, boolean preparedWrite, boolean responseNeeded, int offset, byte[] value)

Parameters

public void onExecuteWrite (BluetoothDevice device, int requestId, boolean execute)

Parameters

public void onMtuChanged (BluetoothDevice device, int mtu)

Parameters

public void onNotificationSent (BluetoothDevice device, int status)

Parameters

public void onServiceAdded (int status, BluetoothGattService service)

Parameters