CronetEngine

public static final int ACTIVE_REQUEST_COUNT_UNKNOWN = -1

O valor da contagem de solicitações ativas é desconhecido

public static final int CONNECTION_METRIC_UNKNOWN = -1

O valor de uma métrica de conexão é desconhecido.

public static final int EFFECTIVE_CONNECTION_TYPE_2G = 3

A estimativa do tipo de conexão vigente é 2G.

public static final int EFFECTIVE_CONNECTION_TYPE_3G = 4

A estimativa do tipo de conexão vigente é 3G.

public static final int EFFECTIVE_CONNECTION_TYPE_4G = 5

A estimativa do tipo de conexão vigente é 4G.

public static final int EFFECTIVE_CONNECTION_TYPE_OFFLINE = 1

O dispositivo está off-line.

public static final int EFFECTIVE_CONNECTION_TYPE_SLOW_2G = 2

A estimativa do tipo de conexão vigente é 2G lenta.

public static final int EFFECTIVE_CONNECTION_TYPE_UNKNOWN = 0

A estimativa do tipo de conexão vigente é desconhecida.

public static final long UNBIND_NETWORK_HANDLE = -1

O valor a ser usado para desfazer qualquer vinculação de rede anterior.

public void addRequestFinishedListener(RequestFinishedInfo.Listener listener)

Registra um listener que é chamado após o fim de cada solicitação com as informações dela.

O listener é chamado em um java.util.concurrent.Executor fornecido por ele.

public void addRttListener(NetworkQualityRttListener listener)

Registra um listener que é chamado sempre que o estimador de qualidade da rede detecta um tempo de ida e volta de amostra. Ele precisa ser chamado após enableNetworkQualityEstimator. Caso contrário, uma exceção será gerada. Os tempos de retorno podem ser registrados em várias camadas da pilha de rede, incluindo TCP, QUIC e na camada de solicitação de URL. O listener é chamado no java.util.concurrent.Executor transmitido para enableNetworkQualityEstimator.

public void addThroughputListener(NetworkQualityThroughputListener listener)

Registra um listener que é chamado sempre que o estimador de qualidade da rede testemunha uma medição de capacidade de processamento de amostra. Ele precisa ser chamado depois de enableNetworkQualityEstimator. As observações de capacidade de processamento são calculadas medindo os bytes lidos na interface de rede ativa quando pelo menos uma resposta de URL está sendo recebida. O listener é chamado no java.util.concurrent.Executor transmitido para enableNetworkQualityEstimator.

public void bindToNetwork(long networkHandle)

Vincula o mecanismo ao identificador de rede especificado. Todas as solicitações criadas por esse mecanismo vão usar a rede associada a esse identificador. Se essa rede for desconectada, todas as solicitações vão falhar. O erro exato vai depender da etapa de processamento da solicitação quando a rede for desconectada. Os identificadores de rede podem ser obtidos usando Network#getNetworkHandle. Disponível apenas a partir do Android Marshmallow.

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

Configura o estimador de qualidade da rede para testes. Isso precisa ser chamado antes da adição dos listeners de tempo de retorno e de capacidade de processamento e depois que o estimador de qualidade da rede for ativado.

public abstract URLStreamHandlerFactory createURLStreamHandlerFactory()

Cria um URLStreamHandlerFactory para processar o tráfego HTTP e HTTPS. Uma instância dessa classe pode ser instalada via setURLStreamHandlerFactory, usando assim esse CronetEngine por padrão para todas as solicitações criadas via openConnection.

O Cronet não usa determinados recursos HTTP fornecidos pelo sistema:

• o cache HTTP instalado via HttpResponseCache.install()
• o método de autenticação HTTP instalado via setDefault
• o armazenamento de cookies HTTP instalado via setDefault

Embora a Cronet ofereça suporte e incentive solicitações usando o protocolo HTTPS, ela não oferece suporte à API HttpsURLConnection. Essa falta de suporte também inclui não usar determinados recursos HTTPS fornecidos pelo sistema:

• o verificador de nome do host HTTPS instalado via HttpsURLConnection.setDefaultHostnameVerifier()
• a fábrica de sockets HTTPS instalada via HttpsURLConnection.setDefaultSSLSocketFactory()

public int getActiveRequestCount()

Retorna o número de solicitações ativas.

Uma solicitação se torna "ativa" em UrlRequest.start(), supondo que esse método não gere uma exceção. Ele fica inativo quando todos os callbacks são retornados e nenhum outro pode ser acionado no futuro. Na prática, isso significa que a solicitação fica inativa quando onSucceeded/onCanceled/onFailed é retornado e todos os listeners de solicitação concluída são retornados. Ciclo de vida das solicitações da Cronet para mais informações.

public int getDownstreamThroughputKbps()

Retorna a estimativa de capacidade de downstream (em quilobits por segundo) calculada pelo estimador de qualidade da rede. Defina como CONNECTION_METRIC_UNKNOWN se o valor não estiver disponível. Ele precisa ser chamado depois de enableNetworkQualityEstimator. Caso contrário, uma exceção será gerada.

public int getEffectiveConnectionType()

Retorna uma estimativa do tipo de conexão efetivo calculado pelo estimador de qualidade da rede. Chame enableNetworkQualityEstimator para começar a calcular esse valor.

public int getHttpRttMs()

Retorna a estimativa de RTT HTTP (em milissegundos) calculada pelo estimador de qualidade da rede. Defina como CONNECTION_METRIC_UNKNOWN se o valor não estiver disponível. Ele precisa ser chamado depois de enableNetworkQualityEstimator. Caso contrário, uma exceção será gerada.

public int getTransportRttMs()

Retorna a estimativa de RTT de transporte (em milissegundos) calculada pelo estimador de qualidade da rede. Defina como CONNECTION_METRIC_UNKNOWN se o valor não estiver disponível. Ele precisa ser chamado depois de enableNetworkQualityEstimator. Caso contrário, uma exceção será gerada.

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

Cria um builder para UrlRequest. Todos os callbacks para objetos UrlRequest gerados serão invocados nas linhas de execução de executor. executor não pode executar tarefas na linha de execução que chama execute para evitar o bloqueio de operações de rede e causar exceções durante o desligamento.

public abstract URLConnection openConnection(URL url)

Estabelece uma nova conexão com o recurso especificado pelo URLurl.

Observação:a implementação do java.net.HttpURLConnection do Cronet está sujeita a algumas limitações. Consulte createURLStreamHandlerFactory para mais detalhes.

public void removeRequestFinishedListener(RequestFinishedInfo.Listener listener)

Remove um listener de solicitação concluída.

public void removeRttListener(NetworkQualityRttListener listener)

Remove um listener de tempos de ida e volta se ele tiver sido registrado anteriormente com addRttListener. Isso precisa ser chamado depois que um NetworkQualityRttListener é adicionado para parar de receber observações.

public void removeThroughputListener(NetworkQualityThroughputListener listener)

Remove um listener de taxa de transferência. Isso precisa ser chamado depois que um NetworkQualityThroughputListener é adicionado com addThroughputListener para interromper o recebimento de observações.

public abstract void shutdown()

Desliga o CronetEngine se não houver solicitações ativas. Caso contrário, gera uma exceção.

Não pode ser chamado na linha de execução de rede. A linha de execução que o Cronet chama no Executor é diferente da linha de execução em que o Executor invoca callbacks. Pode bloquear até que todos os recursos do CronetEngine sejam limpos.

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

Inicia o registro do NetLog em um diretório especificado com um tamanho limitado. O NetLog vai conter eventos emitidos por todos os CronetEngines ativos. O NetLog é útil para depuração. Quando o registro for interrompido stopNetLog, os dados serão gravados em netlog.json em dirPath. Se o registro for interrompido, você poderá juntar os arquivos encontrados no subdiretório .inprogress manualmente usando: https://chromium.googlesource.com/chromium/src/+/main/net/tools/stitch_net_log_files.py. O registro pode ser visualizado usando um navegador Chrome em chrome://net-internals/#import.

public abstract void startNetLogToFile(String fileName, boolean logAll)

Inicia o registro do NetLog em um arquivo. O NetLog vai conter eventos emitidos por todos os CronetEngines ativos. O NetLog é útil para depuração. O arquivo pode ser visualizado usando um navegador Chrome em chrome://net-internals/#import

public abstract void stopNetLog()

Interrompe o registro do NetLog e libera o arquivo no disco. Se uma sessão de geração de registros não estiver em andamento, essa chamada será ignorada.