Class BluetoothLeAdvertiseData

Definition

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

Bluetooth LE advertise data. Handles the data advertising.

C#
Copy
public class BluetoothLeAdvertiseData : IDisposable
Inheritance
System.Object
BluetoothLeAdvertiseData
Implements
System.IDisposable

Constructors

View Source

BluetoothLeAdvertiseData()

The default constructor initializes an object of the BluetoothLeAdvertiseData.

Declaration
C#
Copy
public BluetoothLeAdvertiseData()
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 create advertiser fails.

API Level: 3

Properties

View Source

AdvertisingConnectable

The advertising connectable type.

Declaration
C#
Copy
public bool AdvertisingConnectable { get; set; }
Property Value
Type Description
Boolean
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 set advertising connectable mode fails.

API Level: 3
View Source

AdvertisingMode

The advertising mode to control the advertising power and latency.

Declaration
C#
Copy
public BluetoothLeAdvertisingMode AdvertisingMode { get; set; }
Property Value
Type Description
BluetoothLeAdvertisingMode
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 set advertising mode fails.

API Level: 3
View Source

Appearance

Sets the external appearance of this device to the advertise or the scan response data. Please refer to the adopted Bluetooth specification for the appearance.

Declaration
C#
Copy
public int Appearance { get; set; }
Property Value
Type Description
Int32
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 set appearance fails.

API Level: 3
View Source

IncludeDeviceName

Sets whether the device name has to be included in the advertise or the scan response data. The maximum advertised or responded data size is 31 bytes including the data type and the system wide data.

Declaration
C#
Copy
public bool IncludeDeviceName { get; set; }
Property Value
Type Description
Boolean
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 set advertising device name fails.

API Level: 3
View Source

IncludeTxPowerLevel

Sets whether the transmission power level should be included in the advertise or the scan response data. The maximum advertised or responded data size is 31 bytes including the data type and the system wide data.

Declaration
C#
Copy
public bool IncludeTxPowerLevel { get; set; }
Property Value
Type Description
Boolean
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 set advertising TC power level fails.

API Level: 3
View Source

PacketType

The type of the packet.

Declaration
C#
Copy
public BluetoothLePacketType PacketType { get; set; }
Property Value
Type Description
BluetoothLePacketType
API Level: 3

Methods

View Source

AddAdvertisingManufacturerData(BluetoothLePacketType, ManufacturerData)

Adds the manufacturer specific data to the advertise or the scan response data. Please refer to the adopted Bluetooth specification for the the appearance.

Declaration
C#
Copy
public void AddAdvertisingManufacturerData(BluetoothLePacketType packetType, ManufacturerData manufacturerData)
Parameters
Type Name Description
BluetoothLePacketType packetType

The packet type.

ManufacturerData manufacturerData

The manufacturer specific data.

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 add advertising manufacturer data procedure fails.

API Level: 3
View Source

AddAdvertisingServiceData(BluetoothLePacketType, BluetoothServiceData)

Adds a service data to the advertise or the scan response data. The maximum advertised or responded data size is 31 bytes including data type and system wide data.

Declaration
C#
Copy
public void AddAdvertisingServiceData(BluetoothLePacketType packetType, BluetoothServiceData data)
Parameters
Type Name Description
BluetoothLePacketType packetType

The packet type.

BluetoothServiceData data

The service data to be added to advertising.

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 add advertising data procedure fails.

API Level: 3
View Source

AddAdvertisingServiceSolicitationUuid(BluetoothLePacketType, String)

Adds a service solicitation UUID to advertise or scan the response data. The maximum advertised or responded data size is 31 bytes including the data type and the system wide data.

Declaration
C#
Copy
public void AddAdvertisingServiceSolicitationUuid(BluetoothLePacketType packetType, string serviceSolicitationUuid)
Parameters
Type Name Description
BluetoothLePacketType packetType

The packet type.

System.String serviceSolicitationUuid

The service solicitation UUID to add to advertise data.

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 add advertising service solicitation UUID procedure fails.

API Level: 3
View Source

AddAdvertisingServiceUuid(BluetoothLePacketType, String)

Adds a service UUID to the advertise or the scan response data. The maximum advertised or responded data size is 31 bytes including the data type and the system wide data.

Declaration
C#
Copy
public void AddAdvertisingServiceUuid(BluetoothLePacketType packetType, string serviceUuid)
Parameters
Type Name Description
BluetoothLePacketType packetType

The packet type.

System.String serviceUuid

The service UUID to add to advertise data.

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 add advertising service UUID procedure fails.

API Level: 3
View Source

Dispose()

Dispose

Declaration
C#
Copy
public void Dispose()
API Level: 3
View Source

Finalize()

BluetoothLeAdvertiseData destructor.

Declaration
C#
Copy
protected void Finalize()

Implements

System.IDisposable