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
)

ハンドシェイク前のエラーが発生した接続を代替ネットワークで再試行するかどうかを設定します。

true の場合、ハンドシェイクが確認される前にデフォルト ネットワークで失敗すると、代替ネットワークで新しい接続が確立されることがあります。

注: 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 が有効な場合にのみ関連します。