QuicOptions.Builder

public QuicOptions.Builder addAllowedQuicHost(String quicHost)

Добавляет хост в список разрешенных хостов QUIC.

Если хосты не указаны, функция добавления хостов в список разрешенных отключается. В противном случае Cronet будет использовать QUIC только при взаимодействии с хостами из списка разрешенных.

@QuicOptions.QuichePassthroughOption
public QuicOptions.Builder addClientConnectionOption(String clientConnectionOption)

Добавляет QUIC-тег для отправки параметров соединения в процессе установления QUIC-соединения, который влияет только на клиентскую часть.

Дополнительные сведения см. в addConnectionOption .

@QuicOptions.QuichePassthroughOption
public QuicOptions.Builder addConnectionOption(String connectionOption)

Добавляет QUIC-тег для отправки параметров соединения в процессе установления соединения QUIC.

Теги QUIC должны быть представлены в виде строк длиной до четырех букв (например, NBHD ).

Поскольку теги QUIC находятся в стадии активной разработки, и некоторые из них актуальны только для сервера, Cronet не пытается поддерживать полный список всех поддерживаемых флагов QUIC в рамках API. Флаги. Флаги, поддерживаемые QUICHE, реализацией QUIC, используемой серверами Cronet и Google, можно найти здесь .

@QuicOptions.QuichePassthroughOption
public QuicOptions.Builder addEnabledQuicVersion(String enabledQuicVersion)

Добавляет версию QUIC в список версий QUIC, которые необходимо включить.

Если версии не указаны, Cronet будет использовать список версий QUIC по умолчанию.

Формат версий определяется системой QUICHE . За исключением фильтрации заведомо устаревших значений, Cronet никак не обрабатывает версии, а просто передает их в QUICHE.

@QuicOptions.QuichePassthroughOption
public QuicOptions.Builder addExtraQuicheFlag(String extraQuicheFlag)

Устанавливает произвольный флаг QUICHE. Флаги следует передавать в формате FLAG_NAME=FLAG_VALUE . Полный список флагов см. в кодовой базе QUICHE .

public QuicOptions build()

Создает и возвращает окончательный экземпляр QuicOptions на основе значений, указанных в этом конструкторе.

@QuicOptions.Experimental
public QuicOptions.Builder closeSessionsOnIpChange(boolean closeSessionsOnIpChange)

Определяет, следует ли закрывать QUIC-сессии при изменении IP-адреса.

Не используйте в сочетании с миграцией соединений (настраивается с помощью ConnectionMigrationOptions ).

@QuicOptions.Experimental
public QuicOptions.Builder delayJobsWithAvailableSpdySession(
    boolean delayJobsWithAvailableSpdySession
)

Определяет, следует ли Cronet ожидать готовности основного пути (обычно QUIC), даже если существует вторичный путь доступа к серверу (SPDY / HTTP2), который готов немедленно.

@QuicOptions.Experimental
public QuicOptions.Builder enableTlsZeroRtt(boolean enableTlsZeroRtt)

Определяет, следует ли включать TLS с 0-RTT.

0-RTT — это оптимизация производительности, позволяющая избежать дополнительного обмена данными при возобновлении соединения с известным сервером.

@QuicOptions.Experimental
public QuicOptions.Builder goawaySessionsOnIpChange(boolean goawaySessionsOnIpChange)

Определяет, следует ли завершать сеансы QUIC при изменении IP-адреса.

Не используйте в сочетании с миграцией соединений (настраивается с помощью ConnectionMigrationOptions ).

@QuicOptions.Experimental
public QuicOptions.Builder increaseBrokenServicePeriodExponentially(
    boolean increaseBrokenServicePeriodExponentially
)

Определяет, следует ли экспоненциально увеличивать период простоя сервера.

Если установлено значение true, начальная задержка (настраиваемая параметром setInitialBrokenServicePeriodSeconds ) будет масштабироваться экспоненциально для последующих попыток ( SCALING_FACTOR^NUM_TRIES * delay ). Если значение false, задержка будет масштабироваться линейно (SCALING_FACTOR * NUM_TRIES * delay).

@QuicOptions.Experimental
public QuicOptions.Builder retryWithoutAltSvcOnQuicErrors(boolean retryWithoutAltSvcOnQuicErrors)

Определяет, следует ли повторять запросы, завершившиеся ошибкой протокола QUIC, без использования каких-либо alt-svc серверов.

@QuicOptions.Experimental
public QuicOptions.Builder setCryptoHandshakeTimeoutSeconds(long cryptoHandshakeTimeoutSeconds)

Устанавливает тайм-аут для установления SSL-соединения.

public QuicOptions.Builder setHandshakeUserAgent(String handshakeUserAgent)

Задает пользовательский агент для использования вне HTTP-запросов (например, для установления соединения QUIC).

Чтобы установить пользовательский агент по умолчанию для HTTP-запросов, используйте вместо этого setUserAgent .

@RequiresApi(value = VERSION_CODES.O)
public QuicOptions.Builder setIdleConnectionTimeout(@NonNull Duration idleConnectionTimeout)

Аналогично setIdleConnectionTimeoutSeconds , но с использованием java.time.Duration .

public QuicOptions.Builder setIdleConnectionTimeoutSeconds(long idleConnectionTimeoutSeconds)

Устанавливает максимальное время простоя для соединения. Фактическое значение таймаута простоя — это минимальное из этого значения и значения сервера, и оно согласовывается во время рукопожатия. Таким образом, оно применяется только после завершения рукопожатия. Если в течение установленного времени на соединении не обнаруживается никакой активности, соединение закрывается.

Более подробная информация приведена в разделе 5.1 RFC 9114 .

public QuicOptions.Builder setInMemoryServerConfigsCacheSize(int inMemoryServerConfigsCacheSize)

Задает количество конфигураций сервера (метаданные, такие как список альтернативных служб, поддержка QUIC и т. д.), которые должны храниться в памяти.

Если задан путь к хранилищу ( setStoragePath , Cronet также сохранит конфигурации сервера на диске.

@QuicOptions.Experimental
public QuicOptions.Builder setInitialBrokenServicePeriodSeconds(
    long initialBrokenServicePeriodSeconds
)

Задает начальное значение, при котором Cronet не должен пытаться использовать QUIC для данного сервера после того, как выяснилось, что поддержка QUIC на этом сервере не работает.

Как только Cronet обнаружит, что сервер рекламирует QUIC, но фактически не использует его, он помечает сервер как неисправный и в течение определенного времени не пытается использовать QUIC при взаимодействии с ним. После истечения этого срока Cronet снова попытается использовать QUIC. Это делается для баланса между краткосрочными (нет смысла тратить ресурсы на попытки использования QUIC, если сервер неисправен) и долгосрочными (неисправность могла быть временной, использование QUIC, как правило, выгодно).

Задержка увеличивается с каждой последующей неудачной попыткой. Подробности см. в increaseBrokenServicePeriodExponentially .

@QuicOptions.Experimental
public QuicOptions.Builder setPreCryptoHandshakeIdleTimeoutSeconds(
    long preCryptoHandshakeIdleTimeoutSeconds
)

Устанавливает максимальное время простоя для соединения, которое еще не завершило SSL-рукопожатие.

@QuicOptions.Experimental
public QuicOptions.Builder setRetransmittableOnWireTimeoutMillis(
    long retransmittableOnWireTimeoutMillis
)

Устанавливает максимально допустимое время между передачей пакетов по сети.

Когда время повторной передачи по сети превышается, Cronet проверяет качество сети с помощью искусственного трафика. Меньшие значения таймаута обычно приводят к более быстрому обнаружению обрыва или ухудшения качества связи, но также и к большему потреблению ресурсов (батареи, данных).