CronetEngine

const val ACTIVE_REQUEST_COUNT_UNKNOWN = -1: Int

Il valore del conteggio delle richieste attive è sconosciuto

const val CONNECTION_METRIC_UNKNOWN = -1: Int

Il valore di una metrica di connessione è sconosciuto.

const val EFFECTIVE_CONNECTION_TYPE_2G = 3: Int

La stima del tipo effettivo di connessione è 2G.

const val EFFECTIVE_CONNECTION_TYPE_3G = 4: Int

La stima del tipo effettivo di connessione è 3G.

const val EFFECTIVE_CONNECTION_TYPE_4G = 5: Int

La stima del tipo effettivo di connessione è 4G.

const val EFFECTIVE_CONNECTION_TYPE_OFFLINE = 1: Int

Il dispositivo è offline.

const val EFFECTIVE_CONNECTION_TYPE_SLOW_2G = 2: Int

La stima del tipo effettivo di connessione è 2G lento.

const val EFFECTIVE_CONNECTION_TYPE_UNKNOWN = 0: Int

La stima del tipo effettivo di connessione è sconosciuta.

const val UNBIND_NETWORK_HANDLE = -1: Long

Il valore da utilizzare per annullare qualsiasi associazione di rete precedente.

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

Registra un listener che viene chiamato dopo la fine di ogni richiesta con le informazioni sulla richiesta.

Il listener viene chiamato su un java.util.concurrent.Executor fornito dal listener.

fun addRttListener(listener: NetworkQualityRttListener!): Unit

Registra un listener che viene chiamato ogni volta che lo strumento di stima della qualità della rete rileva un tempo di andata e ritorno del campione. Questo metodo deve essere chiamato dopo enableNetworkQualityEstimator e genererà un'eccezione in caso contrario. I tempi di andata e ritorno possono essere registrati in vari livelli dello stack di rete, tra cui TCP, QUIC e nel livello di richiesta URL. Il listener viene chiamato sul java.util.concurrent.Executor passato a enableNetworkQualityEstimator.

fun addThroughputListener(listener: NetworkQualityThroughputListener!): Unit

Registra un listener che viene chiamato ogni volta che lo strumento di stima della qualità della rete rileva una misurazione della velocità effettiva del campione. Deve essere chiamato dopo enableNetworkQualityEstimator. Le osservazioni sul throughput vengono calcolate misurando i byte letti sull'interfaccia di rete attiva nei momenti in cui viene ricevuta almeno una risposta URL. Il listener viene chiamato sul java.util.concurrent.Executor passato a enableNetworkQualityEstimator.

fun bindToNetwork(networkHandle: Long): Unit

Esegue il binding del motore all'handle di rete specificato. Tutte le richieste create tramite questo motore utilizzeranno la rete associata a questo handle. Se questa rete si disconnette, tutte le richieste non andranno a buon fine. L'errore esatto dipende dalla fase di elaborazione della richiesta al momento della disconnessione della rete. Gli handle di rete possono essere ottenuti tramite Network#getNetworkHandle. Disponibile solo a partire da Android Marshmallow.

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

Configura lo strumento di stima della qualità della rete per i test. Questo metodo deve essere chiamato prima che vengano aggiunti i listener del tempo di andata e ritorno e del throughput e dopo che è stato attivato lo strumento di stima della qualità della rete.

abstract fun createURLStreamHandlerFactory(): URLStreamHandlerFactory!

Crea un URLStreamHandlerFactory per gestire il traffico HTTP e HTTPS. Un'istanza di questa classe può essere installata tramite setURLStreamHandlerFactory, utilizzando così questo CronetEngine per impostazione predefinita per tutte le richieste create tramite openConnection.

Cronet non utilizza determinate funzionalità HTTP fornite tramite il sistema:

• la cache HTTP installata tramite HttpResponseCache.install()
• il metodo di autenticazione HTTP installato tramite setDefault
• lo spazio di archiviazione dei cookie HTTP installato tramite setDefault

Sebbene Cronet supporti e incoraggi le richieste che utilizzano il protocollo HTTPS, non fornisce supporto per l'API HttpsURLConnection. Questa mancanza di supporto include anche il mancato utilizzo di determinate funzionalità HTTPS fornite tramite il sistema:

• il programma di verifica del nome host HTTPS installato tramite HttpsURLConnection.setDefaultHostnameVerifier()
• la factory di socket HTTPS installata tramite HttpsURLConnection.setDefaultSSLSocketFactory()

fun getActiveRequestCount(): Int

Restituisce il numero di richieste attive.

Una richiesta diventa "attiva" in UrlRequest.start(), supponendo che il metodo non generi un'eccezione. Diventa inattivo quando tutti i callback sono stati restituiti e non è possibile attivare callback aggiuntivi in futuro. In pratica, la richiesta è inattiva una volta che onSucceeded/onCanceled/onFailed è stato restituito e tutti i listener di fine richiesta sono stati restituiti. Ciclo di vita delle richieste Cronet per ulteriori informazioni.

fun getDownstreamThroughputKbps(): Int

Restituisce la stima della velocità effettiva downstream (in kilobit al secondo) calcolata dallo strumento di stima della qualità della rete. Imposta CONNECTION_METRIC_UNKNOWN se il valore non è disponibile. Questo metodo deve essere chiamato dopo enableNetworkQualityEstimator, altrimenti verrà generata un'eccezione.

fun getEffectiveConnectionType(): Int

Restituisce una stima del tipo di connessione effettivo calcolato dallo strumento di stima della qualità della rete. Chiama enableNetworkQualityEstimator per iniziare a calcolare questo valore.

fun getHttpRttMs(): Int

Restituisce la stima del RTT HTTP (in millisecondi) calcolata dallo strumento di stima della qualità della rete. Imposta CONNECTION_METRIC_UNKNOWN se il valore non è disponibile. Questo metodo deve essere chiamato dopo enableNetworkQualityEstimator, altrimenti verrà generata un'eccezione.

fun getTransportRttMs(): Int

Restituisce la stima dell'RTT di trasporto (in millisecondi) calcolata dallo strumento di stima della qualità della rete. Imposta CONNECTION_METRIC_UNKNOWN se il valore non è disponibile. Questo metodo deve essere chiamato dopo enableNetworkQualityEstimator, altrimenti verrà generata un'eccezione.

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

Crea un builder per UrlRequest. Tutte le callback per gli oggetti UrlRequest generati verranno richiamate sui thread di executor. executor non deve eseguire attività sul thread che chiama execute per evitare di bloccare le operazioni di rete e causare eccezioni durante l'arresto.

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

Stabilisce una nuova connessione alla risorsa specificata da URLurl.

Nota:l'implementazione di java.net.HttpURLConnection di Cronet è soggetta a determinate limitazioni. Per ulteriori dettagli, consulta createURLStreamHandlerFactory.

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

Rimuove un listener di richieste completate.

fun removeRttListener(listener: NetworkQualityRttListener!): Unit

Rimuove un listener dei tempi di andata e ritorno se registrato in precedenza con addRttListener. Questo metodo deve essere chiamato dopo l'aggiunta di un NetworkQualityRttListener per interrompere la ricezione delle osservazioni.

fun removeThroughputListener(listener: NetworkQualityThroughputListener!): Unit

Rimuove un listener di throughput. Questo metodo deve essere chiamato dopo l'aggiunta di un NetworkQualityThroughputListener con addThroughputListener per interrompere la ricezione delle osservazioni.

abstract fun shutdown(): Unit

Arresta CronetEngine se non ci sono richieste attive, altrimenti genera un'eccezione.

Non può essere chiamato sul thread di rete, ovvero il thread in cui Cronet chiama Executor (che è diverso dal thread in cui Executor richiama i callback). Potrebbe bloccare fino a quando non saranno state rimosse tutte le risorse di CronetEngine.

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

Avvia la registrazione di NetLog in una directory specificata con una dimensione limitata. Il log di rete conterrà gli eventi emessi da tutti i CronetEngine attivi. Il log di rete è utile per il debug. Una volta interrotta la registrazione stopNetLog, i dati verranno scritti in netlog.json in dirPath. Se la registrazione viene interrotta, puoi unire manualmente i file trovati nella sottodirectory .inprogress utilizzando: https://chromium.googlesource.com/chromium/src/+/main/net/tools/stitch_net_log_files.py. Il log può essere visualizzato utilizzando un browser Chrome all'indirizzo chrome://net-internals/#import.

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

Avvia la registrazione di NetLog in un file. Il log di rete conterrà gli eventi emessi da tutti i CronetEngine attivi. Il log di rete è utile per il debug. Il file può essere visualizzato utilizzando un browser Chrome all'indirizzo chrome://net-internals/#import

abstract fun stopNetLog(): Unit

Interrompe la registrazione di NetLog e scarica il file sul disco. Se non è in corso una sessione di registrazione, questa chiamata viene ignorata.