ConnectionMigrationOptions.Builder

@ConnectionMigrationOptions.Experimental
fun allowNonDefaultNetworkUsage(enable: Boolean): ConnectionMigrationOptions.Builder!

Menetapkan apakah koneksi dapat dimigrasikan ke jaringan alternatif saat Cronet mendeteksi penurunan kualitas jalur yang saat ini digunakan.

Catatan: Setelan ini dapat menyebabkan permintaan dikirim di jaringan berbayar non-default. Pastikan Anda menggunakan jaringan berbayar dengan hemat, dan sesuaikan parameter seperti setMaxPathDegradingNonDefaultNetworkMigrationsCount dan setMaxTimeOnNonDefaultNetworkSeconds untuk membatasi waktu di jaringan non-default.

@ConnectionMigrationOptions.Experimental
fun allowServerMigration(allowServerMigration: Boolean): ConnectionMigrationOptions.Builder!

Memungkinkan migrasi koneksi ke alamat server alternatif atas permintaan server.

fun build(): ConnectionMigrationOptions!

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

fun enableDefaultNetworkMigration(
    enableDefaultNetworkConnectionMigration: Boolean
): ConnectionMigrationOptions.Builder!

Memungkinkan migrasi koneksi saat perubahan jaringan default. Jika diaktifkan, koneksi QUIC aktif akan dimigrasikan ke jaringan baru saat platform menunjukkan bahwa jaringan default sedang berubah.

fun enablePathDegradationMigration(enable: Boolean): ConnectionMigrationOptions.Builder!

Memungkinkan migrasi koneksi jika jalur saat ini berperforma buruk.

Bergantung pada konfigurasi lainnya, hal ini dapat mengakibatkan migrasi koneksi dalam jaringan default yang sama, atau ke jaringan non-default.

@ConnectionMigrationOptions.Experimental
fun migrateIdleConnections(migrateIdleConnections: Boolean): ConnectionMigrationOptions.Builder!

Mengonfigurasi apakah migrasi koneksi yang tidak ada aktivitas harus diaktifkan atau tidak.

Jika disetel ke benar (true), koneksi yang tidak aktif juga akan dimigrasikan, selama koneksi tersebut belum terlalu lama tidak aktif. Setelan ini dibagikan untuk semua jenis migrasi koneksi. Periode tidak ada aktivitas maksimum agar koneksi tetap dimigrasikan dapat disesuaikan menggunakan setIdleConnectionMigrationPeriodSeconds.

@ConnectionMigrationOptions.Experimental
fun retryPreHandshakeErrorsOnNonDefaultNetwork(
    retryPreHandshakeErrorsOnAlternateNetwork: Boolean
): ConnectionMigrationOptions.Builder!

Menetapkan apakah koneksi dengan error pra-handshake harus dicoba lagi di jaringan alternatif.

Jika benar (true), koneksi baru dapat dibuat ke jaringan alternatif jika koneksi gagal di jaringan default sebelum handshake dikonfirmasi.

Catatan: sama seperti allowNonDefaultNetworkUsage, setelan ini dapat menyebabkan permintaan dikirim di jaringan berbayar non-default. Gunakan dengan hati-hati.

@ConnectionMigrationOptions.Experimental
fun setIdleConnectionMigrationPeriodSeconds(
    idleConnectionMigrationPeriodSeconds: Long
): ConnectionMigrationOptions.Builder!

Menetapkan periode tidak ada aktivitas maksimum agar koneksi tetap dimigrasikan, dalam detik. Setelan ini dibagikan untuk semua jenis migrasi koneksi.

Hanya relevan jika migrateIdleConnections diaktifkan.

@ConnectionMigrationOptions.Experimental
fun setMaxPathDegradingNonDefaultNetworkMigrationsCount(
    maxPathDegradingEagerMigrationsCount: Int
): ConnectionMigrationOptions.Builder!

Menetapkan jumlah maksimum migrasi ke jaringan non-default saat terjadi penurunan kualitas jalur untuk koneksi yang ada. Dihitung secara kumulatif per jaringan per koneksi.

Hanya relevan jika allowNonDefaultNetworkUsage diaktifkan.

@ConnectionMigrationOptions.Experimental
fun setMaxTimeOnNonDefaultNetworkSeconds(
    maxTimeOnNonDefaultNetworkSeconds: Long
): ConnectionMigrationOptions.Builder!

Menetapkan periode maksimum koneksi yang dimigrasikan secara agresif harus tetap berada di jaringan non-default sebelum dimigrasikan kembali. Waktu ini tidak bersifat kumulatif - setiap migrasi dari jaringan default untuk setiap koneksi diukur dan dibandingkan dengan nilai ini secara terpisah.

Hanya relevan jika allowNonDefaultNetworkUsage diaktifkan.

@ConnectionMigrationOptions.Experimental
fun setMaxWriteErrorNonDefaultNetworkMigrationsCount(
    maxWriteErrorEagerMigrationsCount: Int
): ConnectionMigrationOptions.Builder!

Menetapkan jumlah maksimum migrasi ke jaringan non-default saat terjadi error penulisan. Dihitung secara kumulatif per jaringan per koneksi.

Hanya relevan jika allowNonDefaultNetworkUsage diaktifkan.