CronetEngine

public static final int ACTIVE_REQUEST_COUNT_UNKNOWN = -1

Il valore del conteggio delle richieste attive è sconosciuto

public static final int CONNECTION_METRIC_UNKNOWN = -1

Il valore di una metrica di connessione è sconosciuto.

public static final int EFFECTIVE_CONNECTION_TYPE_2G = 3

La stima del tipo effettivo di connessione è 2G.

public static final int EFFECTIVE_CONNECTION_TYPE_3G = 4

La stima del tipo effettivo di connessione è 3G.

public static final int EFFECTIVE_CONNECTION_TYPE_4G = 5

La stima del tipo effettivo di connessione è 4G.

public static final int EFFECTIVE_CONNECTION_TYPE_OFFLINE = 1

Il dispositivo è offline.

public static final int EFFECTIVE_CONNECTION_TYPE_SLOW_2G = 2

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

public static final int EFFECTIVE_CONNECTION_TYPE_UNKNOWN = 0

La stima del tipo effettivo di connessione è sconosciuta.

public static final long UNBIND_NETWORK_HANDLE = -1

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

public void addRequestFinishedListener(RequestFinishedInfo.Listener listener)

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.

public void addRttListener(NetworkQualityRttListener listener)

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.

public void addThroughputListener(NetworkQualityThroughputListener listener)

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.

public void bindToNetwork(long networkHandle)

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.

public void configureNetworkQualityEstimatorForTesting(
    boolean useLocalHostRequests,
    boolean useSmallerResponses,
    boolean disableOfflineCheck
)

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.

public abstract URLStreamHandlerFactory createURLStreamHandlerFactory()

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()

public int getActiveRequestCount()

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.

public int getDownstreamThroughputKbps()

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.

public int getEffectiveConnectionType()

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.

public int getHttpRttMs()

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.

public int getTransportRttMs()

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.

public abstract UrlRequest.Builder newUrlRequestBuilder(
    String url,
    UrlRequest.Callback callback,
    Executor executor
)

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.

public abstract URLConnection openConnection(URL url)

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.

public void removeRequestFinishedListener(RequestFinishedInfo.Listener listener)

Rimuove un listener di richieste completate.

public void removeRttListener(NetworkQualityRttListener listener)

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.

public void removeThroughputListener(NetworkQualityThroughputListener listener)

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

public abstract void shutdown()

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.

public void startNetLogToDisk(String dirPath, boolean logAll, int maxSize)

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.

public abstract void startNetLogToFile(String fileName, boolean logAll)

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

public abstract void stopNetLog()

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