com.polidea.rxandroidble2

Class RxBleDeviceServices

java.lang.Object

com.polidea.rxandroidble2.RxBleDeviceServices

public class RxBleDeviceServices
extends java.lang.Object

Service discovery result containing list of services and characteristics within the services.

Constructor Summary

Constructors

Constructor and Description
RxBleDeviceServices(java.util.List<android.bluetooth.BluetoothGattService> bluetoothGattServices)

Method Summary

Modifier and Type	Method and Description
java.util.List<android.bluetooth.BluetoothGattService>	getBluetoothGattServices() List of all GATT services supported by the device
<any>	getCharacteristic(java.util.UUID characteristicUuid) Creates an observable emitting BluetoothGattCharacteristic with matching characteristic UUID.
<any>	getCharacteristic(java.util.UUID serviceUuid, java.util.UUID characteristicUuid) Creates an observable emitting BluetoothGattCharacteristics with matching service UUID and characteristic UUID.
<any>	getDescriptor(java.util.UUID characteristicUuid, java.util.UUID descriptorUuid)
<any>	getDescriptor(java.util.UUID serviceUuid, java.util.UUID characteristicUuid, java.util.UUID descriptorUuid)
<any>	getService(java.util.UUID serviceUuid) Creates an observable emitting BluetoothGattService with matching service UUID.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RxBleDeviceServices

public RxBleDeviceServices(java.util.List<android.bluetooth.BluetoothGattService> bluetoothGattServices)

Method Detail

getBluetoothGattServices

public java.util.List<android.bluetooth.BluetoothGattService> getBluetoothGattServices()

List of all GATT services supported by the device

getService

public <any> getService(java.util.UUID serviceUuid)

Creates an observable emitting BluetoothGattService with matching service UUID. The observable completes after first emission.

Parameters:

serviceUuid - Service UUID to be found

Returns:

Observable emitting matching services or error if hasn't been found.

Throws:

BleServiceNotFoundException - if service with given UUID hasn't been found.

getCharacteristic

public <any> getCharacteristic(java.util.UUID characteristicUuid)

Creates an observable emitting BluetoothGattCharacteristic with matching characteristic UUID. The observable completes after first emission.

The main assumption is that characteristics have unique UUID across all services as there is a traversal done across all of them. For an alternative see RxBleDeviceServices#getCharacteristic(UUID)

Parameters:

characteristicUuid - Characteristic UUID to be found

Returns:

Observable emitting matching characteristic or error if hasn't been found.

Throws:

BleCharacteristicNotFoundException - if characteristic with given UUID hasn't been found.

getCharacteristic

public <any> getCharacteristic(java.util.UUID serviceUuid,
                               java.util.UUID characteristicUuid)

Creates an observable emitting BluetoothGattCharacteristics with matching service UUID and characteristic UUID. The observable completes after first emission.

Parameters:

characteristicUuid - Characteristic UUID to be found

serviceUuid - Service UUID to search in

Returns:

Observable emitting matching characteristic or error if hasn't been found.

Throws:

BleCharacteristicNotFoundException - if characteristic with given UUID hasn't been found.

See Also:

getCharacteristic(UUID)

getDescriptor

public <any> getDescriptor(java.util.UUID characteristicUuid,
                           java.util.UUID descriptorUuid)

getDescriptor

public <any> getDescriptor(java.util.UUID serviceUuid,
                           java.util.UUID characteristicUuid,
                           java.util.UUID descriptorUuid)