QuicOptions.Builder

public QuicOptions.Builder addAllowedQuicHost(String quicHost)

Dodaje hosta do listy dozwolonych QUIC.

Jeśli nie określono żadnych hostów, funkcja listy dozwolonych dla poszczególnych hostów jest wyłączona. W przeciwnym razie Cronet będzie używać QUIC tylko w przypadku komunikacji z hostami na liście dozwolonych.

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

Dodaje tag QUIC do wysłania w opcjach połączenia uzgadniania QUIC, który ma wpływ tylko na klienta.

Więcej informacji znajdziesz w sekcji addConnectionOption.

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

Dodaje tag QUIC do wysłania w opcjach połączenia uzgadniania QUIC.

Tagi QUIC powinny być ciągami znaków o długości do 4 liter (np. NBHD).

Tagi QUIC są w trakcie aktywnego rozwoju, a niektóre z nich są istotne tylko dla serwera, dlatego Cronet nie próbuje utrzymywać pełnej listy wszystkich obsługiwanych flag QUIC w ramach interfejsu API. flagi, Flagi obsługiwane przez QUICHE, implementację QUIC używaną przez Cronet i serwery Google, znajdziesz tutaj.

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

Dodaje wersję QUIC do listy wersji QUIC do włączenia.

Jeśli nie określisz wersji, Cronet użyje listy domyślnych wersji QUIC.

Format wersji jest określony przez QUICHE. Poza odfiltrowywaniem wartości, które są już nieaktualne, Cronet nie przetwarza wersji i po prostu przekazuje je do QUICHE.

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

Ustawia dowolną flagę QUICHE. Flagi należy przekazywać w formacie FLAG_NAME=FLAG_VALUE. Pełną listę flag znajdziesz w bazie kodu QUICHE.

public QuicOptions build()

Tworzy i zwraca ostateczną instancję QuicOptions na podstawie wartości w tym konstruktorze.

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

Określa, czy sesje QUIC mają być zamykane w przypadku zmiany adresu IP.

Nie używaj w połączeniu z migracją połączenia (skonfigurowaną za pomocą argumentu ConnectionMigrationOptions).

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

Określa, czy Cronet ma czekać na gotowość ścieżki podstawowej (zwykle QUIC), nawet jeśli istnieje ścieżka dodatkowa do serwera (SPDY / HTTP2), która jest od razu gotowa.

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

Określa, czy protokół TLS z 0-RTT ma być włączony.

0-RTT to optymalizacja wydajności, która pozwala uniknąć dodatkowej odpowiedzi serwera podczas wznawiania połączeń ze znanym serwerem.

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

Określa, czy sesje QUIC powinny być zamykane w przypadku zmiany adresu IP.

Nie używaj w połączeniu z migracją połączenia (skonfigurowaną za pomocą argumentu ConnectionMigrationOptions).

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

Określa, czy okres niedostępności serwera powinien być skalowany wykładniczo.

Jeśli ta opcja ma wartość „true”, początkowe opóźnienie (konfigurowane za pomocą parametru setInitialBrokenServicePeriodSeconds) będzie skalowane wykładniczo w przypadku kolejnych ponownych prób (SCALING_FACTOR^NUM_TRIES * delay). Jeśli ta opcja ma wartość „false”, opóźnienie będzie skalowane liniowo (CZYNNIK_SKALOWANIA * LICZBA_PRÓB * opóźnienie).

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

Określa, czy żądania, które nie powiodły się z powodu błędów protokołu QUIC, mają być ponawiane bez użycia serwerów alt-svc.

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

Ustawia limit czasu inicjowania połączenia SSL.

public QuicOptions.Builder setHandshakeUserAgent(String handshakeUserAgent)

Ustawia klienta użytkownika, który ma być używany poza żądaniami HTTP (np. w przypadku uzgadniania połączenia QUIC).

Aby ustawić domyślnego klienta użytkownika dla żądań HTTP, użyj zamiast tego setUserAgent.

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

Takie samo jak setIdleConnectionTimeoutSeconds, ale z użyciem java.time.Duration.

public QuicOptions.Builder setIdleConnectionTimeoutSeconds(long idleConnectionTimeoutSeconds)

Ustawia maksymalny czas bezczynności połączenia. Rzeczywista wartość limitu czasu bezczynności jest mniejszą z 2 wartości: tej wartości i wartości serwera. Jest ona negocjowana podczas uzgadniania połączenia. Dlatego ma zastosowanie dopiero po zakończeniu uzgadniania. Jeśli w określonym czasie nie zostanie wykryta żadna aktywność, połączenie zostanie zamknięte.

Więcej informacji znajdziesz w RFC 9114, sekcja 5.1 .

public QuicOptions.Builder setInMemoryServerConfigsCacheSize(int inMemoryServerConfigsCacheSize)

Określa, ile konfiguracji serwera (metadane, takie jak lista alt svc, informacja o obsłudze QUIC itp.) ma być przechowywanych w pamięci.

Jeśli ścieżka do miejsca na dane jest ustawiona (setStoragePath), Cronet będzie też zapisywać konfiguracje serwera na dysku.

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

Ustawia początkowy czas, po którym Cronet nie powinien próbować używać protokołu QUIC w przypadku danego serwera, jeśli okaże się, że obsługa QUIC przez serwer jest uszkodzona.

Gdy Cronet wykryje, że serwer reklamuje QUIC, ale w rzeczywistości go nie obsługuje, oznacza go jako uszkodzony i przez pewien czas nie próbuje używać QUIC w komunikacji z nim. Gdy Cronet przekroczy ten punkt, ponownie spróbuje użyć QUIC. Ma to na celu zrównoważenie interesów krótkoterminowych (nie ma sensu marnować zasobów na próby użycia QUIC, jeśli serwer jest uszkodzony) i długoterminowych (uszkodzenie mogło być tymczasowe, a korzystanie z QUIC jest ogólnie korzystne).

Opóźnienie jest zwiększane po każdej nieudanej próbie ponowienia. Aby dowiedzieć się więcej, wejdź na increaseBrokenServicePeriodExponentially.

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

Określa maksymalny czas bezczynności połączenia, które nie zostało jeszcze w pełni uzgodnione w ramach protokołu SSL.

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

Określa maksymalny pożądany czas między pakietami w sieci.

Gdy czas ponownej transmisji w sieci przewodowej zostanie przekroczony, Cronet sprawdzi jakość sieci za pomocą sztucznego ruchu. Krótsze limity czasu zwykle przyspieszają wykrywanie uszkodzonych lub pogarszających się ścieżek, ale też zwiększają zużycie zasobów (baterii, danych).