added in API level 18

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

BluetoothGattServerCallback

public abstract class BluetoothGattServerCallback
extends Object

java.lang.Object
↳	android.bluetooth.BluetoothGattServerCallback

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`	`onPhyRead(BluetoothDevice device, int txPhy, int rxPhy, int status)` Callback triggered as result of `readPhy(BluetoothDevice)`
`void`	`onPhyUpdate(BluetoothDevice device, int txPhy, int rxPhy, int status)` Callback triggered as result of `setPreferredPhy(BluetoothDevice, int, int, int)`, or as a result of remote device changing the PHY.
`void`	`onServiceAdded(int status, BluetoothGattService service)` Indicates whether a local service has been added successfully.

Inherited methods

From class


  
    java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long millis, int nanos)` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
`final void`	`wait(long millis)` Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
`final void`	`wait()` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.

Public constructors

BluetoothGattServerCallback

added in API level 18

BluetoothGattServerCallback ()

Public methods

onCharacteristicReadRequest

added in API level 18

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

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`	`BluetoothDevice`: The remote device that has requested the read operation
`requestId`	`int`: The Id of the request
`offset`	`int`: Offset into the value of the characteristic
`characteristic`	`BluetoothGattCharacteristic`: Characteristic to be read

onCharacteristicWriteRequest

added in API level 18

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.

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

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

onConnectionStateChange

added in API level 18

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

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

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

onDescriptorReadRequest

added in API level 18

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

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`	`BluetoothDevice`: The remote device that has requested the read operation
`requestId`	`int`: The Id of the request
`offset`	`int`: Offset into the value of the characteristic
`descriptor`	`BluetoothGattDescriptor`: Descriptor to be read

onDescriptorWriteRequest

added in API level 18

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.

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

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

onExecuteWrite

added in API level 18

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

Execute all pending write operations for this device.

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

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

onMtuChanged

added in API level 22

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`	`BluetoothDevice`: The remote device that requested the MTU change
`mtu`	`int`: The new MTU size

onNotificationSent

added in API level 21

void onNotificationSent (BluetoothDevice device, 
                int status)

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`	`BluetoothDevice`: The remote device the notification has been sent to
`status`	`int`: `GATT_SUCCESS` if the operation was successful

onPhyRead

added in API level 26

void onPhyRead (BluetoothDevice device, 
                int txPhy, 
                int rxPhy, 
                int status)

Callback triggered as result of readPhy(BluetoothDevice)

Parameters
`device`	`BluetoothDevice`: The remote device that requested the PHY read
`txPhy`	`int`: the transmitter PHY in use. One of `PHY_LE_1M`, `PHY_LE_2M`, and `PHY_LE_CODED`
`rxPhy`	`int`: the receiver PHY in use. One of `PHY_LE_1M`, `PHY_LE_2M`, and `PHY_LE_CODED`
`status`	`int`: Status of the PHY read operation. `GATT_SUCCESS` if the operation succeeds.

onPhyUpdate

added in API level 26

void onPhyUpdate (BluetoothDevice device, 
                int txPhy, 
                int rxPhy, 
                int status)

Callback triggered as result of setPreferredPhy(BluetoothDevice, int, int, int), or as a result of remote device changing the PHY.

Parameters
`device`	`BluetoothDevice`: The remote device
`txPhy`	`int`: the transmitter PHY in use. One of `PHY_LE_1M`, `PHY_LE_2M`, and `PHY_LE_CODED`
`rxPhy`	`int`: the receiver PHY in use. One of `PHY_LE_1M`, `PHY_LE_2M`, and `PHY_LE_CODED`
`status`	`int`: Status of the PHY update operation. `GATT_SUCCESS` if the operation succeeds.

onServiceAdded

added in API level 18

void onServiceAdded (int status, 
                BluetoothGattService service)

Indicates whether a local service has been added successfully.

Parameters
`status`	`int`: Returns `GATT_SUCCESS` if the service was added successfully.
`service`	`BluetoothGattService`: The service that has been added

Jun	JUL	Aug
	26
2016	2017	2018

Most visited

Recently visited

Results for

BluetoothGattServerCallback

Summary

Public constructors

Public methods

Inherited methods

Public constructors

BluetoothGattServerCallback

Public methods

onCharacteristicReadRequest

onCharacteristicWriteRequest

onConnectionStateChange

onDescriptorReadRequest

onDescriptorWriteRequest

onExecuteWrite

onMtuChanged

onNotificationSent

onPhyRead

onPhyUpdate

onServiceAdded

Interfaces

Classes