ConnectionMigrationOptions.Builder

class ConnectionMigrationOptions.Builder


Compilador para ConnectionMigrationOptions.

Resumen

Funciones públicas

ConnectionMigrationOptions.Builder!

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

ConnectionMigrationOptions.Builder!

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

ConnectionMigrationOptions!

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

ConnectionMigrationOptions.Builder!
enableDefaultNetworkMigration(
    enableDefaultNetworkConnectionMigration: Boolean
)

Habilita la posibilidad de migrar conexiones en el cambio de red predeterminado.

ConnectionMigrationOptions.Builder!

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

ConnectionMigrationOptions.Builder!

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

ConnectionMigrationOptions.Builder!

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

ConnectionMigrationOptions.Builder!

Establece el período máximo de inactividad durante el cual se seguirán migrando las conexiones, en segundos.

ConnectionMigrationOptions.Builder!

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.

ConnectionMigrationOptions.Builder!

Establece el período máximo durante el cual las conexiones migradas con rapidez deben permanecer en la red no predeterminada antes de que se vuelvan a migrar.

ConnectionMigrationOptions.Builder!

Establece la cantidad máxima de migraciones a la red no predeterminada cuando se detectan errores de escritura.

Funciones públicas

allowNonDefaultNetworkUsage

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

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 redes medidas con moderación y ajustar parámetros como setMaxPathDegradingNonDefaultNetworkMigrationsCount y setMaxTimeOnNonDefaultNetworkSeconds para limitar el tiempo en redes no predeterminadas.

Muestra
ConnectionMigrationOptions.Builder!

este compilador para el encadenamiento

allowServerMigration

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

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

Muestra
ConnectionMigrationOptions.Builder!

este compilador para el encadenamiento

build

fun build(): ConnectionMigrationOptions!

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

enableDefaultNetworkMigration

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

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

Muestra
ConnectionMigrationOptions.Builder!

este compilador para el encadenamiento

enablePathDegradationMigration

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

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.

Muestra
ConnectionMigrationOptions.Builder!

este compilador para el encadenamiento

Consulta también
allowNonDefaultNetworkUsage

migrateIdleConnections

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

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 máximo de inactividad durante el cual se seguirán migrando las conexiones se puede personalizar con setIdleConnectionMigrationPeriodSeconds.

Muestra
ConnectionMigrationOptions.Builder!

este compilador para el encadenamiento

retryPreHandshakeErrorsOnNonDefaultNetwork

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

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.

Muestra
ConnectionMigrationOptions.Builder!

este compilador para el encadenamiento

setIdleConnectionMigrationPeriodSeconds

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

Establece el período máximo de inactividad 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.

Muestra
ConnectionMigrationOptions.Builder!

este compilador para el encadenamiento

setMaxPathDegradingNonDefaultNetworkMigrationsCount

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

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.

Muestra
ConnectionMigrationOptions.Builder!

este compilador para el encadenamiento

setMaxTimeOnNonDefaultNetworkSeconds

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

Establece el período máximo durante el cual las conexiones migradas con rapidez 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.

Muestra
ConnectionMigrationOptions.Builder!

este compilador para el encadenamiento

setMaxWriteErrorNonDefaultNetworkMigrationsCount

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

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.

Muestra
ConnectionMigrationOptions.Builder!

este compilador para el encadenamiento