ConnectionMigrationOptions.Builder

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

Określa, czy połączenia mogą być migrowane do sieci alternatywnej, gdy Cronet wykryje pogorszenie jakości ścieżki, która jest obecnie używana.

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
public ConnectionMigrationOptions.Builder allowServerMigration(boolean allowServerMigration)

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

public ConnectionMigrationOptions build()

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

public ConnectionMigrationOptions.Builder enableDefaultNetworkMigration(
    boolean enableDefaultNetworkConnectionMigration
)

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.

public ConnectionMigrationOptions.Builder enablePathDegradationMigration(boolean enable)

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
public ConnectionMigrationOptions.Builder migrateIdleConnections(boolean migrateIdleConnections)

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, przez jaki połączenia będą nadal migrowane, można dostosować za pomocą setIdleConnectionMigrationPeriodSeconds.

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

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 allowNonDefaultNetworkUsage to ustawienie może spowodować wysyłanie żądań w sieciach rozliczanych według zużycia, które nie są domyślne. Używaj z rozwagą.

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

Ustawia maksymalny czas bezczynności w sekundach, przez jaki 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
public ConnectionMigrationOptions.Builder setMaxPathDegradingNonDefaultNetworkMigrationsCount(
    int maxPathDegradingEagerMigrationsCount
)

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 na połączenie.

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

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

Ustawia maksymalny czas, przez jaki połączenia migrowane z wyprzedzeniem mają pozostać 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
public ConnectionMigrationOptions.Builder setMaxWriteErrorNonDefaultNetworkMigrationsCount(
    int maxWriteErrorEagerMigrationsCount
)

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 na połączenie.

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