Class BluetoothGattClient
Definition
- Assembly:
- Tizen.Network.Bluetooth.dll
The Bluetooth GATT client.
public class BluetoothGattClient
- Inheritance
-
objectBluetoothGattClient
Properties
View SourceRemoteAddress
The address of the remote device.
Declaration
public string RemoteAddress { get; }
Property Value
Type | Description |
---|---|
string |
Exceptions
Type | Condition |
---|---|
System.InvalidOperationException | Thrown when the BT/BTLE is not enabled or when the remote device is disconnected. |
Methods
View SourceDestroyClient()
Destroy Bluetooth GATT client
Declaration
public void DestroyClient()
GetService(string)
Gets the service with the given UUID that belongs to the remote device.
Declaration
public BluetoothGattService GetService(string uuid)
Parameters
Type | Name | Description |
---|---|---|
string | uuid | The UUID for the service to get. |
Returns
Type | Description |
---|---|
BluetoothGattService | The service with the given UUID if it exists, null otherwise. |
Exceptions
Type | Condition |
---|---|
System.InvalidOperationException | Thrown when the BT/BTLE is not enabled or when the remote device is disconnected, or when the get service fails. |
GetServices()
Gets list of services that belongs to the remote device.
Declaration
public IEnumerable<BluetoothGattService> GetServices()
Returns
Type | Description |
---|---|
System.Collections.Generic.IEnumerable<T><BluetoothGattService> | The list of services that belongs to the remote device. |
Exceptions
Type | Condition |
---|---|
System.InvalidOperationException | Thrown when the BT/BTLE is not enabled or when the remote device is disconnected, or when the get service fails. |
ReadValueAsync(BluetoothGattCharacteristic)
Reads the value of a given characteristic from the remote device asynchronously.
Declaration
public Task<bool> ReadValueAsync(BluetoothGattCharacteristic characteristic)
Parameters
Type | Name | Description |
---|---|---|
BluetoothGattCharacteristic | characteristic | The characteristic to be read. |
Returns
Type | Description |
---|---|
System.Threading.Tasks.Task<TResult><bool> | true on success, false otherwise. |
Exceptions
Type | Condition |
---|---|
System.InvalidOperationException | Thrown when the BT/BTLE is not enabled or when the remote device is disconnected, or when the read attribute value fails. |
ReadValueAsync(BluetoothGattDescriptor)
Reads the value of the given descriptor from the remote device asynchronously.
Declaration
public Task<bool> ReadValueAsync(BluetoothGattDescriptor descriptor)
Parameters
Type | Name | Description |
---|---|---|
BluetoothGattDescriptor | descriptor | The descriptor to be read. |
Returns
Type | Description |
---|---|
System.Threading.Tasks.Task<TResult><bool> | true on success, false otherwise. |
Exceptions
Type | Condition |
---|---|
System.InvalidOperationException | Thrown when the BT/BTLE is not enabled or when the remote device is disconnected, or when the read attribute value fails. |
WriteValueAsync(BluetoothGattCharacteristic)
Writes the value of a given characteristic to the remote device asynchronously.
Declaration
public Task<bool> WriteValueAsync(BluetoothGattCharacteristic characteristic)
Parameters
Type | Name | Description |
---|---|---|
BluetoothGattCharacteristic | characteristic | The characteristic to be written. |
Returns
Type | Description |
---|---|
System.Threading.Tasks.Task<TResult><bool> | true on success, false otherwise. |
Exceptions
Type | Condition |
---|---|
System.InvalidOperationException | Thrown when the BT/BTLE is not enabled or when the remote device is disconnected or when the write attribute value fails. |
WriteValueAsync(BluetoothGattDescriptor)
Writes the value of the given descriptor to the remote device asynchronously.
Declaration
public Task<bool> WriteValueAsync(BluetoothGattDescriptor descriptor)
Parameters
Type | Name | Description |
---|---|---|
BluetoothGattDescriptor | descriptor | The descriptor to be written. |
Returns
Type | Description |
---|---|
System.Threading.Tasks.Task<TResult><bool> | true on success, false otherwise. |
Exceptions
Type | Condition |
---|---|
System.InvalidOperationException | Thrown when the BT/BTLE is not enabled or when the remote device is disconnected, or when the write attribute value fails. |