# QuicOptions.Builder


```
class QuicOptions.Builder
```

<br />

*** ** * ** ***

Builder for `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions`.

## Summary

| ### Public functions |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder#addAllowedQuicHost(java.lang.String)(quicHost: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!)` Adds a host to the QUIC allowlist. |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | `@https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.QuichePassthroughOption https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder#addClientConnectionOption(java.lang.String)(clientConnectionOption: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!)` Adds a QUIC tag to send in a QUIC handshake's connection options that only affects the client. |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | `@https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.QuichePassthroughOption https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder#addConnectionOption(java.lang.String)(connectionOption: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!)` Adds a QUIC tag to send in a QUIC handshake's connection options. |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | `@https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.QuichePassthroughOption https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder#addEnabledQuicVersion(java.lang.String)(enabledQuicVersion: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!)` Adds a QUIC version to the list of QUIC versions to enable. |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | `@https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.QuichePassthroughOption https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder#addExtraQuicheFlag(java.lang.String)(extraQuicheFlag: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!)` Sets an arbitrary QUICHE flag. |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions!` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder#build()()` Creates and returns the final `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions` instance, based on the values in this builder. |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | `@https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Experimental https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder#closeSessionsOnIpChange(boolean)(closeSessionsOnIpChange: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)` Sets whether QUIC sessions should be closed on IP address change. |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | `@https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Experimental https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder#delayJobsWithAvailableSpdySession(boolean)( delayJobsWithAvailableSpdySession: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html )` Sets whether Cronet should wait for the primary path (usually QUIC) to be ready even if there's a secondary path of reaching the server (SPDY / HTTP2) which is ready immediately. |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | `@https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Experimental https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder#enableTlsZeroRtt(boolean)(enableTlsZeroRtt: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)` Sets whether TLS with 0-RTT should be enabled. |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | `@https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Experimental https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder#goawaySessionsOnIpChange(boolean)(goawaySessionsOnIpChange: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)` Sets whether QUIC sessions should be goaway'd on IP address change. |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | `@https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Experimental https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder#increaseBrokenServicePeriodExponentially(boolean)( increaseBrokenServicePeriodExponentially: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html )` Sets whether the broken server period should scale exponentially. |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | `@https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Experimental https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder#retryWithoutAltSvcOnQuicErrors(boolean)(retryWithoutAltSvcOnQuicErrors: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)` Sets whether requests that failed with a QUIC protocol errors should be retried without using any `alt-svc` servers. |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | `@https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Experimental https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder#setCryptoHandshakeTimeoutSeconds(long)(cryptoHandshakeTimeoutSeconds: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)` Sets the timeout for a connection SSL handshake. |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder#setHandshakeUserAgent(java.lang.String)(handshakeUserAgent: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!)` Sets the user agent to be used outside of HTTP requests (for example for QUIC handshakes). |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | `@https://developer.android.com/reference/androidx/annotation/RequiresApi.html(value = https://developer.android.com/reference/android/os/VERSION_CODES.html#O) https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder#setIdleConnectionTimeout(java.time.Duration)(idleConnectionTimeout: https://developer.android.com/reference/java/time/Duration.html)` Same as `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder#setIdleConnectionTimeoutSeconds(long)` but using `https://developer.android.com/reference/java/time/Duration.html`. |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder#setIdleConnectionTimeoutSeconds(long)(idleConnectionTimeoutSeconds: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)` Sets the maximum idle time for a connection. |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder#setInMemoryServerConfigsCacheSize(int)(inMemoryServerConfigsCacheSize: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)` Sets how many server configurations (metadata like list of alt svc, whether QUIC is supported, etc.) should be held in memory. |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | `@https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Experimental https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder#setInitialBrokenServicePeriodSeconds(long)( initialBrokenServicePeriodSeconds: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html )` Sets the initial for which Cronet shouldn't attempt to use QUIC for a given server after the server's QUIC support turned out to be broken. |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | `@https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Experimental https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder#setPreCryptoHandshakeIdleTimeoutSeconds(long)( preCryptoHandshakeIdleTimeoutSeconds: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html )` Sets the maximum idle time for a connection which hasn't completed a SSL handshake yet. |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | `@https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Experimental https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder#setRetransmittableOnWireTimeoutMillis(long)( retransmittableOnWireTimeoutMillis: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html )` Sets the maximum desired time between packets on wire. |

## Public functions

### addAllowedQuicHost

```
fun addAllowedQuicHost(quicHost: String!): QuicOptions.Builder!
```

Adds a host to the QUIC allowlist.

If no hosts are specified, the per-host allowlist functionality is disabled. Otherwise, Cronet will only use QUIC when talking to hosts on the allowlist.

| Returns |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | the builder for chaining |

### addClientConnectionOption

```
@QuicOptions.QuichePassthroughOption
fun addClientConnectionOption(clientConnectionOption: String!): QuicOptions.Builder!
```

Adds a QUIC tag to send in a QUIC handshake's connection options that only affects the client.

See `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder#addConnectionOption(java.lang.String)` for more details.

### addConnectionOption

```
@QuicOptions.QuichePassthroughOption
fun addConnectionOption(connectionOption: String!): QuicOptions.Builder!
```

Adds a QUIC tag to send in a QUIC handshake's connection options.

The QUIC tags should be presented as strings up to four letters long (for instance, `NBHD`).

As the QUIC tags are under active development and some are only relevant to the server, Cronet doesn't attempt to maintain a complete list of all supported QUIC flags as a part of the API. The flags. Flags supported by QUICHE, a QUIC implementation used by Cronet and Google servers, can be found [here](https://github.com/google/quiche/blob/main/quiche/quic/core/crypto/crypto_protocol.h").

| Returns |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | the builder for chaining |

### addEnabledQuicVersion

```
@QuicOptions.QuichePassthroughOption
fun addEnabledQuicVersion(enabledQuicVersion: String!): QuicOptions.Builder!
```

Adds a QUIC version to the list of QUIC versions to enable.

If no versions are specified, Cronet will use a list of default QUIC versions.

The version format is specified by [QUICHE](https://github.com/google/quiche/blob/main/quiche/quic/core/quic_versions.cc#L344). Outside of filtering out values known to be obsolete, Cronet doesn't process the versions anyhow and simply passes them along to QUICHE.

| Returns |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | the builder for chaining |

### addExtraQuicheFlag

```
@QuicOptions.QuichePassthroughOption
fun addExtraQuicheFlag(extraQuicheFlag: String!): QuicOptions.Builder!
```

Sets an arbitrary QUICHE flag. Flags should be passed in `FLAG_NAME=FLAG_VALUE` format. See the [QUICHE code base](https://github.com/google/quiche/) for a full list of flags.

| Returns |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | the builder for chaining |

### build

```
fun build(): QuicOptions!
```

Creates and returns the final `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions` instance, based on the values in this builder.

### closeSessionsOnIpChange

```
@QuicOptions.Experimental
fun closeSessionsOnIpChange(closeSessionsOnIpChange: Boolean): QuicOptions.Builder!
```

Sets whether QUIC sessions should be closed on IP address change.

Don't use in combination with connection migration (configured using `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/ConnectionMigrationOptions`).

| Returns |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | the builder for chaining |

### delayJobsWithAvailableSpdySession

```
@QuicOptions.Experimental
fun delayJobsWithAvailableSpdySession(
    delayJobsWithAvailableSpdySession: Boolean
): QuicOptions.Builder!
```

Sets whether Cronet should wait for the primary path (usually QUIC) to be ready even if there's a secondary path of reaching the server (SPDY / HTTP2) which is ready immediately.

| Returns |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | the builder for chaining |

### enableTlsZeroRtt

```
@QuicOptions.Experimental
fun enableTlsZeroRtt(enableTlsZeroRtt: Boolean): QuicOptions.Builder!
```

Sets whether TLS with 0-RTT should be enabled.

0-RTT is a performance optimization avoiding an extra round trip when resuming connections to a known server.

| Returns |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | the builder for chaining |

| See also |
|---|---|
| `https://blog.cloudflare.com/introducing-0-rtt/` | [Cloudflare's 0-RTT blogpost](https://blog.cloudflare.com/introducing-0-rtt/) |

### goawaySessionsOnIpChange

```
@QuicOptions.Experimental
fun goawaySessionsOnIpChange(goawaySessionsOnIpChange: Boolean): QuicOptions.Builder!
```

Sets whether QUIC sessions should be goaway'd on IP address change.

Don't use in combination with connection migration (configured using `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/ConnectionMigrationOptions`).

| Returns |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | the builder for chaining |

### increaseBrokenServicePeriodExponentially

```
@QuicOptions.Experimental
fun increaseBrokenServicePeriodExponentially(
    increaseBrokenServicePeriodExponentially: Boolean
): QuicOptions.Builder!
```

Sets whether the broken server period should scale exponentially.

If set to true, the initial delay (configurable by `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder#setInitialBrokenServicePeriodSeconds(long)`) will be scaled exponentially for subsequent retries (`SCALING_FACTOR^NUM_TRIES * delay`). If false, the delay will scale linearly (SCALING_FACTOR \* NUM_TRIES \* delay).

| Returns |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | the builder for chaining |

### retryWithoutAltSvcOnQuicErrors

```
@QuicOptions.Experimental
fun retryWithoutAltSvcOnQuicErrors(retryWithoutAltSvcOnQuicErrors: Boolean): QuicOptions.Builder!
```

Sets whether requests that failed with a QUIC protocol errors should be retried without using any `alt-svc` servers.

| Returns |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | the builder for chaining |

### setCryptoHandshakeTimeoutSeconds

```
@QuicOptions.Experimental
fun setCryptoHandshakeTimeoutSeconds(cryptoHandshakeTimeoutSeconds: Long): QuicOptions.Builder!
```

Sets the timeout for a connection SSL handshake.

| Returns |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | the builder for chaining |

### setHandshakeUserAgent

```
fun setHandshakeUserAgent(handshakeUserAgent: String!): QuicOptions.Builder!
```

Sets the user agent to be used outside of HTTP requests (for example for QUIC handshakes).

To set the default user agent for HTTP requests, use `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetEngine.Builder#setUserAgent(java.lang.String)` instead.

| Returns |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | the builder for chaining |

### setIdleConnectionTimeout

```
@RequiresApi(value = VERSION_CODES.O)
fun setIdleConnectionTimeout(idleConnectionTimeout: Duration): QuicOptions.Builder!
```

Same as `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder#setIdleConnectionTimeoutSeconds(long)` but using `https://developer.android.com/reference/java/time/Duration.html`.

| Returns |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | the builder for chaining |

### setIdleConnectionTimeoutSeconds

```
fun setIdleConnectionTimeoutSeconds(idleConnectionTimeoutSeconds: Long): QuicOptions.Builder!
```

Sets the maximum idle time for a connection. The actual value for the idle timeout is the minimum of this value and the server's and is negotiated during the handshake. Thus, it only applies after the handshake has completed. If no activity is detected on the connection for the set duration, the connection is closed.

See [RFC 9114, section 5.1](https://www.rfc-editor.org/rfc/rfc9114.html#name-idle-connections) for more details.

| Returns |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | the builder for chaining |

### setInMemoryServerConfigsCacheSize

```
fun setInMemoryServerConfigsCacheSize(inMemoryServerConfigsCacheSize: Int): QuicOptions.Builder!
```

Sets how many server configurations (metadata like list of alt svc, whether QUIC is supported, etc.) should be held in memory.

If the storage path is set (`https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetEngine.Builder#setStoragePath(java.lang.String)`, Cronet will also persist the server configurations on disk.

| Returns |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | the builder for chaining |

### setInitialBrokenServicePeriodSeconds

```
@QuicOptions.Experimental
fun setInitialBrokenServicePeriodSeconds(
    initialBrokenServicePeriodSeconds: Long
): QuicOptions.Builder!
```

Sets the initial for which Cronet shouldn't attempt to use QUIC for a given server after the server's QUIC support turned out to be broken.

Once Cronet detects that a server advertises QUIC but doesn't actually speak it, it marks the server as broken and doesn't attempt to use QUIC when talking to the server for an amount of time. Once Cronet is past this point it will try using QUIC again. This is to balance short term (there's no point wasting resources to try QUIC if the server is broken) and long term (the breakage might have been temporary, using QUIC is generally beneficial) interests.

The delay is increased every unsuccessful consecutive retry. See `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder#increaseBrokenServicePeriodExponentially(boolean)` for details.

| Returns |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | the builder for chaining |

### setPreCryptoHandshakeIdleTimeoutSeconds

```
@QuicOptions.Experimental
fun setPreCryptoHandshakeIdleTimeoutSeconds(
    preCryptoHandshakeIdleTimeoutSeconds: Long
): QuicOptions.Builder!
```

Sets the maximum idle time for a connection which hasn't completed a SSL handshake yet.

| Returns |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | the builder for chaining |

### setRetransmittableOnWireTimeoutMillis

```
@QuicOptions.Experimental
fun setRetransmittableOnWireTimeoutMillis(
    retransmittableOnWireTimeoutMillis: Long
): QuicOptions.Builder!
```

Sets the maximum desired time between packets on wire.

When the retransmittable-on-wire time is exceeded Cronet will probe quality of the network using artificial traffic. Smaller timeouts will typically result in faster discovery of a broken or degrading path, but also larger usage of resources (battery, data).

| Returns |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/QuicOptions.Builder!` | the builder for chaining |