QuicOptions.Builder

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

Menambahkan host ke daftar yang diizinkan QUIC.

Jika tidak ada host yang ditentukan, fungsi daftar yang diizinkan per host akan dinonaktifkan. Jika tidak, Cronet hanya akan menggunakan QUIC saat berkomunikasi dengan host dalam daftar yang diizinkan.

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

Menambahkan tag QUIC untuk dikirim dalam opsi koneksi handshake QUIC yang hanya memengaruhi klien.

Lihat addConnectionOption untuk mengetahui detail selengkapnya.

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

Menambahkan tag QUIC untuk dikirim dalam opsi koneksi handshake QUIC.

Tag QUIC harus ditampilkan sebagai string dengan panjang maksimal empat huruf (misalnya, NBHD).

Karena tag QUIC sedang dalam pengembangan aktif dan beberapa hanya relevan dengan server, Cronet tidak berupaya mempertahankan daftar lengkap semua tanda QUIC yang didukung sebagai bagian dari API. Flag. Flag yang didukung oleh QUICHE, penerapan QUIC yang digunakan oleh server Cronet dan Google, dapat ditemukan di sini.

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

Menambahkan versi QUIC ke daftar versi QUIC yang akan diaktifkan.

Jika tidak ada versi yang ditentukan, Cronet akan menggunakan daftar versi QUIC default.

Format versi ditentukan oleh QUICHE. Selain memfilter nilai yang diketahui sudah tidak berlaku, Cronet tidak memproses versi tersebut dan hanya meneruskannya ke QUICHE.

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

Menetapkan tanda QUICHE arbitrer. Flag harus diteruskan dalam format FLAG_NAME=FLAG_VALUE. Lihat basis kode QUICHE untuk mengetahui daftar lengkap flag.

fun build(): QuicOptions!

Membuat dan menampilkan instance QuicOptions akhir, berdasarkan nilai dalam builder ini.

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

Menetapkan apakah sesi QUIC harus ditutup saat alamat IP berubah.

Jangan gunakan bersama dengan migrasi koneksi (dikonfigurasi menggunakan ConnectionMigrationOptions).

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

Menetapkan apakah Cronet harus menunggu jalur utama (biasanya QUIC) siap meskipun ada jalur sekunder untuk menjangkau server (SPDY / HTTP2) yang langsung siap.

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

Menetapkan apakah TLS dengan 0-RTT harus diaktifkan.

0-RTT adalah pengoptimalan performa yang menghindari perjalanan pulang pergi tambahan saat melanjutkan koneksi ke server yang dikenal.

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

Menetapkan apakah sesi QUIC harus dihentikan saat alamat IP berubah.

Jangan gunakan bersama dengan migrasi koneksi (dikonfigurasi menggunakan ConnectionMigrationOptions).

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

Menetapkan apakah periode server yang rusak harus diskalakan secara eksponensial.

Jika ditetapkan ke benar (true), penundaan awal (dapat dikonfigurasi oleh setInitialBrokenServicePeriodSeconds) akan diskalakan secara eksponensial untuk percobaan ulang berikutnya (SCALING_FACTOR^NUM_TRIES * delay). Jika salah (false), penundaan akan diskalakan secara linear (SCALING_FACTOR * NUM_TRIES * delay).

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

Menetapkan apakah permintaan yang gagal dengan error protokol QUIC harus dicoba lagi tanpa menggunakan server alt-svc.

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

Menetapkan waktu tunggu untuk handshake SSL koneksi.

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

Menetapkan agen pengguna yang akan digunakan di luar permintaan HTTP (misalnya untuk handshake QUIC).

Untuk menyetel agen pengguna default untuk permintaan HTTP, gunakan setUserAgent.

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

Sama seperti setIdleConnectionTimeoutSeconds, tetapi menggunakan java.time.Duration.

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

Menetapkan waktu tidak ada aktivitas maksimum untuk koneksi. Nilai sebenarnya untuk waktu tunggu tidak ada aktivitas adalah nilai minimum dari nilai ini dan server, serta dinegosiasikan selama handshake. Oleh karena itu, hanya berlaku setelah handshake selesai. Jika tidak ada aktivitas yang terdeteksi pada koneksi selama durasi yang ditetapkan, koneksi akan ditutup.

Lihat RFC 9114, bagian 5.1 untuk mengetahui detail selengkapnya.

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

Menetapkan jumlah konfigurasi server (metadata seperti daftar alt svc, apakah QUIC didukung, dll.) yang harus disimpan dalam memori.

Jika jalur penyimpanan disetel (setStoragePath, Cronet juga akan menyimpan konfigurasi server di disk.

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

Menetapkan awal Cronet tidak boleh mencoba menggunakan QUIC untuk server tertentu setelah dukungan QUIC server tersebut ternyata rusak.

Setelah mendeteksi bahwa server mengiklankan QUIC, tetapi sebenarnya tidak menggunakannya, Cronet akan menandai server sebagai rusak dan tidak mencoba menggunakan QUIC saat berkomunikasi dengan server selama jangka waktu tertentu. Setelah melewati titik ini, Cronet akan mencoba menggunakan QUIC lagi. Hal ini dilakukan untuk menyeimbangkan kepentingan jangka pendek (tidak ada gunanya membuang-buang resource untuk mencoba QUIC jika server rusak) dan jangka panjang (kerusakan mungkin bersifat sementara, menggunakan QUIC umumnya bermanfaat).

Penundaan akan bertambah setiap kali percobaan ulang berturut-turut tidak berhasil. Lihat increaseBrokenServicePeriodExponentially untuk mengetahui detailnya.

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

Menetapkan waktu tidak ada aktivitas maksimum untuk koneksi yang belum menyelesaikan handshake SSL.

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

Menetapkan waktu maksimum yang diinginkan antara paket di kabel.

Jika waktu yang dapat ditransmisikan ulang melalui kabel terlampaui, Cronet akan menyelidiki kualitas jaringan menggunakan traffic buatan. Waktu tunggu yang lebih singkat biasanya akan menghasilkan penemuan jalur yang rusak atau menurun lebih cepat, tetapi juga penggunaan resource (baterai, data) yang lebih besar.