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.

public class BluetoothLeDevice
Inheritance
Object
BluetoothLeDevice

Properties

View Source

AddressType

The type of the address.

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

AdvertsingDataInformation

The advertsing data information.

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

Appearance

Deprecated since API level 6. Please use GetAppearance() method on BluetoothLeDevice.

Gets the manufacturer data from the scan result.

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

Gets the appearance value.
Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
NotSupportedException

Thrown when the Bluetooth LE is not supported.
InvalidOperationException

Thrown when the Bluetooth LE is not enabled.
API Level: 3
View Source

DeviceName

Deprecated since API level 6. Please use GetDeviceName() method on BluetoothLeDevice.

Gets the device name from the LE scan result.

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

Gets the device name.
Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
NotSupportedException

Thrown when the Bluetooth LE is not supported.
InvalidOperationException

Thrown when the Bluetooth LE is not enabled.
API Level: 3
View Source

ManufacturerData

Deprecated since API level 6. Please use GetManufacturerData() method on BluetoothLeDevice.

Gets the manufacturer data from the scan result.

Declaration
[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
NotSupportedException

Thrown when the Bluetooth LE is not supported.
InvalidOperationException

Thrown when the Bluetooth LE is not enabled.
API Level: 3
View Source

PacketType

Deprecated since API level 6. Please use new methods with this type on BluetoothLeDevice.

The type of the packet.

Declaration
[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
public string RemoteAddress { get; }
Property Value
Type Description
String
API Level: 3
View Source

Rssi

The rssi value.

Declaration
public int Rssi { get; }
Property Value
Type Description
Int32
API Level: 3
View Source

ScanDataInformation

The scan data information.

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

ServiceSolictationUuid

Deprecated since API level 6. Please use GetServiceSolicitationUuid() method on BluetoothLeDevice.

Gets the service solicitation UUID list from the scan result.

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

Gets the list of the service solicitation UUIDs.
Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
NotSupportedException

Thrown when the Bluetooth LE is not supported.
InvalidOperationException

Thrown when the Bluetooth LE is not enabled.
API Level: 3
View Source

ServiceUuid

Deprecated since API level 6. Please use GetServiceUuid() method on BluetoothLeDevice.

Gets the service UUIDs list from the LE scan result.

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

Gets the list of the string service UUIDs.
Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
NotSupportedException

Thrown when the Bluetooth LE is not supported.
InvalidOperationException

Thrown when the Bluetooth LE is not enabled.
API Level: 3
View Source

TxPowerLevel

Deprecated since API level 6. Please use GetTxPowerLevel() method on BluetoothLeDevice.

Gets the transmission power level from the LE scan result.

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

Gets the transmission power level in dB.
Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
NotSupportedException

Thrown when the Bluetooth LE is not supported.
InvalidOperationException

Thrown when the Bluetooth LE is not enabled.
API Level: 3

Methods

View Source

GattConnect(Boolean)

Deprecated since API level 6. Please use CreateClient() and ConnectAsync() method on BluetoothGattClient.

Creates a GATT connection with the remote device.

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

The auto connect flag.
Returns
Type Description
BluetoothGattClient

client instance
Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
NotSupportedException

Thrown when the Bluetooth LE is not supported.
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()

Deprecated since API level 6. Please use DisconnectAsync() method on BluetoothGattClient.

Disconnects a GATT connection with the remote device.

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

The Bluetooth must be enabled.

Exceptions
Type Condition
NotSupportedException

Thrown when the Bluetooth LE is not supported.
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
public int GetAppearance(BluetoothLePacketType packetType)
Parameters
Type Name Description
BluetoothLePacketType packetType

The enumeration for BLE packet type.
Returns
Type Description
Int32

Gets the appearance value.
Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
NotSupportedException

Thrown when the Bluetooth LE is not supported.
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
public string GetDeviceName(BluetoothLePacketType packetType)
Parameters
Type Name Description
BluetoothLePacketType packetType

The enumeration for BLE packet type.
Returns
Type Description
String

Gets the device name.
Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
NotSupportedException

Thrown when the Bluetooth LE is not supported.
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
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
NotSupportedException

Thrown when the Bluetooth LE is not supported.
InvalidOperationException

Thrown when the Bluetooth LE is not enabled.
API Level: 6
Feature: http://tizen.org/feature/network.bluetooth.le
View Source

GetServiceDataList()

Deprecated since API level 6. Please use GetServiceDataList() method on BluetoothLeDevice.

Gets the service data list from the scan result.

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

Returns the service data list.
Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
NotSupportedException

Thrown when the Bluetooth LE is not supported.
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
public IEnumerable<BluetoothLeServiceData> GetServiceDataList(BluetoothLePacketType packetType)
Parameters
Type Name Description
BluetoothLePacketType packetType

The packet type.
Returns
Type Description
IEnumerable<BluetoothLeServiceData>

Returns the service data list.
Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
NotSupportedException

Thrown when the Bluetooth LE is not supported.
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
public IEnumerable<string> GetServiceSolicitationUuid(BluetoothLePacketType packetType)
Parameters
Type Name Description
BluetoothLePacketType packetType

The enumeration for BLE packet type.
Returns
Type Description
IEnumerable<String>

Gets the list of the service solicitation UUIDs.
Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
NotSupportedException

Thrown when the Bluetooth LE is not supported.
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
public IEnumerable<string> GetServiceUuid(BluetoothLePacketType packetType)
Parameters
Type Name Description
BluetoothLePacketType packetType

The enumeration for BLE packet type.
Returns
Type Description
IEnumerable<String>

Gets the list of the string service UUIDs.
Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
NotSupportedException

Thrown when the Bluetooth LE is not supported.
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
public int GetTxPowerLevel(BluetoothLePacketType packetType)
Parameters
Type Name Description
BluetoothLePacketType packetType

The enumeration for BLE packet type.
Returns
Type Description
Int32

Gets the transmission power level in dB.
Remarks

The Bluetooth must be enabled.

Exceptions
Type Condition
NotSupportedException

Thrown when the Bluetooth LE is not supported.
InvalidOperationException

Thrown when the Bluetooth LE is not enabled.
API Level: 6
Feature: http://tizen.org/feature/network.bluetooth.le

Events

View Source

GattConnectionStateChanged

Deprecated since API level 6. Please use ConnectionStateChanged event on BluetoothGattClient.

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

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