ConnectionMigrationOptions 的 Builder。
公共方法摘要
继承方法摘要
公共方法
public ConnectionMigrationOptions.Builder allowNonDefaultNetworkUsage (boolean enable)
设置当 Cronet 检测到当前使用的路径性能下降时，连接是否可以迁移到备用网络。
注意：此设置可能导致请求通过非默认按流量计费网络发送。请确保谨慎使用按流量计费网络，并微调诸如 setMaxPathDegradingNonDefaultNetworkMigrationsCount(int) 和 setMaxTimeOnNonDefaultNetworkSeconds(long) 之类的参数，以限制在非默认网络上的时间。
参数
| enable |
|---|
返回
- 此 builder，用于链式调用
public ConnectionMigrationOptions.Builder allowServerMigration (boolean allowServerMigration)
允许在服务器请求时将连接迁移到备用服务器地址。
参数
| allowServerMigration |
|---|
返回
- 此 builder，用于链式调用
public ConnectionMigrationOptions.Builder enableDefaultNetworkMigration (boolean enableDefaultNetworkConnectionMigration)
允许在默认网络更改时迁移连接。如果启用，当平台指示默认网络正在更改时，活动的 QUIC 连接将迁移到新网络。
参数
| enableDefaultNetworkConnectionMigration |
|---|
返回
- 此 builder，用于链式调用
另请参阅
public ConnectionMigrationOptions.Builder enablePathDegradationMigration (boolean enable)
允许在当前路径性能不佳时迁移连接。
根据其他配置，这可能导致连接在同一默认网络内迁移，或迁移到非默认网络。
参数
| enable |
|---|
返回
- 此 builder，用于链式调用
public ConnectionMigrationOptions.Builder migrateIdleConnections (boolean migrateIdleConnections)
配置是否应启用空闲连接迁移。
如果设置为 true，空闲连接也会迁移，前提是它们空闲时间不长。此设置适用于所有连接迁移类型。可以使用 setIdleConnectionMigrationPeriodSeconds(long) 自定义连接仍然可以迁移的最长空闲时间。
参数
| migrateIdleConnections |
|---|
返回
- 此 builder，用于链式调用
public ConnectionMigrationOptions.Builder retryPreHandshakeErrorsOnNonDefaultNetwork (boolean retryPreHandshakeErrorsOnAlternateNetwork)
设置是否应在备用网络上重试存在握手前错误的连接。
如果为 true，如果在默认网络上握手确认前失败，可以在备用网络上建立新连接。
注意：与 allowNonDefaultNetworkUsage(boolean) 类似，此设置可能导致请求通过非默认按流量计费网络发送。请谨慎使用！
参数
| retryPreHandshakeErrorsOnAlternateNetwork |
|---|
返回
- 此 builder，用于链式调用
public ConnectionMigrationOptions.Builder setIdleConnectionMigrationPeriodSeconds (long idleConnectionMigrationPeriodSeconds)
设置空闲连接仍然可以迁移的最长空闲时间（以秒为单位）。此设置适用于所有连接迁移类型。
仅当 migrateIdleConnections(boolean) 启用时相关。
参数
| idleConnectionMigrationPeriodSeconds |
|---|
返回
- 此 builder，用于链式调用
public ConnectionMigrationOptions.Builder setMaxPathDegradingNonDefaultNetworkMigrationsCount (int maxPathDegradingEagerMigrationsCount)
设置当现有连接遇到路径性能下降时，迁移到非默认网络的最大次数。按每个连接在每个网络上累积计数。
仅当 allowNonDefaultNetworkUsage(boolean) 启用时相关。
参数
| maxPathDegradingEagerMigrationsCount |
|---|
返回
- 此 builder，用于链式调用
public ConnectionMigrationOptions.Builder setMaxTimeOnNonDefaultNetworkSeconds (long maxTimeOnNonDefaultNetworkSeconds)
设置主动迁移的连接在迁移回默认网络之前，应停留在非默认网络上的最长时间。此时间不是累积的 - 每个连接的每次从默认网络迁移出去都会单独测量并与此值进行比较。
仅当 allowNonDefaultNetworkUsage(boolean) 启用时相关。
参数
| maxTimeOnNonDefaultNetworkSeconds |
|---|
返回
- 此 builder，用于链式调用
public ConnectionMigrationOptions.Builder setMaxWriteErrorNonDefaultNetworkMigrationsCount (int maxWriteErrorEagerMigrationsCount)
设置当遇到写入错误时，迁移到非默认网络的最大次数。按每个连接在每个网络上累积计数。
仅当 allowNonDefaultNetworkUsage(boolean) 启用时相关。
参数
| maxWriteErrorEagerMigrationsCount |
|---|
返回
- 此 builder，用于链式调用