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 |
|
---|---|
![]() 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 |
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 |