ConnectionMigrationOptions.Builder

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

Imposta se le connessioni possono essere migrate a una rete alternativa quando Cronet rileva un degrado del percorso attualmente in uso.

Nota: questa impostazione può comportare l'invio di richieste su reti a consumo non predefinite. Assicurati di utilizzare le reti a consumo con parsimonia e di ottimizzare parametri come setMaxPathDegradingNonDefaultNetworkMigrationsCount e setMaxTimeOnNonDefaultNetworkSeconds per limitare il tempo sulle reti non predefinite.

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

Consente la possibilità di migrare le connessioni a un indirizzo server alternativo su richiesta del server.

fun build(): ConnectionMigrationOptions!

Crea e restituisce l'istanza finale di ConnectionMigrationOptions, in base ai valori di questo builder.

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

Consente la possibilità di migrare le connessioni in caso di modifica della rete predefinita. Se questa opzione è attiva, le connessioni QUIC attive verranno migrate alla nuova rete quando la piattaforma indica che la rete predefinita sta cambiando.

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

Consente la possibilità di migrare le connessioni se il percorso attuale ha un rendimento scarso.

A seconda di altre configurazioni, questa operazione può comportare la migrazione delle connessioni all'interno della stessa rete predefinita o a una rete non predefinita.

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

Configura se la migrazione delle connessioni inattive deve essere abilitata o meno.

Se impostato su true, verranno migrate anche le connessioni inattive, a condizione che non siano inattive da troppo tempo. L'impostazione è condivisa per tutti i tipi di migrazione delle connessioni. Il periodo di inattività massimo per il quale le connessioni verranno comunque migrate può essere personalizzato utilizzando setIdleConnectionMigrationPeriodSeconds.

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

Imposta se le connessioni con errori di pre-handshake devono essere riprovate su una rete alternativa.

Se è true, è possibile stabilire una nuova connessione a una rete alternativa se non riesce sulla rete predefinita prima che venga confermato l'handshake.

Nota: analogamente a allowNonDefaultNetworkUsage, questa impostazione può comportare l'invio di richieste su reti a consumo non predefinite. Da usare con cautela.

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

Imposta il periodo di inattività massimo in secondi per il quale le connessioni verranno comunque migrate. L'impostazione è condivisa per tutti i tipi di migrazione delle connessioni.

È pertinente solo se migrateIdleConnections è abilitato.

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

Imposta il numero massimo di migrazioni alla rete non predefinita in caso di degrado del percorso per la connessione esistente. Conteggio cumulativo per rete per connessione.

È pertinente solo se allowNonDefaultNetworkUsage è abilitato.

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

Imposta il periodo massimo in cui le connessioni migrate in modo eager devono rimanere sulla rete non predefinita prima di essere migrate di nuovo. Questo tempo non è cumulativo: ogni migrazione dalla rete predefinita per ogni connessione viene misurata e confrontata separatamente con questo valore.

È pertinente solo se allowNonDefaultNetworkUsage è abilitato.

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

Imposta il numero massimo di migrazioni alla rete non predefinita in caso di errori di scrittura. Conteggio cumulativo per rete per connessione.

È pertinente solo se allowNonDefaultNetworkUsage è abilitato.