QuicOptions.Builder

public QuicOptions.Builder addAllowedQuicHost(String quicHost)

QUIC izin verilenler listesine bir ana makine ekler.

Ana makine belirtilmemişse ana makine başına izin verilenler listesi işlevi devre dışı bırakılır. Aksi takdirde Cronet, yalnızca izin verilenler listesindeki ana makinelerle iletişim kurarken QUIC'i kullanır.

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

Yalnızca istemciyi etkileyen bir QUIC el sıkışması bağlantı seçeneklerinde gönderilecek bir QUIC etiketi ekler.

Daha fazla bilgi için addConnectionOption sayfasına bakın.

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

QUIC el sıkışması bağlantı seçeneklerinde gönderilecek bir QUIC etiketi ekler.

QUIC etiketleri, en fazla dört harf uzunluğunda dizeler (ör. NBHD) olarak sunulmalıdır.

QUIC etiketleri aktif olarak geliştirilmekte olduğundan ve bazıları yalnızca sunucuyla alakalı olduğundan Cronet, API'nin bir parçası olarak desteklenen tüm QUIC işaretlerinin tam listesini tutmaya çalışmaz. Bayraklar. Cronet ve Google sunucuları tarafından kullanılan bir QUIC uygulaması olan QUICHE'nin desteklediği işaretleri burada bulabilirsiniz.

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

Etkinleştirilecek QUIC sürümleri listesine bir QUIC sürümü ekler.

Sürüm belirtilmezse Cronet, varsayılan QUIC sürümlerinin bir listesini kullanır.

Sürüm biçimi QUICHE tarafından belirtilir. Cronet, eski olduğu bilinen değerleri filtrelemenin dışında sürümleri herhangi bir şekilde işlemez ve bunları doğrudan QUICHE'ye iletir.

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

İsteğe bağlı bir QUICHE işareti ayarlar. İşaretler, FLAG_NAME=FLAG_VALUE biçiminde iletilmelidir. Tüm işaretlerin listesi için QUICHE kod tabanına bakın.

public QuicOptions build()

Bu oluşturucudaki değerlere göre son QuicOptions örneğini oluşturur ve döndürür.

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

IP adresi değiştiğinde QUIC oturumlarının kapatılıp kapatılmayacağını ayarlar.

Bağlantı taşıma işlemiyle (ConnectionMigrationOptions kullanılarak yapılandırılır) birlikte kullanmayın.

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

Cronet'in, sunucuya ulaşmak için ikincil bir yol (SPDY / HTTP2) olsa bile birincil yolun (genellikle QUIC) hazır olmasını beklemesi gerekip gerekmediğini belirler.

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

0-RTT ile TLS'nin etkinleştirilip etkinleştirilmeyeceğini belirler.

0-RTT, bilinen bir sunucuya bağlantılar sürdürüldüğünde ek bir gidiş-dönüşü önleyen bir performans optimizasyonudur.

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

IP adresi değiştiğinde QUIC oturumlarının kapatılıp kapatılmayacağını ayarlar.

Bağlantı taşıma işlemiyle (ConnectionMigrationOptions kullanılarak yapılandırılır) birlikte kullanmayın.

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

Bozuk sunucu döneminin üstel olarak ölçeklendirilip ölçeklendirilmeyeceğini ayarlar.

Doğru olarak ayarlanırsa ilk gecikme (setInitialBrokenServicePeriodSeconds ile yapılandırılabilir) sonraki yeniden denemeler için üstel olarak ölçeklendirilir (SCALING_FACTOR^NUM_TRIES * delay). Yanlış ise gecikme doğrusal olarak ölçeklendirilir (SCALING_FACTOR * NUM_TRIES * gecikme).

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

QUIC protokolü hatalarıyla başarısız olan isteklerin herhangi bir alt-svc sunucusu kullanılmadan yeniden denenip denenmeyeceğini ayarlar.

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

Bağlantı SSL el sıkışması için zaman aşımını ayarlar.

public QuicOptions.Builder setHandshakeUserAgent(String handshakeUserAgent)

Kullanıcı aracısını HTTP isteklerinin dışında (ör. QUIC el sıkışmaları için) kullanılacak şekilde ayarlar.

HTTP istekleri için varsayılan kullanıcı aracısını ayarlamak üzere bunun yerine setUserAgent kullanın.

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

setIdleConnectionTimeoutSeconds ile aynıdır ancak java.time.Duration kullanılır.

public QuicOptions.Builder setIdleConnectionTimeoutSeconds(long idleConnectionTimeoutSeconds)

Bağlantı için maksimum boşta kalma süresini ayarlar. Boşta kalma zaman aşımı için gerçek değer, bu değer ile sunucunun minimum değeridir ve el sıkışma sırasında belirlenir. Bu nedenle, yalnızca el sıkışma tamamlandıktan sonra geçerlidir. Bağlantıda belirlenen süre boyunca etkinlik algılanmazsa bağlantı kapatılır.

Daha fazla bilgi için RFC 9114, bölüm 5.1 'i inceleyin.

public QuicOptions.Builder setInMemoryServerConfigsCacheSize(int inMemoryServerConfigsCacheSize)

Bellekte kaç sunucu yapılandırmasının (alt svc listesi, QUIC'in desteklenip desteklenmediği gibi meta veriler) tutulacağını ayarlar.

Depolama yolu ayarlanmışsa (setStoragePath), Cronet sunucu yapılandırmalarını da diskte kalıcı hale getirir.

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

Sunucunun QUIC desteğinin bozuk olduğu anlaşıldıktan sonra Cronet'in belirli bir sunucu için QUIC kullanmayı denememesi gereken başlangıç zamanını ayarlar.

Cronet, bir sunucunun QUIC'i desteklediğini duyurduğunu ancak aslında QUIC kullanmadığını algıladığında sunucuyu bozuk olarak işaretler ve bir süre boyunca sunucuyla iletişim kurarken QUIC kullanmaya çalışmaz. Cronet bu noktayı geçtikten sonra QUIC'i tekrar kullanmayı dener. Bunun amacı, kısa vadeli (sunucu bozuksa QUIC'i denemek için kaynakları boşa harcamanın bir anlamı yoktur) ve uzun vadeli (bozulma geçici olabilir, QUIC kullanmak genellikle faydalıdır) çıkarları dengelemektir.

Gecikme, her başarısız yeniden denemede artırılır. Ayrıntılar için increaseBrokenServicePeriodExponentially sayfasını ziyaret edin.

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

Henüz SSL el sıkışma işlemini tamamlamamış bir bağlantı için maksimum boşta kalma süresini ayarlar.

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

Kablodaki paketler arasında istenen maksimum süreyi ayarlar.

Kabloda yeniden iletilebilir süre aşıldığında Cronet, yapay trafik kullanarak ağın kalitesini araştırır. Daha kısa zaman aşımları genellikle bozuk veya performans düşüşü yaşayan bir yolun daha hızlı bulunmasını sağlar ancak kaynakların (pil, veri) daha fazla kullanılmasına da neden olur.