ConnectionMigrationOptions.Builder

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder allowNonDefaultNetworkUsage(boolean enable)

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 terukur non-default. Pastikan Anda menggunakan jaringan terukur dengan hemat, dan sesuaikan parameter seperti setMaxPathDegradingNonDefaultNetworkMigrationsCount dan setMaxTimeOnNonDefaultNetworkSeconds untuk membatasi waktu di jaringan non-default.

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder allowServerMigration(boolean allowServerMigration)

Mengaktifkan kemungkinan memigrasikan koneksi ke alamat server alternatif atas permintaan server.

public ConnectionMigrationOptions build()

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

public ConnectionMigrationOptions.Builder enableDefaultNetworkMigration(
    boolean enableDefaultNetworkConnectionMigration
)

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

public ConnectionMigrationOptions.Builder enablePathDegradationMigration(boolean enable)

Mengaktifkan kemungkinan memigrasikan koneksi jika jalur saat ini berkinerja buruk.

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

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder migrateIdleConnections(boolean migrateIdleConnections)

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

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

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder retryPreHandshakeErrorsOnNonDefaultNetwork(
    boolean retryPreHandshakeErrorsOnAlternateNetwork
)

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

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

Catatan: mirip dengan allowNonDefaultNetworkUsage, setelan ini dapat menyebabkan permintaan dikirim di jaringan terukur non-default. Gunakan dengan hati-hati.

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder setIdleConnectionMigrationPeriodSeconds(
    long idleConnectionMigrationPeriodSeconds
)

Menetapkan periode tidak ada aktivitas maksimum untuk koneksi yang masih akan dimigrasikan, dalam detik. Setelan ini dibagikan untuk semua jenis migrasi koneksi.

Hanya relevan jika migrateIdleConnections diaktifkan.

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder setMaxPathDegradingNonDefaultNetworkMigrationsCount(
    int maxPathDegradingEagerMigrationsCount
)

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

Hanya relevan jika allowNonDefaultNetworkUsage diaktifkan.

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder setMaxTimeOnNonDefaultNetworkSeconds(
    long maxTimeOnNonDefaultNetworkSeconds
)

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

Hanya relevan jika allowNonDefaultNetworkUsage diaktifkan.

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder setMaxWriteErrorNonDefaultNetworkMigrationsCount(
    int maxWriteErrorEagerMigrationsCount
)

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

Hanya relevan jika allowNonDefaultNetworkUsage diaktifkan.