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: System.Object

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
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
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
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
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
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
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>