ConnectionMigrationOptions.Builder

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

Cronet이 현재 사용 중인 경로의 성능 저하를 감지할 때 연결을 대체 네트워크로 이전할 수 있는지 설정합니다.

참고: 이 설정을 사용하면 기본값이 아닌 종량제 네트워크에서 요청이 전송될 수 있습니다. 종량제 네트워크를 드물게 사용하고 setMaxPathDegradingNonDefaultNetworkMigrationsCount 및 setMaxTimeOnNonDefaultNetworkSeconds와 같은 매개변수를 미세 조정하여 기본값이 아닌 네트워크의 시간을 제한하세요.

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

서버의 요청에 따라 연결을 대체 서버 주소로 이전할 수 있도록 합니다.

fun build(): ConnectionMigrationOptions!

이 빌더의 값을 기반으로 최종 ConnectionMigrationOptions 인스턴스를 만들고 반환합니다.

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

기본 네트워크 변경 시 연결을 이전할 수 있도록 합니다. 사용 설정된 경우 플랫폼에서 기본 네트워크가 변경되고 있음을 나타내면 활성 QUIC 연결이 새 네트워크로 이전됩니다.

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

현재 경로의 성능이 저하되는 경우 연결을 이전할 수 있도록 합니다.

다른 구성에 따라 동일한 기본 네트워크 내에서 연결을 이전하거나 기본값이 아닌 네트워크로 이전할 수 있습니다.

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

유휴 연결의 이전을 사용 설정할지 구성합니다.

true로 설정하면 유휴 연결이 너무 오래 유휴 상태가 아니면 이전됩니다. 이 설정은 모든 연결 이전 유형에 공유됩니다. setIdleConnectionMigrationPeriodSeconds를 사용하여 연결이 계속 이전되는 최대 유휴 기간을 맞춤설정할 수 있습니다.

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

핸드셰이크 전 오류가 있는 연결을 대체 네트워크에서 재시도할지 설정합니다.

true인 경우 핸드셰이크가 확인되기 전에 기본 네트워크에서 실패하면 대체 네트워크에서 새 연결이 설정될 수 있습니다.

참고: allowNonDefaultNetworkUsage와 마찬가지로 이 설정을 사용하면 기본값이 아닌 종량제 네트워크에서 요청이 전송될 수 있습니다. 주의해서 사용하세요.

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

연결이 계속 이전되는 최대 유휴 기간을 초 단위로 설정합니다. 이 설정은 모든 연결 이전 유형에 공유됩니다.

migrateIdleConnections가 사용 설정된 경우에만 관련이 있습니다.

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

기존 연결의 경로 성능 저하가 발생할 때 기본값이 아닌 네트워크로의 최대 이전 수를 설정합니다. 연결당 네트워크별로 누적 집계됩니다.

allowNonDefaultNetworkUsage가 사용 설정된 경우에만 관련이 있습니다.

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

이전된 연결이 다시 이전되기 전에 기본값이 아닌 네트워크에 유지되어야 하는 최대 기간을 설정합니다. 이 시간은 누적되지 않습니다. 각 연결의 기본 네트워크에서 벗어나는 각 이전은 이 값을 개별적으로 측정하고 비교합니다.

allowNonDefaultNetworkUsage가 사용 설정된 경우에만 관련이 있습니다.

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

쓰기 오류가 발생할 때 기본값이 아닌 네트워크로의 최대 이전 수를 설정합니다. 연결당 네트워크별로 누적 집계됩니다.

allowNonDefaultNetworkUsage가 사용 설정된 경우에만 관련이 있습니다.