ConnectionMigrationOptions.Builder

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

Określa, czy połączenia mogą być migrowane do sieci alternatywnej, gdy Cronet wykryje pogorszenie jakości aktualnie używanej ścieżki.

Uwaga: to ustawienie może spowodować wysyłanie żądań w sieciach rozliczanych według zużycia, które nie są domyślne. Pamiętaj, aby oszczędnie korzystać z sieci rozliczanych według zużycia i dostosować parametry takie jak setMaxPathDegradingNonDefaultNetworkMigrationsCount i setMaxTimeOnNonDefaultNetworkSeconds, aby ograniczyć czas korzystania z sieci innych niż domyślne.

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

Umożliwia migrację połączeń na alternatywny adres serwera na żądanie serwera.

fun build(): ConnectionMigrationOptions!

Tworzy i zwraca ostateczną instancję ConnectionMigrationOptions na podstawie wartości w tym kreatorze.

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

Umożliwia migrację połączeń w przypadku zmiany sieci domyślnej. Jeśli ta opcja jest włączona, aktywne połączenia QUIC będą migrowane do nowej sieci, gdy platforma wskaże, że sieć domyślna się zmienia.

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

Umożliwia migrację połączeń, jeśli bieżąca ścieżka działa słabo.

W zależności od innych konfiguracji może to spowodować migrację połączeń w tej samej sieci domyślnej lub do sieci innej niż domyślna.

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

Określa, czy migracja bezczynnych połączeń ma być włączona.

Jeśli ta opcja jest ustawiona na „prawda”, bezczynne połączenia też będą migrowane, o ile nie są bezczynne zbyt długo. To ustawienie jest wspólne dla wszystkich typów migracji połączeń. Maksymalny czas bezczynności, po którym połączenia będą nadal migrowane, można dostosować za pomocą funkcji setIdleConnectionMigrationPeriodSeconds.

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

Określa, czy połączenia z błędami przed uzgadnianiem mają być ponawiane w sieci alternatywnej.

Jeśli ta opcja jest ustawiona na „prawda”, można nawiązać nowe połączenie w sieci alternatywnej, jeśli połączenie w sieci domyślnej nie powiedzie się przed potwierdzeniem uzgadniania.

Uwaga: podobnie jak w przypadku ustawienia allowNonDefaultNetworkUsage to ustawienie może spowodować wysyłanie żądań w sieciach rozliczanych według zużycia, które nie są domyślne. Używaj ostrożnie.

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

Ustawia maksymalny czas bezczynności w sekundach, po którym połączenia będą nadal migrowane. To ustawienie jest wspólne dla wszystkich typów migracji połączeń.

Ma znaczenie tylko wtedy, gdy włączona jest opcja migrateIdleConnections.

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

Ustawia maksymalną liczbę migracji do sieci innej niż domyślna w przypadku pogorszenia jakości ścieżki dla istniejącego połączenia. Liczba jest zliczana łącznie na sieć i połączenie.

Ma znaczenie tylko wtedy, gdy włączona jest opcja allowNonDefaultNetworkUsage.

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

Ustawia maksymalny czas, przez jaki połączenia migrowane z wyprzedzeniem mają pozostawać w sieci innej niż domyślna, zanim zostaną z powrotem przeniesione. Ten czas nie jest kumulowany – każda migracja z sieci domyślnej dla każdego połączenia jest mierzona i porównywana z tą wartością osobno.

Ma znaczenie tylko wtedy, gdy włączona jest opcja allowNonDefaultNetworkUsage.

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

Ustawia maksymalną liczbę migracji do sieci innej niż domyślna w przypadku wystąpienia błędów zapisu. Liczba jest zliczana łącznie na sieć i połączenie.

Ma znaczenie tylko wtedy, gdy włączona jest opcja allowNonDefaultNetworkUsage.