# Print output for @column tags ?> AdvertiseData.Builder - Android SDK | Android Developers

Most visited

Recently visited

AdvertiseData.Builder

public static final class AdvertiseData.Builder
extends Object

java.lang.Object
   ↳ android.bluetooth.le.AdvertiseData.Builder


Builder for AdvertiseData.

Summary

Public constructors

Builder()

Public methods

AdvertiseData.Builder addManufacturerData(int manufacturerId, byte[] manufacturerSpecificData)

Add manufacturer specific data.

AdvertiseData.Builder addServiceData(ParcelUuid serviceDataUuid, byte[] serviceData)

Add service data to advertise data.

AdvertiseData.Builder addServiceSolicitationUuid(ParcelUuid serviceSolicitationUuid)

Add a service solicitation UUID to advertise data.

AdvertiseData.Builder addServiceUuid(ParcelUuid serviceUuid)

Add a service UUID to advertise data.

AdvertiseData build()

Build the AdvertiseData.

AdvertiseData.Builder setIncludeDeviceName(boolean includeDeviceName)

Set whether the device name should be included in advertise packet.

AdvertiseData.Builder setIncludeTxPowerLevel(boolean includeTxPowerLevel)

Whether the transmission power level should be included in the advertise packet.

Inherited methods

Public constructors

Builder

public Builder ()

Public methods

addManufacturerData

public AdvertiseData.Builder addManufacturerData (int manufacturerId, 
                byte[] manufacturerSpecificData)

Add manufacturer specific data.

Please refer to the Bluetooth Assigned Numbers document provided by the Bluetooth SIG for a list of existing company identifiers.

Parameters
manufacturerId int: Manufacturer ID assigned by Bluetooth SIG.

manufacturerSpecificData byte: Manufacturer specific data

Returns
AdvertiseData.Builder

Throws
IllegalArgumentException If the manufacturerId is negative or manufacturerSpecificData is null.

addServiceData

public AdvertiseData.Builder addServiceData (ParcelUuid serviceDataUuid, 
                byte[] serviceData)

Add service data to advertise data.

Parameters
serviceDataUuid ParcelUuid: 16-bit UUID of the service the data is associated with

serviceData byte: Service data

Returns
AdvertiseData.Builder

Throws
IllegalArgumentException If the serviceDataUuid or serviceData is empty.

addServiceSolicitationUuid

public AdvertiseData.Builder addServiceSolicitationUuid (ParcelUuid serviceSolicitationUuid)

Add a service solicitation UUID to advertise data.

Parameters
serviceSolicitationUuid ParcelUuid: A service solicitation UUID to be advertised. This value cannot be null.

Returns
AdvertiseData.Builder

Throws
IllegalArgumentException If the serviceSolicitationUuid is null.

addServiceUuid

public AdvertiseData.Builder addServiceUuid (ParcelUuid serviceUuid)

Add a service UUID to advertise data.

Parameters
serviceUuid ParcelUuid: A service UUID to be advertised.

Returns
AdvertiseData.Builder

Throws
IllegalArgumentException If the serviceUuid is null.

build

public AdvertiseData build ()

Build the AdvertiseData.

Returns
AdvertiseData

setIncludeDeviceName

public AdvertiseData.Builder setIncludeDeviceName (boolean includeDeviceName)

Set whether the device name should be included in advertise packet.

Parameters
includeDeviceName boolean

Returns
AdvertiseData.Builder

setIncludeTxPowerLevel

public AdvertiseData.Builder setIncludeTxPowerLevel (boolean includeTxPowerLevel)

Whether the transmission power level should be included in the advertise packet. Tx power level field takes 3 bytes in advertise packet.

Parameters
includeTxPowerLevel boolean

Returns
AdvertiseData.Builder