CronetEngine

const val ACTIVE_REQUEST_COUNT_UNKNOWN = -1: Int

Se desconoce el valor del recuento de solicitudes activas.

const val CONNECTION_METRIC_UNKNOWN = -1: Int

Se desconoce el valor de una métrica de conexión.

const val EFFECTIVE_CONNECTION_TYPE_2G = 3: Int

La estimación del tipo de conexión real es 2G.

const val EFFECTIVE_CONNECTION_TYPE_3G = 4: Int

La estimación del tipo de conexión real es 3G.

const val EFFECTIVE_CONNECTION_TYPE_4G = 5: Int

La estimación del tipo de conexión real es 4G.

const val EFFECTIVE_CONNECTION_TYPE_OFFLINE = 1: Int

El dispositivo está sin conexión.

const val EFFECTIVE_CONNECTION_TYPE_SLOW_2G = 2: Int

La estimación del tipo de conexión real es 2G lenta.

const val EFFECTIVE_CONNECTION_TYPE_UNKNOWN = 0: Int

Se desconoce la estimación del tipo de conexión real.

const val UNBIND_NETWORK_HANDLE = -1: Long

Es el valor que se usará para deshacer cualquier vinculación de red anterior.

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

Registra un objeto de escucha que se llama después del final de cada solicitud con la información de la solicitud.

Se llama al objeto de escucha en un java.util.concurrent.Executor proporcionado por el objeto de escucha.

fun addRttListener(listener: NetworkQualityRttListener!): Unit

Registra un objeto de escucha que se llama cada vez que el estimador de calidad de la red observa un tiempo de ida y vuelta de muestra. Se debe llamar después de enableNetworkQualityEstimator y, de lo contrario, arrojará una excepción. Los tiempos de ida y vuelta se pueden registrar en varias capas de la pila de red, incluidas TCP, QUIC y la capa de solicitud de URL. Se llama al objeto de escucha en el java.util.concurrent.Executor que se pasa a enableNetworkQualityEstimator.

fun addThroughputListener(listener: NetworkQualityThroughputListener!): Unit

Registra un objeto de escucha que se llama cada vez que el estimador de calidad de la red observa una medición del rendimiento de la muestra. Se debe llamar después de enableNetworkQualityEstimator. Las observaciones de capacidad de procesamiento se calculan midiendo los bytes leídos a través de la interfaz de red activa en los momentos en que se recibe al menos una respuesta de URL. Se llama al objeto de escucha en el java.util.concurrent.Executor que se pasa a enableNetworkQualityEstimator.

fun bindToNetwork(networkHandle: Long): Unit

Vincula el motor al identificador de red especificado. Todas las solicitudes creadas a través de este motor usarán la red asociada a este identificador. Si se desconecta esta red, fallarán todas las solicitudes. El error exacto dependerá de la etapa de procesamiento de la solicitud en la que se desconecte la red. Los identificadores de red se pueden obtener a través de Network#getNetworkHandle. Solo disponible a partir de Android Marshmallow.

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

Configura el estimador de calidad de la red para las pruebas. Se debe llamar a este método antes de agregar los objetos de escucha del tiempo de ida y vuelta y la capacidad de procesamiento, y después de habilitar el estimador de calidad de la red.

abstract fun createURLStreamHandlerFactory(): URLStreamHandlerFactory!

Crea un URLStreamHandlerFactory para controlar el tráfico HTTP y HTTPS. Se puede instalar una instancia de esta clase a través de setURLStreamHandlerFactory, por lo que se usa este CronetEngine de forma predeterminada para todas las solicitudes creadas a través de openConnection.

Cronet no usa ciertas funciones de HTTP proporcionadas a través del sistema:

• La memoria caché de HTTP instalada a través de HttpResponseCache.install()
• El método de autenticación HTTP instalado a través de setDefault
• El almacenamiento de cookies HTTP instalado a través de setDefault

Si bien Cronet admite y recomienda las solicitudes que usan el protocolo HTTPS, no proporciona compatibilidad con la API de HttpsURLConnection. Esta falta de compatibilidad también incluye no usar ciertas funciones de HTTPS proporcionadas a través del sistema:

• El verificador de nombres de host HTTPS instalado a través de HttpsURLConnection.setDefaultHostnameVerifier()
• la fábrica de sockets HTTPS instalada a través de HttpsURLConnection.setDefaultSSLSocketFactory()

fun getActiveRequestCount(): Int

Devuelve la cantidad de solicitudes activas.

Una solicitud se vuelve "activa" en UrlRequest.start(), suponiendo que ese método no arroje una excepción. Se vuelve inactivo cuando todas las devoluciones de llamada se completaron y no se pueden activar devoluciones de llamada adicionales en el futuro. En la práctica, esto significa que la solicitud está inactiva una vez que se devolvieron onSucceeded/onCanceled/onFailed y todos los objetos de escucha de finalización de la solicitud. Ciclo de vida de las solicitudes de Cronet para obtener más información.

fun getDownstreamThroughputKbps(): Int

Devuelve la estimación de capacidad de procesamiento de descarga (en kilobits por segundo) que calcula el estimador de calidad de la red. Se establece en CONNECTION_METRIC_UNKNOWN si el valor no está disponible. Se debe llamar después de enableNetworkQualityEstimator; de lo contrario, se arrojará una excepción.

fun getEffectiveConnectionType(): Int

Devuelve una estimación del tipo de conexión efectiva que calcula el estimador de calidad de la red. Llama a enableNetworkQualityEstimator para comenzar a calcular este valor.

fun getHttpRttMs(): Int

Devuelve la estimación del RTT de HTTP (en milisegundos) que calcula el estimador de calidad de la red. Se establece en CONNECTION_METRIC_UNKNOWN si el valor no está disponible. Se debe llamar después de enableNetworkQualityEstimator; de lo contrario, se arrojará una excepción.

fun getTransportRttMs(): Int

Devuelve la estimación del RTT del transporte (en milisegundos) que calcula el estimador de calidad de la red. Se establece en CONNECTION_METRIC_UNKNOWN si el valor no está disponible. Se debe llamar después de enableNetworkQualityEstimator; de lo contrario, se arrojará una excepción.

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

Crea un compilador para UrlRequest. Todas las devoluciones de llamada para los objetos UrlRequest generados se invocarán en los subprocesos de executor. executor no debe ejecutar tareas en el subproceso que llama a execute para evitar bloquear las operaciones de red y provocar excepciones durante el cierre.

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

Establece una conexión nueva con el recurso especificado por URLurl.

Nota: La implementación de java.net.HttpURLConnection de Cronet está sujeta a ciertas limitaciones. Consulta createURLStreamHandlerFactory para obtener más detalles.

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

Quita un objeto de escucha de solicitud finalizada.

fun removeRttListener(listener: NetworkQualityRttListener!): Unit

Quita un objeto de escucha de los tiempos de viaje de ida y vuelta si se registró previamente con addRttListener. Se debe llamar después de que se agrega un NetworkQualityRttListener para dejar de recibir observaciones.

fun removeThroughputListener(listener: NetworkQualityThroughputListener!): Unit

Quita un objeto de escucha de rendimiento. Se debe llamar después de que se agregue un NetworkQualityThroughputListener con addThroughputListener para dejar de recibir observaciones.

abstract fun shutdown(): Unit

Cierra el CronetEngine si no hay solicitudes activas; de lo contrario, arroja una excepción.

No se puede llamar en el subproceso de red, el subproceso en el que Cronet llama a Executor (que es diferente del subproceso en el que Executor invoca devoluciones de llamada). Es posible que se bloquee hasta que se limpien todos los recursos de CronetEngine.

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

Inicia el registro de NetLog en un directorio especificado con un tamaño limitado. El registro de NetLog contendrá eventos emitidos por todos los objetos CronetEngine activos. NetLog es útil para la depuración. Una vez que se detenga el registro stopNetLog, los datos se escribirán en netlog.json en dirPath. Si se interrumpe el registro, puedes unir los archivos que se encuentran en el subdirectorio .inprogress de forma manual con https://chromium.googlesource.com/chromium/src/+/main/net/tools/stitch_net_log_files.py. El registro se puede ver con un navegador Chrome que navega a chrome://net-internals/#import.

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

Inicia el registro de NetLog en un archivo. El registro de NetLog contendrá eventos emitidos por todos los objetos CronetEngine activos. NetLog es útil para la depuración. El archivo se puede ver con un navegador Chrome que navega a chrome://net-internals/#import

abstract fun stopNetLog(): Unit

Detiene el registro de NetLog y vacía el archivo en el disco. Si no hay una sesión de registro en curso, se ignora esta llamada.