Added in API level 26

Summary: Ctors | Methods | Inherited Methods

AdvertisingSetParameters.Builder

---

Kotlin |Java

public static final class AdvertisingSetParameters.Builder
extends Object

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

---

Builder class for AdvertisingSetParameters.

Summary

Public constructors
Builder()

Public methods
AdvertisingSetParameters	build() Build the AdvertisingSetParameters object.
AdvertisingSetParameters.Builder	setAnonymous(boolean isAnonymous) Set whether advertiser address should be omitted from all packets.
AdvertisingSetParameters.Builder	setConnectable(boolean connectable) Set whether the advertisement type should be connectable or non-connectable.
AdvertisingSetParameters.Builder	setDiscoverable(boolean discoverable) Set whether the advertisement type should be discoverable or non-discoverable.
AdvertisingSetParameters.Builder	setIncludeTxPower(boolean includeTxPower) Set whether TX power should be included in the extended header.
AdvertisingSetParameters.Builder	setInterval(int interval) Set advertising interval.
AdvertisingSetParameters.Builder	setLegacyMode(boolean isLegacy) When set to true, advertising set will advertise 4.x Spec compliant advertisements.
AdvertisingSetParameters.Builder	setPrimaryPhy(int primaryPhy) Set the primary physical channel used for this advertising set.
AdvertisingSetParameters.Builder	setScannable(boolean scannable) Set whether the advertisement type should be scannable.
AdvertisingSetParameters.Builder	setSecondaryPhy(int secondaryPhy) Set the secondary physical channel used for this advertising set.
AdvertisingSetParameters.Builder	setTxPowerLevel(int txPowerLevel) Set the transmission power level for the advertising.

Inherited methods

From class java.lang.Object Object clone() Creates and returns a copy of this object. boolean equals(Object obj) Indicates whether some other object is "equal to" this one. void finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. final Class<?> getClass() Returns the runtime class of this Object. int hashCode() Returns a hash code value for the object. final void notify() Wakes up a single thread that is waiting on this object's monitor. final void notifyAll() Wakes up all threads that are waiting on this object's monitor. String toString() Returns a string representation of the object. final void wait(long timeoutMillis, int nanos) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait(long timeoutMillis) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait() Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Public constructors

Builder

Added in API level 26

public Builder ()

Public methods

build

Added in API level 26

public AdvertisingSetParameters build ()

Build the AdvertisingSetParameters object.

Returns
AdvertisingSetParameters

Throws
IllegalStateException	if invalid combination of parameters is used.

setAnonymous

Added in API level 26

public AdvertisingSetParameters.Builder setAnonymous (boolean isAnonymous)

Set whether advertiser address should be omitted from all packets. If this mode is used, periodic advertising can't be enabled for this set.

This is used only if legacy mode is not used.

Parameters
isAnonymous	boolean: whether anonymous advertising should be used.

Returns
AdvertisingSetParameters.Builder

setConnectable

Added in API level 26

public AdvertisingSetParameters.Builder setConnectable (boolean connectable)

Set whether the advertisement type should be connectable or non-connectable. Legacy advertisements can be both connectable and scannable. Non-legacy advertisements can be only scannable or only connectable.

Parameters
connectable	boolean: Controls whether the advertisement type will be connectable (true) or non-connectable (false).

Returns
AdvertisingSetParameters.Builder

setDiscoverable

Added in API level 34

public AdvertisingSetParameters.Builder setDiscoverable (boolean discoverable)

Set whether the advertisement type should be discoverable or non-discoverable. By default, advertisements will be discoverable. Devices connecting to non-discoverable advertisements cannot initiate bonding.

Parameters
discoverable	boolean: Controls whether the advertisement type will be discoverable (true) or non-discoverable (false).

Returns
AdvertisingSetParameters.Builder	This value cannot be null.

setIncludeTxPower

Added in API level 26

public AdvertisingSetParameters.Builder setIncludeTxPower (boolean includeTxPower)

Set whether TX power should be included in the extended header.

This is used only if legacy mode is not used.

Parameters
includeTxPower	boolean: whether TX power should be included in extended header

Returns
AdvertisingSetParameters.Builder

setInterval

Added in API level 26

public AdvertisingSetParameters.Builder setInterval (int interval)

Set advertising interval.

Parameters
interval	int: Bluetooth LE Advertising interval, in 0.625ms unit. Valid range is from 160 (100ms) to 16777215 (10,485.759375 s). Recommended values are: AdvertisingSetParameters.INTERVAL_LOW, AdvertisingSetParameters.INTERVAL_MEDIUM, or AdvertisingSetParameters.INTERVAL_HIGH.

Returns
AdvertisingSetParameters.Builder

Throws
IllegalArgumentException	If the interval is invalid.

setLegacyMode

Added in API level 26

public AdvertisingSetParameters.Builder setLegacyMode (boolean isLegacy)

When set to true, advertising set will advertise 4.x Spec compliant advertisements.

Parameters
isLegacy	boolean: whether legacy advertising mode should be used.

Returns
AdvertisingSetParameters.Builder

setPrimaryPhy

Added in API level 26

public AdvertisingSetParameters.Builder setPrimaryPhy (int primaryPhy)

Set the primary physical channel used for this advertising set.

This is used only if legacy mode is not used.

Use BluetoothAdapter.isLeCodedPhySupported to determine if LE Coded PHY is supported on this device.

Parameters
primaryPhy	int: Primary advertising physical channel, can only be BluetoothDevice.PHY_LE_1M or BluetoothDevice.PHY_LE_CODED.

Returns
AdvertisingSetParameters.Builder

Throws
IllegalArgumentException	If the primaryPhy is invalid.

setScannable

Added in API level 26

public AdvertisingSetParameters.Builder setScannable (boolean scannable)

Set whether the advertisement type should be scannable. Legacy advertisements can be both connectable and scannable. Non-legacy advertisements can be only scannable or only connectable.

Parameters
scannable	boolean: Controls whether the advertisement type will be scannable (true) or non-scannable (false).

Returns
AdvertisingSetParameters.Builder

setSecondaryPhy

Added in API level 26

public AdvertisingSetParameters.Builder setSecondaryPhy (int secondaryPhy)

Set the secondary physical channel used for this advertising set.

This is used only if legacy mode is not used.

Use BluetoothAdapter.isLeCodedPhySupported and BluetoothAdapter.isLe2MPhySupported() to determine if LE Coded PHY or 2M PHY is supported on this device.

Parameters
secondaryPhy	int: Secondary advertising physical channel, can only be one of BluetoothDevice.PHY_LE_1M, BluetoothDevice.PHY_LE_2M or BluetoothDevice.PHY_LE_CODED.

Returns
AdvertisingSetParameters.Builder

Throws
IllegalArgumentException	If the secondaryPhy is invalid.

setTxPowerLevel

Added in API level 26

public AdvertisingSetParameters.Builder setTxPowerLevel (int txPowerLevel)

Set the transmission power level for the advertising.

Parameters
txPowerLevel	int: Transmission power of Bluetooth LE Advertising, in dBm. The valid range is [-127, 1] Recommended values are: AdvertisingSetParameters.TX_POWER_ULTRA_LOW, AdvertisingSetParameters.TX_POWER_LOW, AdvertisingSetParameters.TX_POWER_MEDIUM, or AdvertisingSetParameters.TX_POWER_HIGH.

Returns
AdvertisingSetParameters.Builder

Throws
IllegalArgumentException	If the txPowerLevel is invalid.