JavaCronetEngine

public void addRequestFinishedListener(RequestFinishedInfo.Listener listener)

注册一个监听器，该监听器会在每个请求结束后被调用，并提供请求信息。

监听器是在监听器提供的 java.util.concurrent.Executor 上调用的。

public void addRttListener(NetworkQualityRttListener listener)

注册一个监听器，每当网络质量估算器检测到样本往返时间时，该监听器就会被调用。必须在 enableNetworkQualityEstimator 之后调用，否则会抛出异常。往返时间可能会在网络堆栈的各个层（包括 TCP、QUIC 和网址请求层）记录。监听器是在传递给 enableNetworkQualityEstimator 的 java.util.concurrent.Executor 上调用的。

public void addThroughputListener(NetworkQualityThroughputListener listener)

注册一个监听器，每当网络质量估算器检测到吞吐量测量样本时，该监听器都会被调用。必须在 enableNetworkQualityEstimator 之后调用此方法。吞吐量观测结果是通过在至少收到一个网址响应时测量活动网络接口上读取的字节数来计算的。监听器是在传递给 enableNetworkQualityEstimator 的 java.util.concurrent.Executor 上调用的。

public void bindToNetwork(long networkHandle)

将引擎绑定到指定的网络句柄。通过此引擎创建的所有请求都将使用与此句柄关联的网络。如果此网络断开连接，所有请求都会失败，具体错误取决于网络断开连接时请求处理的阶段。可以通过 Network#getNetworkHandle 获取网络句柄。仅从 Android Marshmallow 开始提供。

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

配置网络质量估算器以进行测试。必须在添加往返时间和吞吐量监听器之前调用此方法，并且在启用网络质量估算器之后调用此方法。

public URLStreamHandlerFactory createURLStreamHandlerFactory()

创建 URLStreamHandlerFactory 以处理 HTTP 和 HTTPS 流量。可以通过 setURLStreamHandlerFactory 安装此类的实例，从而默认将此 CronetEngine 用于通过 openConnection 创建的所有请求。

Cronet 不会使用通过系统提供的某些 HTTP 功能：

• 通过 HttpResponseCache.install() 安装的 HTTP 缓存
• 通过 setDefault 安装的 HTTP 身份验证方法
• 通过 setDefault 安装的 HTTP Cookie 存储空间

虽然 Cronet 支持并鼓励使用 HTTPS 协议发送请求，但 Cronet 不支持 HttpsURLConnection API。不支持还包括不使用系统提供的某些 HTTPS 功能：

• 通过 HttpsURLConnection.setDefaultHostnameVerifier() 安装的 HTTPS 主机名验证器
• 通过 HttpsURLConnection.setDefaultSSLSocketFactory() 安装的 HTTPS 套接字工厂

public int getActiveRequestCount()

返回有效请求的数量。

假设 UrlRequest.start() 方法未抛出异常，则请求会在该方法中变为“有效”。当所有回调都已返回且未来无法触发其他回调时，它会变为非活动状态。在实践中，这意味着一旦 onSucceeded/onCanceled/onFailed 返回且所有请求完成监听器都已返回，请求就会变为不活跃状态。如需了解详情，请参阅 Cronet 请求的生命周期。

public int getDownstreamThroughputKbps()

返回由网络质量估算器计算的下行吞吐量估计值（以千比特/秒为单位）。如果值不可用，则设置为 CONNECTION_METRIC_UNKNOWN。必须在 enableNetworkQualityEstimator 之后调用此方法，否则会抛出异常。

public int getEffectiveConnectionType()

返回由网络质量估算器计算出的有效连接类型估计值。调用 enableNetworkQualityEstimator 以开始计算此值。

public int getHttpRttMs()

返回由网络质量估算器计算出的 HTTP RTT 估计值（以毫秒为单位）。如果值不可用，则设置为 CONNECTION_METRIC_UNKNOWN。必须在 enableNetworkQualityEstimator 之后调用此方法，否则会抛出异常。

public int getTransportRttMs()

返回由网络质量估算器计算出的传输 RTT 估计值（以毫秒为单位）。如果值不可用，则设置为 CONNECTION_METRIC_UNKNOWN。必须在 enableNetworkQualityEstimator 之后调用此方法，否则会抛出异常。

public URLConnection openConnection(URL url)

与 URLurl 指定的资源建立新连接。

注意：Cronet 的 java.net.HttpURLConnection 实现存在某些限制，详情请参阅 createURLStreamHandlerFactory。

public URLConnection openConnection(URL url, Proxy proxy)

使用给定的代理与 URLurl 指定的资源建立新连接。

注意：Cronet 的 java.net.HttpURLConnection 实现存在某些限制，详情请参阅 createURLStreamHandlerFactory。

public void removeRequestFinishedListener(RequestFinishedInfo.Listener listener)

移除已完成的请求监听器。

public void removeRttListener(NetworkQualityRttListener listener)

移除往返时间监听器（如果之前已通过 addRttListener 注册）。应在添加 NetworkQualityRttListener 后调用此方法，以停止接收观测结果。

public void removeThroughputListener(NetworkQualityThroughputListener listener)

移除吞吐量监听器。应在添加了包含 addThroughputListener 的 NetworkQualityThroughputListener 后调用此方法，以停止接收观测结果。

public void shutdown()

如果没有有效请求，则关闭 CronetEngine；否则抛出异常。

无法在网络线程上调用 - Cronet 调用到执行器的线程（与执行器调用回调的线程不同）。可能会阻塞，直到所有 CronetEngine 的资源都已清理完毕。

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

开始将 NetLog 记录到指定目录，并限制大小。NetLog 将包含所有有效 CronetEngine 发出的事件。NetLog 可用于调试。日志记录停止 stopNetLog 后，数据将写入 dirPath 中的 netlog.json。如果日志记录中断，您可以使用以下网址手动拼接 .inprogress 子目录中的文件：https://chromium.googlesource.com/chromium/src/+/main/net/tools/stitch_net_log_files.py。您可以使用 Chrome 浏览器前往 chrome://net-internals/#import 查看日志。

public void startNetLogToFile(String fileName, boolean logAll)

开始将 NetLog 记录到文件。NetLog 将包含所有有效 CronetEngine 发出的事件。NetLog 可用于调试。您可以使用 Chrome 浏览器前往 chrome://net-internals/#import 查看该文件

public void stopNetLog()

停止 NetLog 日志记录并将文件刷新到磁盘。如果日志记录会话未在进行中，则忽略此调用。