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

# DeviceHandle.Builder

*** ** * ** ***


`
public
static
final

class
DeviceHandle.Builder
`


`

extends https://developer.android.com/reference/java/lang/Object


`

`


`

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

<br />

*** ** * ** ***

Builder class for creating instances of `https://developer.android.com/reference/android/ranging/oob/DeviceHandle`.

## Summary

| ### Public constructors ||
|---|---|
| ` https://developer.android.com/reference/android/ranging/oob/DeviceHandle.Builder#Builder(android.ranging.RangingDevice,%20android.ranging.oob.TransportHandle)(https://developer.android.com/reference/android/ranging/RangingDevice rangingDevice, https://developer.android.com/reference/android/ranging/oob/TransportHandle transportHandle) ` Constructs a new `https://developer.android.com/reference/android/ranging/oob/DeviceHandle.Builder` with the required `https://developer.android.com/reference/android/ranging/RangingDevice` and `https://developer.android.com/reference/android/ranging/oob/TransportHandle`. |

| ### Public methods ||
|---|---|
| ` https://developer.android.com/reference/android/ranging/oob/DeviceHandle` | ` https://developer.android.com/reference/android/ranging/oob/DeviceHandle.Builder#build()() ` Builds and returns a new `https://developer.android.com/reference/android/ranging/oob/DeviceHandle` instance using the parameters provided to this builder. |
| ` https://developer.android.com/reference/android/ranging/oob/DeviceHandle.Builder` | ` https://developer.android.com/reference/android/ranging/oob/DeviceHandle.Builder#setBluetoothDevice(android.bluetooth.BluetoothDevice)(https://developer.android.com/reference/android/bluetooth/BluetoothDevice bluetoothDevice) ` Sets the `https://developer.android.com/reference/android/bluetooth/BluetoothDevice` associated with the target device. |

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

```
public Builder (RangingDevice rangingDevice, 
                TransportHandle transportHandle)
```

Constructs a new `https://developer.android.com/reference/android/ranging/oob/DeviceHandle.Builder` with the required `https://developer.android.com/reference/android/ranging/RangingDevice`
and `https://developer.android.com/reference/android/ranging/oob/TransportHandle`.

<br />

| Parameters ||
|---|---|
| `rangingDevice` | `RangingDevice`: the `https://developer.android.com/reference/android/ranging/RangingDevice` This value cannot be `null`. <br /> |
| `transportHandle` | `TransportHandle`: Implementation of `https://developer.android.com/reference/android/ranging/oob/TransportHandle` for sending/receiving OOB data from peer. This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/NullPointerException` | if either parameter is `null`. |

## Public methods

### build

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

```
public DeviceHandle build ()
```

Builds and returns a new `https://developer.android.com/reference/android/ranging/oob/DeviceHandle` instance using the
parameters provided to this builder.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/ranging/oob/DeviceHandle` | a newly created `https://developer.android.com/reference/android/ranging/oob/DeviceHandle` instance. This value cannot be `null`. <br /> |

### setBluetoothDevice

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

```
public DeviceHandle.Builder setBluetoothDevice (BluetoothDevice bluetoothDevice)
```

Sets the `https://developer.android.com/reference/android/bluetooth/BluetoothDevice` associated with the target device. If this is set,
the underlying ranging service will use the bluetooth device as the target for
BLE RSSI and Channel Sounding ranging.

<br />

| Parameters ||
|---|---|
| `bluetoothDevice` | `BluetoothDevice`: the `https://developer.android.com/reference/android/bluetooth/BluetoothDevice` This value cannot be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/ranging/oob/DeviceHandle.Builder` | the same `https://developer.android.com/reference/android/ranging/oob/DeviceHandle.Builder` instance. This value cannot be `null`. <br /> |