# TelephonyNetworkSpecifier.Builder

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

# Builder

*** ** * ** ***

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

```
class Builder
```

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

Builder to create[TelephonyNetworkSpecifier](https://developer.android.com/reference/kotlin/android/net/TelephonyNetworkSpecifier)object.

## Summary

|                                                       Public constructors                                                       ||
|------------------------------------------------------------------------------------------------------------------------------|---|
| [Builder](https://developer.android.com/reference/kotlin/android/net/TelephonyNetworkSpecifier.Builder#Builder())`()` <br /> |

|                                                                                                                                                                                            Public methods                                                                                                                                                                                             ||
|------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [TelephonyNetworkSpecifier](https://developer.android.com/reference/kotlin/android/net/TelephonyNetworkSpecifier)                  | [build](https://developer.android.com/reference/kotlin/android/net/TelephonyNetworkSpecifier.Builder#build())`()` Create a NetworkSpecifier for the cellular network request.                                                                                     |
| [TelephonyNetworkSpecifier.Builder](https://developer.android.com/reference/kotlin/android/net/TelephonyNetworkSpecifier.Builder#) | [setSubscriptionId](https://developer.android.com/reference/kotlin/android/net/TelephonyNetworkSpecifier.Builder#setSubscriptionId(kotlin.Int))`(`subId:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Set the subscription id. |

## Public constructors

### Builder

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

```
Builder()
```

## Public methods

### build

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

```
fun build(): TelephonyNetworkSpecifier
```

Create a NetworkSpecifier for the cellular network request.

|                                                                                      Return                                                                                      ||
|-------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------|
| [TelephonyNetworkSpecifier](https://developer.android.com/reference/kotlin/android/net/TelephonyNetworkSpecifier) | TelephonyNetworkSpecifier object. This value cannot be`null`. |

|                                                                                                               Exceptions                                                                                                                ||
|--------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `java.lang.IllegalArgumentException` | when subscription Id is not provided through[setSubscriptionId(int)](https://developer.android.com/reference/kotlin/android/net/TelephonyNetworkSpecifier.Builder#setSubscriptionId(kotlin.Int)). |

### setSubscriptionId

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

```
fun setSubscriptionId(subId: Int): TelephonyNetworkSpecifier.Builder
```

Set the subscription id.

|                                                Parameters                                                ||
|---------|-------------------------------------------------------------------------------------------------|
| `subId` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):The subscription Id. |

|                                                                                                                                                              Return                                                                                                                                                              ||
|------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [TelephonyNetworkSpecifier.Builder](https://developer.android.com/reference/kotlin/android/net/TelephonyNetworkSpecifier.Builder#) | Instance of[Builder](https://developer.android.com/reference/kotlin/android/net/TelephonyNetworkSpecifier.Builder#)to enable the chaining of the builder method. This value cannot be`null`. |