Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Ctors](https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder#pubctors) \| [Methods](https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder#inhmethods)

# WifiPdRangingParams.Builder

*** ** * ** ***

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

|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.ranging.wifi.pd.WifiPdRangingParams.Builder |

<br />

*** ** * ** ***

Builder for `https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams`.

This class provides a convenient way to construct `https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams` objects. The MAC address of the peer device and the ranging service role are mandatory parameters and must be provided during the Builder's construction. Other parameters are optional and can be set using the respective setter methods.

Example usage:

    MacAddress peerMacAddress = MacAddress.fromString("01:02:03:04:05:06");
    WifiPdRangingParams params = new WifiPdRangingParams.Builder(peerMacAddress)
            .setDiscoveryChannelFrequencyMhz(5180)
            .setPasnMode(WifiPdRangingCapabilities.AUTHENTICATED_PASN_MODE)
            .setPassword("myPassword")
            .setDeviceIk(new byte[] {0x07, 0x08, 0x09, 0x0A, 0x0B, 0x0C})
            .build();

<br />

## Summary

| ### Public constructors ||
|---|---|
| ` https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder#Builder(android.net.MacAddress)(https://developer.android.com/reference/android/net/MacAddress peerMacAddress) ` Constructs a new `https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder` for creating a ranging session. |

| ### Public methods ||
|---|---|
| ` https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams` | ` https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder#build()() ` Builds the `https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams` object. |
| ` https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder` | ` https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder#setChannelWidth(int)(int channelWidth) ` Sets the channel width. |
| ` https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder` | ` https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder#setDeviceIk(byte[])(byte[] deviceIk) ` Sets the device identity key (IK). |
| ` https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder` | ` https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder#setDiscoveryChannelFrequencyMhz(int)(int discoveryChannelFrequencyMhz) ` Sets the discovery channel frequency in MHz. |
| ` https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder` | ` https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder#setPasnMode(int)(int pasnMode) ` Sets the PASN (Pre-association security negotiation) mode. |
| ` https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder` | ` https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder#setPassword(java.lang.String)(https://developer.android.com/reference/java/lang/String password) ` Sets the password for the ranging session. |
| ` https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder` | ` https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder#setPreambleType(int)(int preambleType) ` Sets the preamble type. |
| ` https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder` | ` https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder#setRangingUpdateRate(int)(int rangingUpdateRate) ` Sets the ranging update rate. |
| ` https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder` | ` https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder#setResponder80211azNtbSupported(boolean)(boolean isResponder80211azNtbSupported) ` Sets whether the responder supports 802.11az NTB. |

### 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 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public Builder (MacAddress peerMacAddress)
```

Constructs a new `https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder` for creating a ranging session.

<br />

| Parameters ||
|---|---|
| `peerMacAddress` | `MacAddress`: The MAC address of the peer device. This value cannot be `null`. <br /> |

## Public methods

### build

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

```
public WifiPdRangingParams build ()
```

Builds the `https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams` object.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams` | The built `https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams` object. This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | if Device IK length is not 16 or password is empty. |
| `https://developer.android.com/reference/java/lang/NullPointerException` | if required parameters are not set. |

### setChannelWidth

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

```
public WifiPdRangingParams.Builder setChannelWidth (int channelWidth)
```

Sets the channel width.

<br />

| Parameters ||
|---|---|
| `channelWidth` | `int`: The channel width. Value is one of the following: - `https://developer.android.com/reference/android/net/wifi/ScanResult#CHANNEL_WIDTH_20MHZ` - `https://developer.android.com/reference/android/net/wifi/ScanResult#CHANNEL_WIDTH_40MHZ` - `https://developer.android.com/reference/android/net/wifi/ScanResult#CHANNEL_WIDTH_80MHZ` - `https://developer.android.com/reference/android/net/wifi/ScanResult#CHANNEL_WIDTH_160MHZ` - `https://developer.android.com/reference/android/net/wifi/ScanResult#CHANNEL_WIDTH_80MHZ_PLUS_MHZ` - `https://developer.android.com/reference/android/net/wifi/ScanResult#CHANNEL_WIDTH_320MHZ` |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder` | The builder to facilitate chaining. This value cannot be `null`. <br /> |

### setDeviceIk

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

```
public WifiPdRangingParams.Builder setDeviceIk (byte[] deviceIk)
```

Sets the device identity key (IK).

<br />

| Parameters ||
|---|---|
| `deviceIk` | `byte`: The device identity key. This value may be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder` | The builder to facilitate chaining. This value cannot be `null`. <br /> |

### setDiscoveryChannelFrequencyMhz

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

```
public WifiPdRangingParams.Builder setDiscoveryChannelFrequencyMhz (int discoveryChannelFrequencyMhz)
```

Sets the discovery channel frequency in MHz.

<br />

| Parameters ||
|---|---|
| `discoveryChannelFrequencyMhz` | `int`: The discovery channel frequency in MHz. Value is between 2400 and 7125 inclusive <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder` | The builder to facilitate chaining. This value cannot be `null`. <br /> |

### setPasnMode

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

```
public WifiPdRangingParams.Builder setPasnMode (int pasnMode)
```

Sets the PASN (Pre-association security negotiation) mode.

<br />

| Parameters ||
|---|---|
| `pasnMode` | `int`: The PASN mode. Value is one of the following: - `https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingCapabilities#UNAUTHENTICATED_PASN_MODE` - `https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingCapabilities#AUTHENTICATED_PASN_MODE` |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder` | The builder to facilitate chaining. This value cannot be `null`. <br /> |

### setPassword

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

```
public WifiPdRangingParams.Builder setPassword (String password)
```

Sets the password for the ranging session.

<br />

| Parameters ||
|---|---|
| `password` | `String`: The password for the ranging session. This value may be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder` | The builder to facilitate chaining. This value cannot be `null`. <br /> |

### setPreambleType

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

```
public WifiPdRangingParams.Builder setPreambleType (int preambleType)
```

Sets the preamble type.

<br />

| Parameters ||
|---|---|
| `preambleType` | `int`: The preamble type. Value is one of the following: - `https://developer.android.com/reference/android/net/wifi/ScanResult#PREAMBLE_LEGACY` - `https://developer.android.com/reference/android/net/wifi/ScanResult#PREAMBLE_HT` - `https://developer.android.com/reference/android/net/wifi/ScanResult#PREAMBLE_VHT` - `https://developer.android.com/reference/android/net/wifi/ScanResult#PREAMBLE_HE` - `https://developer.android.com/reference/android/net/wifi/ScanResult#PREAMBLE_EHT` |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder` | The builder to facilitate chaining. This value cannot be `null`. <br /> |

### setRangingUpdateRate

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

```
public WifiPdRangingParams.Builder setRangingUpdateRate (int rangingUpdateRate)
```

Sets the ranging update rate.

<br />

| Parameters ||
|---|---|
| `rangingUpdateRate` | `int`: The ranging update rate. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder` | The builder to facilitate chaining. This value cannot be `null`. <br /> |

### setResponder80211azNtbSupported

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

```
public WifiPdRangingParams.Builder setResponder80211azNtbSupported (boolean isResponder80211azNtbSupported)
```

Sets whether the responder supports 802.11az NTB.

<br />

| Parameters ||
|---|---|
| `isResponder80211azNtbSupported` | `boolean`: Whether the responder supports 802.11az NTB. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams.Builder` | The builder to facilitate chaining. This value cannot be `null`. <br /> |