public
abstract
class
BluetoothGattServerCallback
extends Object
| java.lang.Object | |
| ↳ | android.bluetooth.BluetoothGattServerCallback |
This abstract class is used to implement BluetoothGattServer callbacks.
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. |
Inherited methods | |
|---|---|
 From
class
java.lang.Object
| |
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
|
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
|
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
|
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
|
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
|
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)
|
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
|
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
|
Developers
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
|