CronetEngine

const val ACTIVE_REQUEST_COUNT_UNKNOWN = -1: Int

활성 요청 수의 값을 알 수 없음

const val CONNECTION_METRIC_UNKNOWN = -1: Int

연결 측정항목의 값을 알 수 없습니다.

const val EFFECTIVE_CONNECTION_TYPE_2G = 3: Int

효과적인 연결 유형이 2G로 추정됩니다.

const val EFFECTIVE_CONNECTION_TYPE_3G = 4: Int

효과적인 연결 유형이 3G로 추정됩니다.

const val EFFECTIVE_CONNECTION_TYPE_4G = 5: Int

효과적인 연결 유형이 4G로 추정됩니다.

const val EFFECTIVE_CONNECTION_TYPE_OFFLINE = 1: Int

기기가 오프라인 상태입니다.

const val EFFECTIVE_CONNECTION_TYPE_SLOW_2G = 2: Int

효과적인 연결 유형이 느린 2G로 추정됩니다.

const val EFFECTIVE_CONNECTION_TYPE_UNKNOWN = 0: Int

효과적인 연결 유형의 추정치를 알 수 없습니다.

const val UNBIND_NETWORK_HANDLE = -1: Long

이전 네트워크 바인딩을 실행취소하는 데 사용할 값입니다.

fun addRequestFinishedListener(listener: RequestFinishedInfo.Listener!): Unit

요청 정보와 함께 각 요청이 끝난 후 호출되는 리스너를 등록합니다.

리스너는 리스너가 제공한 java.util.concurrent.Executor에서 호출됩니다.

fun addRttListener(listener: NetworkQualityRttListener!): Unit

네트워크 품질 추정기가 샘플 왕복 시간을 확인할 때마다 호출되는 리스너를 등록합니다. 이 함수는 enableNetworkQualityEstimator 후에 호출해야 하며, 그렇지 않으면 예외가 발생합니다. 왕복 시간은 TCP, QUIC, URL 요청 레이어를 비롯한 네트워크 스택의 다양한 레이어에서 기록될 수 있습니다. 리스너는 enableNetworkQualityEstimator에 전달된 java.util.concurrent.Executor에서 호출됩니다.

fun addThroughputListener(listener: NetworkQualityThroughputListener!): Unit

네트워크 품질 추정기가 샘플 처리량 측정을 확인할 때마다 호출되는 리스너를 등록합니다. enableNetworkQualityEstimator 후에 호출해야 합니다. 처리량 관측치는 하나 이상의 URL 응답이 수신되는 시간에 활성 네트워크 인터페이스를 통해 읽은 바이트를 측정하여 계산됩니다. 리스너는 enableNetworkQualityEstimator에 전달된 java.util.concurrent.Executor에서 호출됩니다.

fun bindToNetwork(networkHandle: Long): Unit

엔진을 지정된 네트워크 핸들에 바인딩합니다. 이 엔진을 통해 생성된 모든 요청은 이 핸들과 연결된 네트워크를 사용합니다. 이 네트워크가 연결 해제되면 모든 요청이 실패하며, 정확한 오류는 네트워크가 연결 해제될 때 요청 처리 단계에 따라 달라집니다. 네트워크 핸들은 Network#getNetworkHandle를 통해 가져올 수 있습니다. Android Marshmallow부터 사용할 수 있습니다.

fun configureNetworkQualityEstimatorForTesting(
    useLocalHostRequests: Boolean,
    useSmallerResponses: Boolean,
    disableOfflineCheck: Boolean
): Unit

테스트를 위해 네트워크 품질 추정기를 구성합니다. 이 메서드는 왕복 시간 및 처리량 리스너가 추가되기 전, 네트워크 품질 추정기가 사용 설정된 후에 호출해야 합니다.

abstract fun createURLStreamHandlerFactory(): URLStreamHandlerFactory!

HTTP 및 HTTPS 트래픽을 처리하는 URLStreamHandlerFactory를 만듭니다. 이 클래스의 인스턴스는 setURLStreamHandlerFactory를 통해 설치할 수 있으므로 openConnection을 통해 생성된 모든 요청에 기본적으로 이 CronetEngine을 사용합니다.

Cronet은 시스템을 통해 제공되는 특정 HTTP 기능을 사용하지 않습니다.

• HttpResponseCache.install()를 통해 설치된 HTTP 캐시
• setDefault을 통해 설치된 HTTP 인증 방법
• setDefault를 통해 설치된 HTTP 쿠키 저장소

Cronet은 HTTPS 프로토콜을 사용하는 요청을 지원하고 권장하지만 HttpsURLConnection API는 지원하지 않습니다. 이러한 지원 부족에는 시스템을 통해 제공되는 특정 HTTPS 기능을 사용하지 않는 것도 포함됩니다.

• HttpsURLConnection.setDefaultHostnameVerifier()를 통해 설치된 HTTPS 호스트 이름 확인자
• HttpsURLConnection.setDefaultSSLSocketFactory()를 통해 설치된 HTTPS 소켓 팩토리

fun getActiveRequestCount(): Int

활성 요청 수를 반환합니다.

이 메서드가 예외를 발생시키지 않는다고 가정하면 UrlRequest.start()에서 요청이 '활성'이 됩니다. 모든 콜백이 반환되고 향후 추가 콜백을 트리거할 수 없으면 비활성 상태가 됩니다. 실제로 이는 onSucceeded/onCanceled/onFailed가 반환되고 모든 요청 완료 리스너가 반환되면 요청이 비활성 상태가 된다는 의미입니다. 자세한 내용은 Cronet 요청 수명 주기를 참고하세요.

fun getDownstreamThroughputKbps(): Int

네트워크 품질 추정기에서 계산한 다운스트림 처리량 추정치 (킬로비트/초)를 반환합니다. 값을 사용할 수 없는 경우 CONNECTION_METRIC_UNKNOWN로 설정합니다. enableNetworkQualityEstimator 후에 호출해야 하며, 그렇지 않으면 예외가 발생합니다.

fun getEffectiveConnectionType(): Int

네트워크 품질 추정기에서 계산한 유효 연결 유형의 추정치를 반환합니다. enableNetworkQualityEstimator를 호출하여 이 값의 계산을 시작합니다.

fun getHttpRttMs(): Int

네트워크 품질 추정기에서 계산한 HTTP RTT 추정치 (밀리초)를 반환합니다. 값을 사용할 수 없는 경우 CONNECTION_METRIC_UNKNOWN로 설정합니다. enableNetworkQualityEstimator 후에 호출해야 하며, 그렇지 않으면 예외가 발생합니다.

fun getTransportRttMs(): Int

네트워크 품질 추정기에서 계산한 전송 RTT 추정치 (밀리초)를 반환합니다. 값을 사용할 수 없는 경우 CONNECTION_METRIC_UNKNOWN로 설정합니다. enableNetworkQualityEstimator 후에 호출해야 하며, 그렇지 않으면 예외가 발생합니다.

abstract fun newUrlRequestBuilder(
    url: String!,
    callback: UrlRequest.Callback!,
    executor: Executor!
): UrlRequest.Builder!

UrlRequest 빌더를 만듭니다. 생성된 UrlRequest 객체의 모든 콜백은 executor의 스레드에서 호출됩니다. executor는 execute을 호출하는 스레드에서 작업을 실행하면 안 됩니다. 이렇게 하면 네트워킹 작업이 차단되고 종료 중에 예외가 발생할 수 있습니다.

abstract fun openConnection(url: URL!): URLConnection!

URLurl로 지정된 리소스에 대한 새 연결을 설정합니다.

참고: Cronet의 java.net.HttpURLConnection 구현에는 특정 제한사항이 적용됩니다. 자세한 내용은 createURLStreamHandlerFactory을 참고하세요.

fun removeRequestFinishedListener(listener: RequestFinishedInfo.Listener!): Unit

완료된 요청 리스너를 삭제합니다.

fun removeRttListener(listener: NetworkQualityRttListener!): Unit

이전에 addRttListener로 등록된 경우 왕복 시간 리스너를 삭제합니다. 관찰 수신을 중지하기 위해 NetworkQualityRttListener가 추가된 후에 호출해야 합니다.

fun removeThroughputListener(listener: NetworkQualityThroughputListener!): Unit

처리량 리스너를 삭제합니다. 관찰 수신을 중지하기 위해 addThroughputListener와 함께 NetworkQualityThroughputListener가 추가된 후에 호출해야 합니다.

abstract fun shutdown(): Unit

활성 요청이 없으면 CronetEngine를 종료하고, 그렇지 않으면 예외를 발생시킵니다.

네트워크 스레드에서 호출할 수 없습니다. Cronet이 Executor를 호출하는 스레드 (Executor가 콜백을 호출하는 스레드와 다름)입니다. 모든 CronetEngine 리소스가 정리될 때까지 차단될 수 있습니다.

fun startNetLogToDisk(dirPath: String!, logAll: Boolean, maxSize: Int): Unit

크기가 제한된 지정된 디렉터리에 NetLog 로깅을 시작합니다. NetLog에는 모든 활성 CronetEngine에서 내보낸 이벤트가 포함됩니다. NetLog는 디버깅에 유용합니다. stopNetLog 로깅이 중지되면 데이터가 dirPath의 netlog.json에 기록됩니다. 로깅이 중단되면 https://chromium .googlesource.com/chromium/src/+/main/net/tools/stitch_net_log_files.py를 사용하여.inprogress 하위 디렉터리에서 찾은 파일을 수동으로 스티치할 수 있습니다. 로그는 chrome://net-internals/#import로 이동한 Chrome 브라우저를 사용하여 볼 수 있습니다.

abstract fun startNetLogToFile(fileName: String!, logAll: Boolean): Unit

파일에 NetLog 로깅을 시작합니다. NetLog에는 모든 활성 CronetEngine에서 내보낸 이벤트가 포함됩니다. NetLog는 디버깅에 유용합니다. chrome://net-internals/#import로 이동한 Chrome 브라우저를 사용하여 파일을 볼 수 있습니다.

abstract fun stopNetLog(): Unit

NetLog 로깅을 중지하고 파일을 디스크에 플러시합니다. 로깅 세션이 진행 중이 아니면 이 호출은 무시됩니다.