ConnectionMigrationOptions.Builder

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

Define se as conexões podem ser migradas para uma rede alternativa quando o Cronet detecta uma degradação do caminho em uso.

Observação: essa configuração pode resultar no envio de solicitações em redes medidas não padrão. Use redes medidas com moderação e ajuste parâmetros como setMaxPathDegradingNonDefaultNetworkMigrationsCount e setMaxTimeOnNonDefaultNetworkSeconds para limitar o tempo em redes não padrão.

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

Ativa a possibilidade de migrar conexões para um endereço de servidor alternativo a pedido do servidor.

fun build(): ConnectionMigrationOptions!

Cria e retorna a instância final de ConnectionMigrationOptions, com base nos valores desse builder.

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

Ativa a possibilidade de migrar conexões na mudança de rede padrão. Se ativada, as conexões QUIC ativas serão migradas para a nova rede quando a plataforma indicar que a rede padrão está mudando.

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

Ativa a possibilidade de migrar conexões se o caminho atual tiver um desempenho ruim.

Dependendo de outras configurações, isso pode resultar na migração das conexões na mesma rede padrão ou para uma rede não padrão.

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

Configura se a migração de conexões inativas precisa ser ativada ou não.

Se definido como verdadeiro, as conexões inativas também serão migradas, desde que não estejam inativas por muito tempo. A configuração é compartilhada para todos os tipos de migração de conexão. O período máximo de inatividade para o qual as conexões ainda serão migradas pode ser personalizado usando setIdleConnectionMigrationPeriodSeconds.

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

Define se as conexões com erros de pré-handshake precisam ser repetidas em uma rede alternativa.

Se for verdadeiro, uma nova conexão poderá ser estabelecida em uma rede alternativa se falhar na rede padrão antes que o handshake seja confirmado.

Observação: assim como allowNonDefaultNetworkUsage, essa configuração pode resultar no envio de solicitações em redes medidas não padrão. Use com cuidado.

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

Define o período máximo de inatividade para o qual as conexões ainda serão migradas, em segundos. A configuração é compartilhada para todos os tipos de migração de conexão.

Relevante apenas se migrateIdleConnections estiver ativado.

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

Define o número máximo de migrações para a rede não padrão ao encontrar degradação de caminho para a conexão atual. Contado cumulativamente por rede por conexão.

Relevante apenas se allowNonDefaultNetworkUsage estiver ativado.

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

Define o período máximo em que as conexões migradas com urgência precisam permanecer na rede não padrão antes de serem migradas de volta. Esse tempo não é cumulativo. Cada migração da rede padrão para cada conexão mede e compara esse valor separadamente.

Relevante apenas se allowNonDefaultNetworkUsage estiver ativado.

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

Define o número máximo de migrações para a rede não padrão ao encontrar erros de gravação. Contado cumulativamente por rede por conexão.

Relevante apenas se allowNonDefaultNetworkUsage estiver ativado.