Class BluetoothGattServer

Definition

Namespace:: Tizen.Network.Bluetooth

Assembly:: Tizen.Network.Bluetooth.dll

API Level:: 3

The Bluetooth GATT server.

public class BluetoothGattServer : IDisposable

Inheritance: Object

BluetoothGattServer

Implements: IDisposable

Methods

View Source

CreateServer()

Creates the Bluetooth GATT server.

Declaration

public static BluetoothGattServer CreateServer()

Returns

Type	Description
BluetoothGattServer	The BluetoothGattServer instance.

Exceptions

Type	Condition
NotSupportedException	Thrown when the BT/BTLE is not supported.
InvalidOperationException	Thrown when the create GATT server fails.

API Level: 3

Feature: http://tizen.org/feature/network.bluetooth.le.gatt.server

View Source

Dispose()

Destroys the current object.

Declaration

public void Dispose()

API Level: 6

Feature: http://tizen.org/feature/network.bluetooth.le.gatt.server

View Source

Dispose(Boolean)

Releases all the resources currently used by this instance.

Declaration

protected virtual void Dispose(bool disposing)

Parameters

Type	Name	Description
Boolean	disposing	true if the managed resources should be disposed, otherwise false.

API Level: 6

View Source

Finalize()

Destroys the current object.

Declaration

protected void Finalize()

View Source

GetService(String)

Gets service with given UUID that belongs to this server.

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
NotSupportedException	Thrown when the BT/BTLE is not supported.
InvalidOperationException	Thrown when the service is not registered.

API Level: 3

Feature: http://tizen.org/feature/network.bluetooth.le.gatt.server

View Source

GetServices()

Gets the list of services that belongs to this server.

Declaration

public IEnumerable<BluetoothGattService> GetServices()

Returns

Type	Description
IEnumerable<BluetoothGattService>	The list of services that belongs to this server.

Exceptions

Type	Condition
NotSupportedException	Thrown when the BT/BTLE is not supported.
InvalidOperationException	Thrown when the service is not registered.

API Level: 3

Feature: http://tizen.org/feature/network.bluetooth.le.gatt.server

View Source

RegisterGattService(BluetoothGattService)

Registers a specified service to this server.

Declaration

public void RegisterGattService(BluetoothGattService service)

Parameters

Type	Name	Description
BluetoothGattService	service	The service, which needs to be registered with this server.

Exceptions

Type	Condition
NotSupportedException	Thrown when the BT/BTLE is not supported.
InvalidOperationException	Thrown when the register service fails.

API Level: 3

Feature: http://tizen.org/feature/network.bluetooth.le.gatt.server

View Source

SendIndicationAsync(BluetoothGattCharacteristic, String)

Sends indication for the value change of the characteristic to the remote devices.

Declaration

public Task<bool> SendIndicationAsync(BluetoothGattCharacteristic characteristic, string clientAddress)

Parameters

Type	Name	Description
BluetoothGattCharacteristic	characteristic	The characteristic whose the value is changed.
String	clientAddress	The remote device address to send, notify, or indicate and if set to NULL, then notify/indicate all is enabled.

Returns

Type	Description
Task<Boolean>	true on success, false otherwise.

Exceptions

Type	Condition
NotSupportedException	Thrown when the BT/BTLE is not supported.
InvalidOperationException	Thrown when the BT/BTLE is not enabled or when the remote device is disconnected, or when service is not registered, or when the CCCD is not enabled.

API Level: 3

Feature: http://tizen.org/feature/network.bluetooth.le.gatt.server

View Source

SendNotification(BluetoothGattCharacteristic, String)

Sends the notification for the value change of the characteristic to the remote devices.

Declaration

public void SendNotification(BluetoothGattCharacteristic characteristic, string clientAddress)

Parameters

Type	Name	Description
BluetoothGattCharacteristic	characteristic	The characteristic, which has a changed value.
String	clientAddress	The remote device address to send, notify, or indicate and if set to NULL, then notify/indicate all is enabled.

Exceptions

Type	Condition
NotSupportedException	Thrown when the BT/BTLE is not supported.
InvalidOperationException	Thrown when the BT/BTLE is not enabled or when the remote device is disconnected, or when service is not registered, or when the CCCD is not enabled.

API Level: 3

Feature: http://tizen.org/feature/network.bluetooth.le.gatt.server

View Source

SendResponse(Int32, BluetoothGattRequestType, Int32, Byte[], Int32)

Sends a response to the remote device as a result of a read/write request.

Declaration

public void SendResponse(int requestId, BluetoothGattRequestType type, int status, byte[] value, int offset)

Parameters

Type	Name	Description
Int32	requestId	The identification of a read/write request.
BluetoothGattRequestType	type	The request type for read/write.
Int32	status	The error value in case of failure, 0 for success.
Byte[]	value	The value to be sent.
Int32	offset	The offset from where the value is read.

Exceptions

Type	Condition
NotSupportedException	Thrown when the BT/BTLE is not supported.
InvalidOperationException	Thrown when the BT/BTLE is not enabled or when the remote device is disconnected, or the send response procedure fails.

API Level: 3

Feature: http://tizen.org/feature/network.bluetooth.le.gatt.server

View Source

Start()

Registers the server along with the GATT services of the application it is hosting.

Declaration

public void Start()

Exceptions

Type	Condition
NotSupportedException	Thrown when the BT/BTLE is not supported.
InvalidOperationException	Thrown when the register server application fails.

API Level: 3

Feature: http://tizen.org/feature/network.bluetooth.le.gatt.server

View Source

UnregisterGattService(BluetoothGattService)

Unregisters a specified service from this server.

Declaration

public void UnregisterGattService(BluetoothGattService service)

Parameters

Type	Name	Description
BluetoothGattService	service	The service, which needs to be unregistered from this server.

Remarks

Once unregistered, the service object will become invalid and should not be used to access sevices or any children attribute's methods/members.

Exceptions

Type	Condition
NotSupportedException	Thrown when the BT/BTLE is not supported.
InvalidOperationException	Thrown when the unregister service fails.

API Level: 3

Feature: http://tizen.org/feature/network.bluetooth.le.gatt.server

View Source

UnregisterGattServices()

Unregisters all services from this server.

Declaration

public void UnregisterGattServices()

Remarks

Once unregistered, servicees will become invalid and should not be used to access sevices or any children attribute's methods/members.

Exceptions

Type	Condition
NotSupportedException	Thrown when the BT/BTLE is not supported.
InvalidOperationException	Thrown when the unregister all services fail.

API Level: 3

Feature: http://tizen.org/feature/network.bluetooth.le.gatt.server

Events

View Source

NotificationSent

(event) This event is called when the indication acknowledgement is received for each notified client.

Declaration

public event EventHandler<NotificationSentEventArg> NotificationSent

Event Type

Type	Description
EventHandler<NotificationSentEventArg>

API Level: 3

Implements

System.IDisposable