Class BluetoothLeDevice

Definition

Namespace:
Tizen.Network.Bluetooth
Assembly:
Tizen.Network.Bluetooth.dll
API Level:
3

This is the BluetoothLeDevice class. It handles the LE device operations like getting data from the scan result.

C#
Copy
public class BluetoothLeDevice
Inheritance
BluetoothLeDevice

Properties

View Source

AddressType

The type of the address.

Declaration
C#
Copy
public BluetoothLeDeviceAddressType AddressType { get; }
Property Value
Type Description
BluetoothLeDeviceAddressType
API Level: 3
View Source

AdvertsingDataInformation

The advertsing data information.

Declaration
C#
Copy
public byte[] AdvertsingDataInformation { get; }
Property Value
Type Description
System.Byte[]
API Level: 3
View Source

Appearance

Gets the manufacturer data from the scan result.

Declaration
C#
Copy
[Obsolete("Deprecated since API level 6. Please use GetAppearance() method on BluetoothLeDevice.")] public int Appearance { get; }
Property Value
Type Description
System.Int32

Gets the appearance value.

Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the Bluetooth LE is not supported.

System.InvalidOperationException

Thrown when the Bluetooth LE is not enabled.

API Level: 3
View Source

DeviceName

Gets the device name from the LE scan result.

Declaration
C#
Copy
[Obsolete("Deprecated since API level 6. Please use GetDeviceName() method on BluetoothLeDevice.")] public string DeviceName { get; }
Property Value
Type Description
System.String

Gets the device name.

Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the Bluetooth LE is not supported.

System.InvalidOperationException

Thrown when the Bluetooth LE is not enabled.

API Level: 3
View Source

ManufacturerData

Gets the manufacturer data from the scan result.

Declaration
C#
Copy
[Obsolete("Deprecated since API level 6. Please use GetManufacturerData() method on BluetoothLeDevice.")] public ManufacturerData ManufacturerData { get; }
Property Value
Type Description
ManufacturerData

Gets the manufacturer data containing the manucturer data and ID information.

Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the Bluetooth LE is not supported.

System.InvalidOperationException

Thrown when the Bluetooth LE is not enabled.

API Level: 3
View Source

PacketType

The type of the packet.

Declaration
C#
Copy
[Obsolete("Deprecated since API level 6. Please use new methods with this type on BluetoothLeDevice.")] public BluetoothLePacketType PacketType { get; set; }
Property Value
Type Description
BluetoothLePacketType
API Level: 3
View Source

RemoteAddress

The remote address.

Declaration
C#
Copy
public string RemoteAddress { get; }
Property Value
Type Description
System.String
API Level: 3
View Source

Rssi

The rssi value.

Declaration
C#
Copy
public int Rssi { get; }
Property Value
Type Description
System.Int32
API Level: 3
View Source

ScanDataInformation

The scan data information.

Declaration
C#
Copy
public byte[] ScanDataInformation { get; }
Property Value
Type Description
System.Byte[]
API Level: 3
View Source

ServiceSolictationUuid

Gets the service solicitation UUID list from the scan result.

Declaration
C#
Copy
[Obsolete("Deprecated since API level 6. Please use GetServiceSolicitationUuid() method on BluetoothLeDevice.")] public IEnumerable<string> ServiceSolictationUuid { get; }
Property Value
Type Description
System.Collections.Generic.IEnumerable<System.String>

Gets the list of the service solicitation UUIDs.

Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the Bluetooth LE is not supported.

System.InvalidOperationException

Thrown when the Bluetooth LE is not enabled.

API Level: 3
View Source

ServiceUuid

Gets the service UUIDs list from the LE scan result.

Declaration
C#
Copy
[Obsolete("Deprecated since API level 6. Please use GetServiceUuid() method on BluetoothLeDevice.")] public IEnumerable<string> ServiceUuid { get; }
Property Value
Type Description
System.Collections.Generic.IEnumerable<System.String>

Gets the list of the string service UUIDs.

Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the Bluetooth LE is not supported.

System.InvalidOperationException

Thrown when the Bluetooth LE is not enabled.

API Level: 3
View Source

TxPowerLevel

Gets the transmission power level from the LE scan result.

Declaration
C#
Copy
[Obsolete("Deprecated since API level 6. Please use GetTxPowerLevel() method on BluetoothLeDevice.")] public int TxPowerLevel { get; }
Property Value
Type Description
System.Int32

Gets the transmission power level in dB.

Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the Bluetooth LE is not supported.

System.InvalidOperationException

Thrown when the Bluetooth LE is not enabled.

API Level: 3

Methods

View Source

GattConnect(Boolean)

Creates a GATT connection with the remote device.

Declaration
C#
Copy
[Obsolete("Deprecated since API level 6. Please use CreateClient() and ConnectAsync() method on BluetoothGattClient.")] public BluetoothGattClient GattConnect(bool autoConnect)
Parameters
Type Name Description
System.Boolean autoConnect

The auto connect flag.

Returns
Type Description
BluetoothGattClient

client instance

Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the Bluetooth LE is not supported.

System.InvalidOperationException

Thrown when the Bluetooth LE is not enabled or when the gatt connection attempt to remote device fails.

API Level: 3
View Source

GattDisconnect()

Disconnects a GATT connection with the remote device.

Declaration
C#
Copy
[Obsolete("Deprecated since API level 6. Please use DisconnectAsync() method on BluetoothGattClient.")] public void GattDisconnect()
Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the Bluetooth LE is not supported.

System.InvalidOperationException

Thrown when the Bluetooth LE is not enabled or when the GATT disconnection attempt to remote device fails.

API Level: 3
View Source

GetAppearance(BluetoothLePacketType)

Gets the manufacturer data from the scan result.

Declaration
C#
Copy
public int GetAppearance(BluetoothLePacketType packetType)
Parameters
Type Name Description
BluetoothLePacketType packetType

The enumeration for BLE packet type.

Returns
Type Description
System.Int32

Gets the appearance value.

Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the Bluetooth LE is not supported.

System.InvalidOperationException

Thrown when the Bluetooth LE is not enabled.

API Level: 6
Feature: http://tizen.org/feature/network.bluetooth.le
View Source

GetDeviceName(BluetoothLePacketType)

Gets the device name from the LE scan result.

Declaration
C#
Copy
public string GetDeviceName(BluetoothLePacketType packetType)
Parameters
Type Name Description
BluetoothLePacketType packetType

The enumeration for BLE packet type.

Returns
Type Description
System.String

Gets the device name.

Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the Bluetooth LE is not supported.

System.InvalidOperationException

Thrown when the Bluetooth LE is not enabled.

API Level: 6
Feature: http://tizen.org/feature/network.bluetooth.le
View Source

GetManufacturerData(BluetoothLePacketType)

Gets the manufacturer data from the scan result.

Declaration
C#
Copy
public ManufacturerData GetManufacturerData(BluetoothLePacketType packetType)
Parameters
Type Name Description
BluetoothLePacketType packetType

The enumeration for BLE packet type.

Returns
Type Description
ManufacturerData

Gets the manufacturer data containing the manucturer data and ID information.

Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the Bluetooth LE is not supported.

System.InvalidOperationException

Thrown when the Bluetooth LE is not enabled.

API Level: 6
Feature: http://tizen.org/feature/network.bluetooth.le
View Source

GetServiceDataList()

Gets the service data list from the scan result.

Declaration
C#
Copy
[Obsolete("Deprecated since API level 6. Please use GetServiceDataList() method on BluetoothLeDevice.")] public IEnumerable<BluetoothLeServiceData> GetServiceDataList()
Returns
Type Description
System.Collections.Generic.IEnumerable<BluetoothLeServiceData>

Returns the service data list.

Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the Bluetooth LE is not supported.

System.InvalidOperationException

Thrown when the Bluetooth LE is not enabled.

API Level: 3
View Source

GetServiceDataList(BluetoothLePacketType)

Gets the service data list from the scan result.

Declaration
C#
Copy
public IEnumerable<BluetoothLeServiceData> GetServiceDataList(BluetoothLePacketType packetType)
Parameters
Type Name Description
BluetoothLePacketType packetType

The packet type.

Returns
Type Description
System.Collections.Generic.IEnumerable<BluetoothLeServiceData>

Returns the service data list.

Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the Bluetooth LE is not supported.

System.InvalidOperationException

Thrown when the Bluetooth LE is not enabled.

API Level: 6
Feature: http://tizen.org/feature/network.bluetooth.le
View Source

GetServiceSolicitationUuid(BluetoothLePacketType)

Gets the service solicitation UUID list from the scan result.

Declaration
C#
Copy
public IEnumerable<string> GetServiceSolicitationUuid(BluetoothLePacketType packetType)
Parameters
Type Name Description
BluetoothLePacketType packetType

The enumeration for BLE packet type.

Returns
Type Description
System.Collections.Generic.IEnumerable<System.String>

Gets the list of the service solicitation UUIDs.

Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the Bluetooth LE is not supported.

System.InvalidOperationException

Thrown when the Bluetooth LE is not enabled.

API Level: 6
Feature: http://tizen.org/feature/network.bluetooth.le
View Source

GetServiceUuid(BluetoothLePacketType)

Gets the service UUIDs list from the LE scan result.

Declaration
C#
Copy
public IEnumerable<string> GetServiceUuid(BluetoothLePacketType packetType)
Parameters
Type Name Description
BluetoothLePacketType packetType

The enumeration for BLE packet type.

Returns
Type Description
System.Collections.Generic.IEnumerable<System.String>

Gets the list of the string service UUIDs.

Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the Bluetooth LE is not supported.

System.InvalidOperationException

Thrown when the Bluetooth LE is not enabled.

API Level: 6
Feature: http://tizen.org/feature/network.bluetooth.le
View Source

GetTxPowerLevel(BluetoothLePacketType)

Gets the transmission power level from the LE scan result.

Declaration
C#
Copy
public int GetTxPowerLevel(BluetoothLePacketType packetType)
Parameters
Type Name Description
BluetoothLePacketType packetType

The enumeration for BLE packet type.

Returns
Type Description
System.Int32

Gets the transmission power level in dB.

Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the Bluetooth LE is not supported.

System.InvalidOperationException

Thrown when the Bluetooth LE is not enabled.

API Level: 6
Feature: http://tizen.org/feature/network.bluetooth.le

Events

View Source

GattConnectionStateChanged

This event is called when the GATT client connects/disconnects with the server.

Declaration
C#
Copy
[Obsolete("Deprecated since API level 6. Please use ConnectionStateChanged event on BluetoothGattClient.")] public event EventHandler<GattConnectionStateChangedEventArgs> GattConnectionStateChanged
Event Type
Type Description
System.EventHandler<GattConnectionStateChangedEventArgs>
API Level: 3