ConnectionMigrationOptions.Builder

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

Establece si las conexiones se pueden migrar a una red alternativa cuando Cronet detecta una degradación de la ruta que se usa actualmente.

Nota: Este parámetro de configuración puede hacer que se envíen solicitudes en redes medidas no predeterminadas. Asegúrate de usar las redes medidas con moderación y ajustar parámetros como setMaxPathDegradingNonDefaultNetworkMigrationsCount y setMaxTimeOnNonDefaultNetworkSeconds para limitar el tiempo en redes no predeterminadas.

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

Habilita la posibilidad de migrar conexiones a una dirección de servidor alternativa a solicitud del servidor.

public ConnectionMigrationOptions build()

Crea y muestra la instancia final de ConnectionMigrationOptions, según los valores de este compilador.

public ConnectionMigrationOptions.Builder enableDefaultNetworkMigration(
    boolean enableDefaultNetworkConnectionMigration
)

Habilita la posibilidad de migrar conexiones cuando cambia la red predeterminada. Si está habilitado, las conexiones QUIC activas se migrarán a la red nueva cuando la plataforma indique que la red predeterminada está cambiando.

public ConnectionMigrationOptions.Builder enablePathDegradationMigration(boolean enable)

Habilita la posibilidad de migrar conexiones si la ruta actual tiene un rendimiento deficiente.

Según otra configuración, esto puede provocar la migración de las conexiones dentro de la misma red predeterminada o a una red no predeterminada.

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

Configura si se debe habilitar o no la migración de conexiones inactivas.

Si se establece como verdadero, las conexiones inactivas también se migrarán, siempre que no hayan estado inactivas durante demasiado tiempo. El parámetro de configuración se comparte para todos los tipos de migración de conexión. El período de inactividad máximo durante el cual se seguirán migrando las conexiones se puede personalizar con setIdleConnectionMigrationPeriodSeconds.

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

Establece si se deben reintentar las conexiones con errores previos al protocolo de enlace en una red alternativa.

Si es verdadero, se puede establecer una conexión nueva en una red alternativa si falla en la red predeterminada antes de que se confirme el protocolo de enlace.

Nota: Al igual que allowNonDefaultNetworkUsage, este parámetro de configuración puede hacer que se envíen solicitudes en redes medidas no predeterminadas. Usar con precaución.

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

Establece el período de inactividad máximo durante el cual se seguirán migrando las conexiones, en segundos. El parámetro de configuración se comparte para todos los tipos de migración de conexión.

Solo es relevante si migrateIdleConnections está habilitado.

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

Establece la cantidad máxima de migraciones a la red no predeterminada cuando se detecta una degradación de la ruta para la conexión existente. Se cuenta de forma acumulativa por red por conexión.

Solo es relevante si allowNonDefaultNetworkUsage está habilitado.

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

Establece el período máximo durante el cual las conexiones migradas con anticipación deben permanecer en la red no predeterminada antes de que se vuelvan a migrar. Este tiempo no es acumulativo: cada migración fuera de la red predeterminada para cada conexión mide y compara este valor por separado.

Solo es relevante si allowNonDefaultNetworkUsage está habilitado.

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

Establece la cantidad máxima de migraciones a la red no predeterminada cuando se detectan errores de escritura. Se cuenta de forma acumulativa por red por conexión.

Solo es relevante si allowNonDefaultNetworkUsage está habilitado.