Skip to content

Most visited

Recently visited

navigation

AdvertiseData.Builder

public static final class AdvertiseData.Builder
extends Object

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


Builder for AdvertiseData.

Summary

Public constructors

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

From class java.lang.Object

Public constructors

AdvertiseData.Builder

added in API level 21
AdvertiseData.Builder ()

Public methods

addManufacturerData

added in API level 21
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

added in API level 21
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.

addServiceUuid

added in API level 21
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 serviceUuids are null.

build

added in API level 21
AdvertiseData build ()

Build the AdvertiseData.

Returns
AdvertiseData

setIncludeDeviceName

added in API level 21
AdvertiseData.Builder setIncludeDeviceName (boolean includeDeviceName)

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

Parameters
includeDeviceName boolean

Returns
AdvertiseData.Builder

setIncludeTxPowerLevel

added in API level 21
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

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience.
(Sep 2017 survey)