CronetEngine

abstract class CronetEngine

इस क्लास से सीधे इनहेरिट करने वाली ज्ञात सबक्लास
इस क्लास से सीधे इनहेरिट न करने वाली ज्ञात सबक्लास
JavaCronetEngine

java.net.HttpURLConnection ने CronetEngine का इस्तेमाल किया.


UrlRequest को प्रोसेस करने वाला इंजन, जो मौजूदा प्लैटफ़ॉर्म पर उपलब्ध सबसे अच्छे एचटीटीपी स्टैक का इस्तेमाल करता है. इस क्लास का इंस्टेंस, Builder का इस्तेमाल करके बनाया जा सकता है.

खास जानकारी

नेस्ट किए गए टाइप

यह CronetEngine के लिए बिल्डर है. इससे CronetEngine को रनटाइम के दौरान कॉन्फ़िगर किया जा सकता है.

यह एक ऐसी क्लास है जो क्रोनेट नेटिव लाइब्रेरी को लोड करने का तरीका उपलब्ध कराती है.

कॉन्स्टेंट

const Int

सक्रिय अनुरोधों की संख्या की वैल्यू के बारे में जानकारी नहीं है

const Int

कनेक्शन मेट्रिक की वैल्यू की जानकारी नहीं है.

const Int

कनेक्शन टाइप का अनुमान 2G है.

const Int

कनेक्शन टाइप का अनुमान 3G है.

const Int

कनेक्शन टाइप का अनुमान 4G है.

const Int

डिवाइस ऑफ़लाइन है.

const Int

कनेक्शन टाइप का अनुमान, धीमी 2G कनेक्टिविटी है.

const Int

कनेक्शन के असरदार टाइप के अनुमान के बारे में जानकारी नहीं है.

const Long

इस वैल्यू का इस्तेमाल, नेटवर्क बाइंडिंग को पहले जैसा करने के लिए किया जाता है.

सार्वजनिक कंस्ट्रक्टर

सार्वजनिक फ़ंक्शन

Unit

यह कुकी, एक लिसनर को रजिस्टर करती है. इस लिसनर को हर अनुरोध के खत्म होने के बाद, अनुरोध की जानकारी के साथ कॉल किया जाता है.

Unit

यह एक लिसनर रजिस्टर करता है. इसे तब कॉल किया जाता है, जब नेटवर्क क्वालिटी का अनुमान लगाने वाला टूल, सैंपल राउंड ट्रिप टाइम का पता लगाता है.

Unit

यह एक लिसनर रजिस्टर करता है. इसे तब कॉल किया जाता है, जब नेटवर्क क्वालिटी का अनुमान लगाने वाला टूल, थ्रूपुट के सैंपल का मेज़रमेंट करता है.

Unit
bindToNetwork(networkHandle: Long)

इस फ़ंक्शन की मदद से, इंजन को बताए गए नेटवर्क हैंडल से बाइंड किया जाता है.

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

यह कुकी, टेस्टिंग के लिए नेटवर्क क्वालिटी एस्टीमेटर को कॉन्फ़िगर करती है.

abstract URLStreamHandlerFactory!

यह कुकी, एचटीटीपी और एचटीटीपीएस ट्रैफ़िक को मैनेज करने के लिए URLStreamHandlerFactory बनाती है.

Int

यह फ़ंक्शन, चालू अनुरोधों की संख्या दिखाता है.

Int

यह फ़ंक्शन, नेटवर्क क्वालिटी एस्टीमेटर के ज़रिए कैलकुलेट किए गए डाउनस्ट्रीम थ्रूपुट के अनुमान को दिखाता है. यह अनुमान, किलोबिट प्रति सेकंड में होता है.

Int

यह फ़ंक्शन, नेटवर्क क्वालिटी एस्टीमेटर के हिसाब से, कनेक्शन टाइप का अनुमान दिखाता है.

abstract ByteArray<Byte>!

इस फ़ंक्शन का इस्तेमाल बंद कर दिया गया है.

Cronet के नए वर्शन में, यह हमेशा एक खाली कलेक्शन दिखाता है.

Int

यह फ़ंक्शन, नेटवर्क क्वालिटी एस्टीमेटर से कैलकुलेट किया गया एचटीटीपी आरटीटी का अनुमान (मिलीसेकंड में) दिखाता है.

Int

यह फ़ंक्शन, नेटवर्क क्वालिटी एस्टीमेटर के ज़रिए कैलकुलेट किया गया ट्रांसपोर्ट आरटीटी का अनुमान (मिलीसेकंड में) दिखाता है.

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

UrlRequest के लिए बिल्डर बनाता है.

abstract URLConnection!

यह कुकी, URLurl में बताए गए संसाधन से नया कनेक्शन बनाती है.

Unit

यह फ़ंक्शन, पूरा हो चुके अनुरोध के लिसनर को हटाता है.

Unit

अगर राउंड ट्रिप के समय की जानकारी पाने वाले किसी व्यक्ति ने पहले addRttListener के साथ रजिस्टर किया था, तो यह कुकी उसे हटा देती है.

Unit

यह थ्रूपुट के लिसनर को हटाता है.

abstract Unit

अगर कोई अनुरोध चालू नहीं है, तो CronetEngine को बंद कर देता है. ऐसा न होने पर, एक अपवाद दिखाता है.

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

यह NetLog की लॉगिंग को किसी तय डायरेक्ट्री में शुरू करता है. इसका साइज़ सीमित होता है.

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

यह विकल्प, किसी फ़ाइल में NetLog लॉगिंग शुरू करता है.

abstract Unit

यह NetLog लॉगिंग को बंद करता है और फ़ाइल को डिस्क में फ़्लश करता है.

कॉन्स्टेंट

ACTIVE_REQUEST_COUNT_UNKNOWN

const val ACTIVE_REQUEST_COUNT_UNKNOWN = -1: Int

सक्रिय अनुरोधों की संख्या की वैल्यू के बारे में जानकारी नहीं है

CONNECTION_METRIC_UNKNOWN

const val CONNECTION_METRIC_UNKNOWN = -1: Int

कनेक्शन मेट्रिक की वैल्यू की जानकारी नहीं है.

EFFECTIVE_CONNECTION_TYPE_2G

const val EFFECTIVE_CONNECTION_TYPE_2G = 3: Int

कनेक्शन टाइप का अनुमान 2G है.

इन्हें भी देखें
getEffectiveConnectionType

EFFECTIVE_CONNECTION_TYPE_3G

const val EFFECTIVE_CONNECTION_TYPE_3G = 4: Int

कनेक्शन टाइप का अनुमान 3G है.

इन्हें भी देखें
getEffectiveConnectionType

EFFECTIVE_CONNECTION_TYPE_4G

const val EFFECTIVE_CONNECTION_TYPE_4G = 5: Int

कनेक्शन टाइप का अनुमान 4G है.

इन्हें भी देखें
getEffectiveConnectionType

EFFECTIVE_CONNECTION_TYPE_OFFLINE

const val EFFECTIVE_CONNECTION_TYPE_OFFLINE = 1: Int

डिवाइस ऑफ़लाइन है.

इन्हें भी देखें
getEffectiveConnectionType

EFFECTIVE_CONNECTION_TYPE_SLOW_2G

const val EFFECTIVE_CONNECTION_TYPE_SLOW_2G = 2: Int

कनेक्शन टाइप का अनुमान, धीमी 2G कनेक्टिविटी है.

इन्हें भी देखें
getEffectiveConnectionType

EFFECTIVE_CONNECTION_TYPE_UNKNOWN

const val EFFECTIVE_CONNECTION_TYPE_UNKNOWN = 0: Int

कनेक्शन के असरदार टाइप के अनुमान के बारे में जानकारी नहीं है.

इन्हें भी देखें
getEffectiveConnectionType

UNBIND_NETWORK_HANDLE

const val UNBIND_NETWORK_HANDLE = -1: Long

इस वैल्यू का इस्तेमाल, नेटवर्क बाइंडिंग को पहले जैसा करने के लिए किया जाता है.

सार्वजनिक कंस्ट्रक्टर

CronetEngine

CronetEngine()

सार्वजनिक फ़ंक्शन

addRequestFinishedListener

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

यह कुकी, एक लिसनर को रजिस्टर करती है. इस लिसनर को हर अनुरोध के खत्म होने के बाद, अनुरोध की जानकारी के साथ कॉल किया जाता है.

लिसनर को, लिसनर की ओर से दिए गए java.util.concurrent.Executor पर कॉल किया जाता है.

पैरामीटर
listener: RequestFinishedInfo.Listener!

पूरे हो चुके अनुरोधों के लिए लिसनर.

addRttListener

fun addRttListener(listener: NetworkQualityRttListener!): Unit

यह एक लिसनर रजिस्टर करता है. इसे तब कॉल किया जाता है, जब नेटवर्क क्वालिटी का अनुमान लगाने वाला टूल, सैंपल राउंड ट्रिप टाइम का पता लगाता है. इसे enableNetworkQualityEstimator के बाद कॉल किया जाना चाहिए. ऐसा न करने पर, एक अपवाद थ्रो होगा. नेटवर्क स्टैक की अलग-अलग लेयर पर राउंड ट्रिप टाइम रिकॉर्ड किए जा सकते हैं. इनमें टीसीपी, क्यूयूआईसी, और यूआरएल अनुरोध लेयर शामिल हैं. लिसनर को उस java.util.concurrent.Executor पर कॉल किया जाता है जिसे enableNetworkQualityEstimator को पास किया जाता है.

पैरामीटर
listener: NetworkQualityRttListener!

दोतरफ़ा यात्रा के समय (आरटीटी) का पता लगाने वाला कुकी.

addThroughputListener

fun addThroughputListener(listener: NetworkQualityThroughputListener!): Unit

यह एक लिसनर रजिस्टर करता है. इसे तब कॉल किया जाता है, जब नेटवर्क क्वालिटी का अनुमान लगाने वाला टूल, थ्रूपुट के सैंपल का मेज़रमेंट करता है. इसे enableNetworkQualityEstimator के बाद कॉल किया जाना चाहिए. थ्रूपुट की जानकारी का हिसाब, सक्रिय नेटवर्क इंटरफ़ेस पर पढ़े गए बाइट को मेज़र करके लगाया जाता है. ऐसा तब किया जाता है, जब कम से कम एक यूआरएल रिस्पॉन्स मिल रहा हो. लिसनर को उस java.util.concurrent.Executor पर कॉल किया जाता है जिसे enableNetworkQualityEstimator को पास किया जाता है.

पैरामीटर
listener: NetworkQualityThroughputListener!

डेटा ट्रांसफ़र की दर को सुनने वाला.

bindToNetwork

fun bindToNetwork(networkHandle: Long): Unit

इस फ़ंक्शन की मदद से, इंजन को बताए गए नेटवर्क हैंडल से बाइंड किया जाता है. इस इंजन से किए गए सभी अनुरोधों के लिए, इस हैंडल से जुड़े नेटवर्क का इस्तेमाल किया जाएगा. अगर यह नेटवर्क डिसकनेक्ट हो जाता है, तो सभी अनुरोध पूरे नहीं किए जा सकेंगे. नेटवर्क डिसकनेक्ट होने पर, अनुरोध प्रोसेस करने की स्थिति के आधार पर गड़बड़ी की सटीक जानकारी मिलेगी. नेटवर्क हैंडल, Network#getNetworkHandle के ज़रिए पाए जा सकते हैं. यह सुविधा सिर्फ़ Android Marshmallow और इसके बाद के वर्शन पर उपलब्ध है.

पैरामीटर
networkHandle: Long

इंजन को बाइंड करने के लिए नेटवर्क हैंडल. अनबाइंड करने के लिए, UNBIND_NETWORK_HANDLE तय करें.

configureNetworkQualityEstimatorForTesting

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

यह कुकी, टेस्टिंग के लिए नेटवर्क क्वालिटी एस्टीमेटर को कॉन्फ़िगर करती है. इसे राउंड ट्रिप टाइम और थ्रूपुट लिसनर जोड़ने से पहले कॉल किया जाना चाहिए. साथ ही, नेटवर्क क्वालिटी एस्टीमेटर चालू होने के बाद कॉल किया जाना चाहिए.

पैरामीटर
useLocalHostRequests: Boolean

अनुमानों में लोकल होस्ट के अनुरोधों को शामिल करें.

useSmallerResponses: Boolean

थ्रूपुट के अनुमानों में छोटे जवाब शामिल किए जाते हैं.

disableOfflineCheck: Boolean

'सही है' पर सेट होने पर, यह डिवाइस के ऑफ़लाइन होने की जांच को बंद कर देता है. ऐसा तब होता है, जब कनेक्शन के असरदार टाइप का हिसाब लगाया जा रहा हो या जब प्राथमिकताओं को लिखा जा रहा हो.

createURLStreamHandlerFactory

abstract fun createURLStreamHandlerFactory(): URLStreamHandlerFactory!

यह कुकी, एचटीटीपी और एचटीटीपीएस ट्रैफ़िक को मैनेज करने के लिए URLStreamHandlerFactory बनाती है. इस क्लास के इंस्टेंस को setURLStreamHandlerFactory के ज़रिए इंस्टॉल किया जा सकता है. इस तरह, openConnection के ज़रिए बनाए गए सभी अनुरोधों के लिए, डिफ़ॉल्ट रूप से इस CronetEngine का इस्तेमाल किया जाता है.

Cronet, सिस्टम के ज़रिए उपलब्ध कराई गई कुछ एचटीटीपी सुविधाओं का इस्तेमाल नहीं करता:

  • HttpResponseCache.install() के ज़रिए इंस्टॉल की गई एचटीटीपी कैश मेमोरी
  • setDefault के ज़रिए इंस्टॉल किया गया एचटीटीपी ऑथेंटिकेशन का तरीका
  • setDefault के ज़रिए इंस्टॉल किया गया एचटीटीपी कुकी स्टोरेज

Cronet, एचटीटीपीएस प्रोटोकॉल का इस्तेमाल करके किए गए अनुरोधों के साथ काम करता है और उन्हें बढ़ावा देता है. हालांकि, Cronet, HttpsURLConnection एपीआई के साथ काम नहीं करता. सिस्टम के ज़रिए उपलब्ध कराई गई कुछ एचटीटीपीएस सुविधाओं का इस्तेमाल न करना भी, इस सुविधा के काम न करने की वजह हो सकती है:

रिटर्न
URLStreamHandlerFactory!

यह CronetEngine, URLStreamHandlerFactory इंस्टेंस को लागू करता है.

getActiveRequestCount

fun getActiveRequestCount(): Int

यह फ़ंक्शन, चालू अनुरोधों की संख्या दिखाता है.

UrlRequest.start() में अनुरोध "ऐक्टिव" हो जाता है. हालांकि, ऐसा तब होता है, जब यह तरीका कोई अपवाद नहीं दिखाता. यह तब बंद हो जाता है, जब सभी कॉलबैक वापस आ जाते हैं और आने वाले समय में कोई और कॉलबैक ट्रिगर नहीं किया जा सकता. इसका मतलब है कि onSucceeded/onCanceled/onFailed के वापस आने और अनुरोध पूरा होने के सभी लिसनर के वापस आने के बाद, अनुरोध बंद हो जाता है. ज़्यादा जानकारी के लिए, Cronet के अनुरोधों का लाइफ़साइकल देखें.

getDownstreamThroughputKbps

fun getDownstreamThroughputKbps(): Int

यह फ़ंक्शन, नेटवर्क क्वालिटी एस्टीमेटर के ज़रिए कैलकुलेट किए गए डाउनस्ट्रीम थ्रूपुट के अनुमान को दिखाता है. यह अनुमान, किलोबिट प्रति सेकंड में होता है. अगर वैल्यू उपलब्ध नहीं है, तो इसे CONNECTION_METRIC_UNKNOWN पर सेट करें. इसे enableNetworkQualityEstimator के बाद कॉल किया जाना चाहिए. ऐसा न करने पर, अपवाद दिखेगा.

रिटर्न
Int

किलोबिट प्रति सेकंड में डाउनस्ट्रीम थ्रूपुट का अनुमान.

getEffectiveConnectionType

fun getEffectiveConnectionType(): Int

यह फ़ंक्शन, नेटवर्क क्वालिटी एस्टीमेटर के हिसाब से, कनेक्शन टाइप का अनुमान दिखाता है. इस वैल्यू की गिनती शुरू करने के लिए, enableNetworkQualityEstimator को कॉल करें.

रिटर्न
Int

कनेक्शन का अनुमानित टाइप. यह फ़ंक्शन, EFFECTIVE_CONNECTION_TYPE_* में से कोई एक वैल्यू दिखाता है.

getGlobalMetricsDeltas

abstract fun getGlobalMetricsDeltas(): ByteArray<Byte>!

getHttpRttMs

fun getHttpRttMs(): Int

यह फ़ंक्शन, नेटवर्क क्वालिटी एस्टीमेटर से कैलकुलेट किया गया एचटीटीपी आरटीटी का अनुमान (मिलीसेकंड में) दिखाता है. अगर वैल्यू उपलब्ध नहीं है, तो इसे CONNECTION_METRIC_UNKNOWN पर सेट करें. इसे enableNetworkQualityEstimator के बाद कॉल किया जाना चाहिए. ऐसा न करने पर, अपवाद दिखेगा.

रिटर्न
Int

मिलीसेकंड में, एचटीटीपी आरटीटी का अनुमान.

getTransportRttMs

fun getTransportRttMs(): Int

यह फ़ंक्शन, नेटवर्क क्वालिटी एस्टीमेटर के ज़रिए कैलकुलेट किया गया ट्रांसपोर्ट आरटीटी का अनुमान (मिलीसेकंड में) दिखाता है. अगर वैल्यू उपलब्ध नहीं है, तो इसे CONNECTION_METRIC_UNKNOWN पर सेट करें. इसे enableNetworkQualityEstimator के बाद कॉल किया जाना चाहिए. ऐसा न करने पर, अपवाद दिखेगा.

रिटर्न
Int

ट्रांसपोर्ट आरटीटी का अनुमान, मिलीसेकंड में.

getVersionString

abstract fun getVersionString(): String!
रिटर्न
String!

इंजन के वर्शन की ऐसी स्ट्रिंग जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है.

newUrlRequestBuilder

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

UrlRequest के लिए बिल्डर बनाता है. जनरेट किए गए UrlRequest ऑब्जेक्ट के लिए सभी कॉलबैक, executor के थ्रेड पर लागू किए जाएंगे. executor को, execute को कॉल करने वाले थ्रेड पर टास्क नहीं चलाने चाहिए. इससे नेटवर्क से जुड़ी कार्रवाइयों को ब्लॉक होने से रोका जा सकेगा. साथ ही, शटडाउन के दौरान अपवादों को होने से रोका जा सकेगा.

पैरामीटर
url: String!

जनरेट किए गए अनुरोधों के लिए यूआरएल.

callback: UrlRequest.Callback!

कॉलबैक ऑब्जेक्ट, जिसे अलग-अलग इवेंट पर शुरू किया जाता है.

executor: Executor!

Executor जिस पर सभी कॉलबैक लागू किए जाएंगे.

openConnection

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

यह कुकी, URLurl में बताए गए संसाधन से नया कनेक्शन बनाती है.

ध्यान दें: Cronet के java.net.HttpURLConnection को लागू करने से जुड़ी कुछ सीमाएं हैं. ज़्यादा जानकारी के लिए, createURLStreamHandlerFactory देखें.

पैरामीटर
url: URL!

कनेक्ट किए जाने वाले संसाधन का यूआरएल.

रिटर्न
URLConnection!

यह CronetEngine, java.net.HttpURLConnection इंस्टेंस को लागू करता है.

थ्रो
java.io.IOException

कनेक्शन खोलते समय कोई गड़बड़ी होने पर.

removeRequestFinishedListener

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

यह फ़ंक्शन, पूरा हो चुके अनुरोध के लिसनर को हटाता है.

पैरामीटर
listener: RequestFinishedInfo.Listener!

को हटाने का अनुरोध किया गया है.

removeRttListener

fun removeRttListener(listener: NetworkQualityRttListener!): Unit

अगर राउंड ट्रिप के समय की जानकारी पाने वाले किसी व्यक्ति ने पहले addRttListener के साथ रजिस्टर किया था, तो यह कुकी उसे हटा देती है. निगरानी की सुविधा बंद करने के लिए, NetworkQualityRttListener जोड़ने के बाद इस फ़ंक्शन को कॉल किया जाना चाहिए.

पैरामीटर
listener: NetworkQualityRttListener!

दोतरफ़ा यात्रा के समय (आरटीटी) का पता लगाने वाला कुकी.

removeThroughputListener

fun removeThroughputListener(listener: NetworkQualityThroughputListener!): Unit

यह थ्रूपुट के लिसनर को हटाता है. निगरानी की सुविधा बंद करने के लिए, NetworkQualityThroughputListener को addThroughputListener के साथ जोड़ने के बाद इस फ़ंक्शन को कॉल किया जाना चाहिए.

पैरामीटर
listener: NetworkQualityThroughputListener!

डेटा ट्रांसफ़र की दर को सुनने वाला.

बंद करना

abstract fun shutdown(): Unit

अगर कोई अनुरोध चालू नहीं है, तो CronetEngine को बंद कर देता है. ऐसा न होने पर, एक अपवाद दिखाता है.

इसे नेटवर्क थ्रेड पर कॉल नहीं किया जा सकता. यह थ्रेड, Cronet को Executor पर कॉल करता है. यह थ्रेड, Executor के कॉल बैक को शुरू करने वाले थ्रेड से अलग होता है. जब तक सभी CronetEngine के संसाधनों को साफ़ नहीं कर दिया जाता, तब तक यह ब्लॉक हो सकता है.

startNetLogToDisk

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

यह 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 पर जाकर देखा जा सकता है.

पैरामीटर
dirPath: String!

वह डायरेक्ट्री जहां netlog.json फ़ाइल बनाई जाएगी. dirPath पहले से मौजूद होना चाहिए. डायरेक्ट्री में NetLog फ़ाइलें मौजूद नहीं होनी चाहिए. अगर लॉगिंग चालू है, तो इस तरीके को अनदेखा कर दिया जाता है.

logAll: Boolean

true ताकि लॉग में बुनियादी इवेंट, उपयोगकर्ता की कुकी, क्रेडेंशियल, और ट्रांसफ़र किए गए सभी बाइट शामिल किए जा सकें. इस विकल्प से निजता को खतरा हो सकता है, क्योंकि इससे उपयोगकर्ता के क्रेडेंशियल का पता चलता है. इसलिए, इसका इस्तेमाल सिर्फ़ उपयोगकर्ता की सहमति से और उन स्थितियों में किया जाना चाहिए जहां लॉग सार्वजनिक नहीं होगा. false को सिर्फ़ बुनियादी इवेंट शामिल करने के लिए इस्तेमाल करें.

maxSize: Int

NetLog को डिस्क में ज़्यादा से ज़्यादा कितनी जगह इस्तेमाल करनी चाहिए. यह वैल्यू बाइट में होती है. डिस्क में इस्तेमाल की गई जगह, इस सीमा से थोड़ी ज़्यादा हो सकती है.

startNetLogToFile

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

यह विकल्प, किसी फ़ाइल में NetLog लॉगिंग शुरू करता है. NetLog में, सभी लाइव CronetEngine से जनरेट हुए इवेंट शामिल होंगे. NetLog, डीबग करने के लिए काम का होता है. इस फ़ाइल को Chrome ब्राउज़र में देखा जा सकता है. इसके लिए, chrome://net-internals/#import पर जाएं

पैरामीटर
fileName: String!

फ़ाइल का पूरा पाथ. यह खाली नहीं होना चाहिए. अगर फ़ाइल मौजूद है, तो इसे शुरू करने से पहले छोटा कर दिया जाता है. अगर लॉगिंग चालू है, तो इस तरीके को अनदेखा कर दिया जाता है.

logAll: Boolean

true ताकि लॉग में बुनियादी इवेंट, उपयोगकर्ता की कुकी, क्रेडेंशियल, और ट्रांसफ़र किए गए सभी बाइट शामिल किए जा सकें. इस विकल्प से निजता को खतरा हो सकता है, क्योंकि इससे उपयोगकर्ता के क्रेडेंशियल का पता चलता है. इसलिए, इसका इस्तेमाल सिर्फ़ उपयोगकर्ता की सहमति से और उन स्थितियों में किया जाना चाहिए जहां लॉग सार्वजनिक नहीं होगा. false को सिर्फ़ बुनियादी इवेंट शामिल करने के लिए इस्तेमाल करें.

stopNetLog

abstract fun stopNetLog(): Unit

यह NetLog लॉगिंग को बंद करता है और फ़ाइल को डिस्क में फ़्लश करता है. अगर कोई लॉगिंग सेशन चालू नहीं है, तो इस कॉल को अनदेखा कर दिया जाता है.