# DeviceHandle.Builder

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

# Builder

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/android/ranging/oob/DeviceHandle.Builder "View this page in Java")  

```
class Builder
```

|---|--------------------------------------------------------------------------------------------------------------------------------------|
| [kotlin.Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html)                                                       ||
| ↳ | [android.ranging.oob.DeviceHandle.Builder](https://developer.android.com/reference/kotlin/android/ranging/oob/DeviceHandle.Builder#) |

Builder class for creating instances of[DeviceHandle](https://developer.android.com/reference/kotlin/android/ranging/oob/DeviceHandle).

## Summary

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

|                                                                                                                                                                                        Public methods                                                                                                                                                                                        ||
|-------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [DeviceHandle](https://developer.android.com/reference/kotlin/android/ranging/oob/DeviceHandle) | [build](https://developer.android.com/reference/kotlin/android/ranging/oob/DeviceHandle.Builder#build())`()` Builds and returns a new[DeviceHandle](https://developer.android.com/reference/kotlin/android/ranging/oob/DeviceHandle)instance using the parameters provided to this builder. |

## Public constructors

### Builder

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

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

Constructs a new[Builder](https://developer.android.com/reference/kotlin/android/ranging/oob/DeviceHandle.Builder#)with the required[RangingDevice](https://developer.android.com/reference/kotlin/android/ranging/RangingDevice.html#)and[TransportHandle](https://developer.android.com/reference/kotlin/android/ranging/oob/TransportHandle).

|                                                                                                                                                     Parameters                                                                                                                                                      ||
|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `rangingDevice`   | [RangingDevice](https://developer.android.com/reference/kotlin/android/ranging/RangingDevice.html#):the[RangingDevice](https://developer.android.com/reference/kotlin/android/ranging/RangingDevice.html#)This value cannot be`null`.                                                            |
| `transportHandle` | [TransportHandle](https://developer.android.com/reference/kotlin/android/ranging/oob/TransportHandle):Implementation of[TransportHandle](https://developer.android.com/reference/kotlin/android/ranging/oob/TransportHandle)for sending/receiving OOB data from peer This value cannot be`null`. |

|                           Exceptions                            ||
|----------------------------------|-------------------------------|
| `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.html#ApiLevels)  

```
fun build(): DeviceHandle
```

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

|                                                                                                                        Return                                                                                                                        ||
|-------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|
| [DeviceHandle](https://developer.android.com/reference/kotlin/android/ranging/oob/DeviceHandle) | a newly created[DeviceHandle](https://developer.android.com/reference/kotlin/android/ranging/oob/DeviceHandle)instance. This value cannot be`null`. |