Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Ctors](https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings.Builder#pubctors) \| [Methods](https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings.Builder#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings.Builder#inhmethods)

# AdvertiseSettings.Builder

*** ** * ** ***

` public static final class AdvertiseSettings.Builder `   
` extends https://developer.android.com/reference/java/lang/Object ` ` `

|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.bluetooth.le.AdvertiseSettings.Builder |

<br />

*** ** * ** ***

Builder class for `https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings`.

## Summary

| ### Public constructors ||
|---|---|
| ` https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings.Builder#Builder()() ` |

| ### Public methods ||
|---|---|
| ` https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings` | ` https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings.Builder#build()() ` Build the `https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings` object. |
| ` https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings.Builder` | ` https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings.Builder#setAdvertiseMode(int)(int advertiseMode) ` Set advertise mode to control the advertising power and latency. |
| ` https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings.Builder` | ` https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings.Builder#setConnectable(boolean)(boolean connectable) ` Set whether the advertisement type should be connectable or non-connectable. |
| ` https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings.Builder` | ` https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings.Builder#setDiscoverable(boolean)(boolean discoverable) ` Set whether the advertisement type should be discoverable or non-discoverable. |
| ` https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings.Builder` | ` https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings.Builder#setTimeout(int)(int timeoutMillis) ` Limit advertising to a given amount of time. |
| ` https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings.Builder` | ` https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings.Builder#setTxPowerLevel(int)(int txPowerLevel) ` Set advertise TX power level to control the transmission power level for the advertising. |

### Inherited methods

From class ` https://developer.android.com/reference/java/lang/Object ` ` https://developer.android.com/reference/java/lang/Object` ` https://developer.android.com/reference/java/lang/Object#clone()() `

Creates and returns a copy of this object.
` boolean` ` https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) `

Indicates whether some other object is "equal to" this one.
` void` ` https://developer.android.com/reference/java/lang/Object#finalize()() `

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
` final https://developer.android.com/reference/java/lang/Class<?>` ` https://developer.android.com/reference/java/lang/Object#getClass()() `

Returns the runtime class of this `Object`.
` int` ` https://developer.android.com/reference/java/lang/Object#hashCode()() `

Returns a hash code value for the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#notify()() `

Wakes up a single thread that is waiting on this object's monitor.
` final void` ` https://developer.android.com/reference/java/lang/Object#notifyAll()() `

Wakes up all threads that are waiting on this object's monitor.
` https://developer.android.com/reference/java/lang/String` ` https://developer.android.com/reference/java/lang/Object#toString()() `

Returns a string representation of the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(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` ` https://developer.android.com/reference/java/lang/Object#wait(long)(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` ` https://developer.android.com/reference/java/lang/Object#wait()() `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*.

## Public constructors

### Builder

Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public Builder ()
```

<br />

<br />

## Public methods

### build

Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public AdvertiseSettings build ()
```

Build the `https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings` object.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings` | <br /> |

### setAdvertiseMode

Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public AdvertiseSettings.Builder setAdvertiseMode (int advertiseMode)
```

Set advertise mode to control the advertising power and latency.

<br />

| Parameters ||
|---|---|
| `advertiseMode` | `int`: Bluetooth LE Advertising mode, can only be one of `https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings#ADVERTISE_MODE_LOW_POWER`, `https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings#ADVERTISE_MODE_BALANCED`, or `https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings#ADVERTISE_MODE_LOW_LATENCY`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings.Builder` | <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | If the advertiseMode is invalid. |

### setConnectable

Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public AdvertiseSettings.Builder setConnectable (boolean connectable)
```

Set whether the advertisement type should be connectable or non-connectable.

<br />

| Parameters ||
|---|---|
| `connectable` | `boolean`: Controls whether the advertisement type will be connectable (true) or non-connectable (false). <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings.Builder` | <br /> |

### setDiscoverable

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public AdvertiseSettings.Builder setDiscoverable (boolean discoverable)
```

Set whether the advertisement type should be discoverable or non-discoverable.

<br />

| Parameters ||
|---|---|
| `discoverable` | `boolean`: Controls whether the advertisement type will be discoverable (`true`) or non-discoverable (`false`). <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings.Builder` | This value cannot be `null`. <br /> |

### setTimeout

Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public AdvertiseSettings.Builder setTimeout (int timeoutMillis)
```

Limit advertising to a given amount of time.

<br />

| Parameters ||
|---|---|
| `timeoutMillis` | `int`: Advertising time limit. May not exceed 180000 milliseconds. A value of 0 will disable the time limit. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings.Builder` | <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | If the provided timeout is over 180000 ms. |

### setTxPowerLevel

Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public AdvertiseSettings.Builder setTxPowerLevel (int txPowerLevel)
```

Set advertise TX power level to control the transmission power level for the advertising.

<br />

| Parameters ||
|---|---|
| `txPowerLevel` | `int`: Transmission power of Bluetooth LE Advertising, can only be one of `https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings#ADVERTISE_TX_POWER_ULTRA_LOW`, `https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings#ADVERTISE_TX_POWER_LOW`, `https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings#ADVERTISE_TX_POWER_MEDIUM` or `https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings#ADVERTISE_TX_POWER_HIGH`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/bluetooth/le/AdvertiseSettings.Builder` | <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | If the `txPowerLevel` is invalid. |