ConnectionMigrationOptions.Builder

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

Определяет, можно ли перевести соединения в альтернативную сеть, если Cronet обнаружит ухудшение качества используемого в данный момент канала связи.

Примечание: Эта настройка может привести к отправке запросов в сети, отличные от сети с лимитированным трафиком по умолчанию. Убедитесь, что вы используете сети с лимитированным трафиком экономно, и точно настройте такие параметры, как setMaxPathDegradingNonDefaultNetworkMigrationsCount и setMaxTimeOnNonDefaultNetworkSeconds чтобы ограничить время работы в сетях, отличных от сети по умолчанию.

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

Предоставляет возможность переноса соединений на альтернативный адрес сервера по запросу сервера.

public ConnectionMigrationOptions build()

Создает и возвращает окончательный экземпляр ConnectionMigrationOptions на основе значений, указанных в этом конструкторе.

public ConnectionMigrationOptions.Builder enableDefaultNetworkMigration(
    boolean enableDefaultNetworkConnectionMigration
)

Предоставляет возможность переноса соединений при изменении сети по умолчанию. Если эта функция включена, активные соединения QUIC будут перенесены в новую сеть, когда платформа сообщит об изменении сети по умолчанию.

public ConnectionMigrationOptions.Builder enablePathDegradationMigration(boolean enable)

Предоставляет возможность миграции соединений, если текущий путь работает неэффективно.

В зависимости от других параметров конфигурации это может привести к переносу соединений в рамках одной и той же сети по умолчанию или в сеть, отличную от сети по умолчанию.

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

Определяет, следует ли включать или отключать миграцию неактивных соединений.

Если установлено значение true, то неактивные соединения также будут перенесены, если они не простаивали слишком долго. Этот параметр является общим для всех типов переноса соединений. Максимальный период простоя, в течение которого соединения будут переноситься, можно настроить с помощью setIdleConnectionMigrationPeriodSeconds .

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

Определяет, следует ли повторять попытки подключения к сети с ошибками на этапе предварительного установления соединения.

Если это так, то новое соединение может быть установлено в альтернативной сети, если оно не удается установить в основной сети до подтверждения рукопожатия.

Примечание: как и параметр allowNonDefaultNetworkUsage эта настройка может привести к отправке запросов в сети с нестандартным тарификацией. Используйте с осторожностью!

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

Устанавливает максимальный период простоя, в течение которого соединения будут продолжать переноситься, в секундах. Этот параметр является общим для всех типов переноса соединений.

Актуально только при включенной migrateIdleConnections .

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

Устанавливает максимальное количество миграций в сеть, отличную от сети по умолчанию, при возникновении ухудшения качества связи для существующего соединения. Подсчет производится кумулятивно для каждой сети и каждого соединения.

Актуально только в том случае, если включен параметр allowNonDefaultNetworkUsage .

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

Устанавливает максимальный период, в течение которого перенесенные соединения должны оставаться в сети, отличной от сети по умолчанию, прежде чем они будут перенесены обратно. Это время не суммируется — каждая миграция из сети по умолчанию для каждого соединения измеряется и сравнивается с этим значением отдельно.

Актуально только в том случае, если включен параметр allowNonDefaultNetworkUsage .

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

Устанавливает максимальное количество миграций в сеть, отличную от сети по умолчанию, при возникновении ошибок записи. Подсчитывается суммарно для каждой сети и каждого соединения.

Актуально только в том случае, если включен параметр allowNonDefaultNetworkUsage .