BtleGatt

```
public interface BtleGatt
```
Bluetooth GATT operations used by the API, must be implemented by the target platform

Author:

Eric Tsai

Nested Class Summary

Nested Classes
Modifier and Type	Interface and Description
`static interface`	`BtleGatt.DisconnectHandler` Handler for disconnect events
`static interface`	`BtleGatt.NotificationListener` Listener for GATT characteristic notifications
`static class`	`BtleGatt.WriteType` Write types for the GATT characteristic

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`Task<Void>`	`connectAsync()` Connects to the GATT server on the remote device
`Task<Void>`	`enableNotificationsAsync(BtleGattCharacteristic characteristic, BtleGatt.NotificationListener listener)` Enable notifications for the characteristic
`Task<Void>`	`localDisconnectAsync()` A disconnect attempted initiated by the Android device
`void`	`onDisconnect(BtleGatt.DisconnectHandler handler)` Register a handler for disconnect events
`Task<byte[]>`	`readCharacteristicAsync(BtleGattCharacteristic characteristic)` Reads the requested characteristic's value
`Task<byte[][]>`	`readCharacteristicAsync(BtleGattCharacteristic[] characteristics)` Convenience method to do bulk characteristic reads
`Task<Integer>`	`readRssiAsync()` Read the remote device's RSSI value
`Task<Void>`	`remoteDisconnectAsync()` A disconnect attempt that will be initiated by the remote device
`boolean`	`serviceExists(UUID gattService)` Checks if a service exists
`Task<Void>`	`writeCharacteristicAsync(BtleGattCharacteristic characteristic, BtleGatt.WriteType type, byte[] value)` Writes a GATT characteristic and its value to the remote device

- Method Detail
  - onDisconnect
```
void onDisconnect(BtleGatt.DisconnectHandler handler)
```
    Register a handler for disconnect events
    
    Parameters:
    
    handler - Handler to respond to the dc events
  - serviceExists
```
boolean serviceExists(UUID gattService)
```
    Checks if a service exists
    
    Parameters:
    
    gattService - UUID identifying the service to lookup
    
    Returns:
    
    True if service exists, false if not
  - writeCharacteristicAsync
```
Task<Void> writeCharacteristicAsync(BtleGattCharacteristic characteristic,
                                    BtleGatt.WriteType type,
                                    byte[] value)
```
    Writes a GATT characteristic and its value to the remote device
    
    Parameters:
    
    characteristic - GATT characteristic to write
    
    type - Type of GATT write to use
    
    value - Value to be written
    
    Returns:
    
    Task holding the result of the operation
  - readCharacteristicAsync
```
Task<byte[][]> readCharacteristicAsync(BtleGattCharacteristic[] characteristics)
```
    Convenience method to do bulk characteristic reads
    
    Parameters:
    
    characteristics - Array of characteristics to read
    
    Returns:
    
    Task which holds the characteristic values in order if all reads are successful
  - readCharacteristicAsync
```
Task<byte[]> readCharacteristicAsync(BtleGattCharacteristic characteristic)
```
    Reads the requested characteristic's value
    
    Parameters:
    
    characteristic - Characteristic to read
    
    Returns:
    
    Task holding the characteristic's value if successful
  - enableNotificationsAsync
```
Task<Void> enableNotificationsAsync(BtleGattCharacteristic characteristic,
                                    BtleGatt.NotificationListener listener)
```
    Enable notifications for the characteristic
    
    Parameters:
    
    characteristic - Characteristic to enable notifications for
    
    listener - Listener for handling characteristic notifications
    
    Returns:
    
    Task holding the result of the operation
  - localDisconnectAsync
```
Task<Void> localDisconnectAsync()
```
    A disconnect attempted initiated by the Android device
    
    Returns:
    
    Task holding the result of the disconnect attempt
  - remoteDisconnectAsync
```
Task<Void> remoteDisconnectAsync()
```
    A disconnect attempt that will be initiated by the remote device
    
    Returns:
    
    Task holding the result of the disconnect attempt
  - connectAsync
```
Task<Void> connectAsync()
```
    Connects to the GATT server on the remote device
    
    Returns:
    
    Task holding the result of the connect attempt
  - readRssiAsync
```
Task<Integer> readRssiAsync()
```
    Read the remote device's RSSI value
    
    Returns:
    
    Task holding the RSSI value, if successful

Interface BtleGatt

Nested Class Summary

Method Summary

Method Detail

onDisconnect

serviceExists

writeCharacteristicAsync

readCharacteristicAsync

readCharacteristicAsync

enableNotificationsAsync

localDisconnectAsync

remoteDisconnectAsync

connectAsync

readRssiAsync