BluetoothGattCallback

it2022-05-05  78

BluetoothGattCallback

public abstract class BluetoothGattCallback extends Object 

java.lang.Object   ↳android.bluetooth.BluetoothGattCallback

 


This abstract class is used to implement BluetoothGatt callbacks.

Summary


Public constructors

BluetoothGattCallback()

Public methods

void onCharacteristicChanged(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic)

Callback triggered as a result of a remote characteristic notification.

voidonCharacteristicRead(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status)

Callback reporting the result of a characteristic read operation.

voidonCharacteristicWrite(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status)

Callback indicating the result of a characteristic write operation.

voidonConnectionStateChange(BluetoothGatt gatt, int status, int newState)

Callback indicating when GATT client has connected/disconnected to/from a remote GATT server.

voidonDescriptorRead(BluetoothGatt gatt, BluetoothGattDescriptor descriptor, int status)

Callback reporting the result of a descriptor read operation.

voidonDescriptorWrite(BluetoothGatt gatt, BluetoothGattDescriptor descriptor, int status)

Callback indicating the result of a descriptor write operation.

voidonMtuChanged(BluetoothGatt gatt, int mtu, int status)

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

void onPhyRead(BluetoothGatt gatt, int txPhy, int rxPhy, int status)

Callback triggered as result of readPhy()

voidonPhyUpdate(BluetoothGatt gatt, int txPhy, int rxPhy, int status)

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

voidonReadRemoteRssi(BluetoothGatt gatt, int rssi, int status)

Callback reporting the RSSI for a remote device connection.

voidonReliableWriteCompleted(BluetoothGatt gatt, int status)

Callback invoked when a reliable write transaction has been completed.

voidonServicesDiscovered(BluetoothGatt gatt, int status)

Callback invoked when the list of remote services, characteristics and descriptors for the remote device have been updated, ie new services have been discovered.

 

Inherited methods

 From class java.lang.Object  

Public constructors


BluetoothGattCallback

added in  API level 18 BluetoothGattCallback ()

 

 

Public methods


onCharacteristicChanged

added in  API level 18 void onCharacteristicChanged (BluetoothGatt gatt, BluetoothGattCharacteristic characteristic)

Callback triggered as a result of a remote characteristic notification.

 

Parametersgatt BluetoothGatt: GATT client the characteristic is associated with

 

characteristic BluetoothGattCharacteristic: Characteristic that has been updated as a result of a remote notification event.

 

onCharacteristicRead

added in  API level 18 void onCharacteristicRead (BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status)

Callback reporting the result of a characteristic read operation.

 

ParametersgattBluetoothGatt: GATT client invoked readCharacteristic(BluetoothGattCharacteristic)

 

characteristic BluetoothGattCharacteristic: Characteristic that was read from the associated remote device.

 

statusint: GATT_SUCCESS if the read operation was completed successfully.

 

onCharacteristicWrite

added in  API level 18 void onCharacteristicWrite (BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status)

Callback indicating the result of a characteristic write operation.

If this callback is invoked while a reliable write transaction is in progress, the value of the characteristic represents the value reported by the remote device. An application should compare this value to the desired value to be written. If the values don't match, the application must abort the reliable write transaction.

 

ParametersgattBluetoothGatt: GATT client invoked writeCharacteristic(BluetoothGattCharacteristic)

 

characteristic BluetoothGattCharacteristic: Characteristic that was written to the associated remote device.

 

statusint: The result of the write operation GATT_SUCCESS if the operation succeeds.

 

onConnectionStateChange

added in  API level 18 void onConnectionStateChange (BluetoothGatt gatt, int status, int newState)

Callback indicating when GATT client has connected/disconnected to/from a remote GATT server.

 

ParametersgattBluetoothGatt: GATT client

 

statusint: Status of the connect or disconnect operation. GATT_SUCCESS if the operation succeeds.

 

newState int: Returns the new connection state. Can be one of STATE_DISCONNECTED or STATE_CONNECTED

 

onDescriptorRead

added in  API level 18 void onDescriptorRead (BluetoothGatt gatt, BluetoothGattDescriptor descriptor, int status)

Callback reporting the result of a descriptor read operation.

 

ParametersgattBluetoothGatt: GATT client invoked readDescriptor(BluetoothGattDescriptor)

 

descriptor BluetoothGattDescriptor: Descriptor that was read from the associated remote device.

 

statusint: GATT_SUCCESS if the read operation was completed successfully

 

onDescriptorWrite

added in  API level 18 void onDescriptorWrite (BluetoothGatt gatt, BluetoothGattDescriptor descriptor, int status)

Callback indicating the result of a descriptor write operation.

 

ParametersgattBluetoothGatt: GATT client invoked writeDescriptor(BluetoothGattDescriptor)

 

descriptor BluetoothGattDescriptor: Descriptor that was writte to the associated remote device.

 

statusint: The result of the write operation GATT_SUCCESS if the operation succeeds.

 

onMtuChanged

added in  API level 21 void onMtuChanged (BluetoothGatt gatt, int mtu, int status)

Callback indicating the MTU for a given device connection has changed. This callback is triggered in response to the requestMtu(int)function, or in response to a connection event.

 

ParametersgattBluetoothGatt: GATT client invoked requestMtu(int)

 

mtuint: The new MTU size

 

status int: GATT_SUCCESS if the MTU has been changed successfully

 

onPhyRead

added in  API level 26 void onPhyRead (BluetoothGatt gatt, int txPhy, int rxPhy, int status)

Callback triggered as result of readPhy()

 

ParametersgattBluetoothGatt: GATT client

 

txPhyint: 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.

 

statusint: Status of the PHY read operation. GATT_SUCCESS if the operation succeeds.

 

onPhyUpdate

added in  API level 26 void onPhyUpdate (BluetoothGatt gatt, int txPhy, int rxPhy, int status)

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

 

ParametersgattBluetoothGatt: GATT client

 

txPhy int: the transmitter PHY in use. One of PHY_LE_1M, PHY_LE_2M, and PHY_LE_CODED.

 

rxPhyint: the receiver PHY in use. One of PHY_LE_1M, PHY_LE_2M, and PHY_LE_CODED.

 

statusint: Status of the PHY update operation. GATT_SUCCESS if the operation succeeds.

 

onReadRemoteRssi

added in  API level 18 void onReadRemoteRssi (BluetoothGatt gatt, int rssi, int status)

Callback reporting the RSSI for a remote device connection. This callback is triggered in response to the readRemoteRssi() function.

 

ParametersgattBluetoothGatt: GATT client invoked readRemoteRssi()

 

rssiint: The RSSI value for the remote device

 

status int: GATT_SUCCESS if the RSSI was read successfully

 

onReliableWriteCompleted

added in  API level 18 void onReliableWriteCompleted (BluetoothGatt gatt, int status)

Callback invoked when a reliable write transaction has been completed.

 

ParametersgattBluetoothGatt: GATT client invoked executeReliableWrite()

 

status int: GATT_SUCCESS if the reliable write transaction was executed successfully

 

onServicesDiscovered

added in  API level 18 void onServicesDiscovered (BluetoothGatt gatt, int status)

Callback invoked when the list of remote services, characteristics and descriptors for the remote device have been updated, ie new services have been discovered.

 

ParametersgattBluetoothGatt: GATT client invoked discoverServices()

 

status int: GATT_SUCCESS if the remote device has been explored successfully.

转载于:https://www.cnblogs.com/nightnine/p/7685712.html


最新回复(0)