CronetEngine

abstract class CronetEngine

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

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


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

खास जानकारी

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

CronetEngine के लिए बिल्डर, जो CronetEngine के रनटाइम कॉन्फ़िगरेशन की अनुमति देता है.

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

minSDK <= 23 पर System.loadLibrary भरोसेमंद नहीं था. इस तरीके का इस्तेमाल, ज़्यादा भरोसेमंद लोडर उपलब्ध कराने के लिए किया गया था.

कॉन्स्टेंट

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 के बाद कॉल किया जाना चाहिए. ऐसा न होने पर, यह एक अपवाद थ्रो करेगा. राउंड ट्रिप टाइम को नेटवर्क स्टैक की अलग-अलग लेयर पर रिकॉर्ड किया जा सकता है. जैसे, टीसीपी, QUIC, और यूआरएल अनुरोध लेयर पर. लिसनर को उस 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 लॉगिंग को बंद करता है और फ़ाइल को डिस्क पर सेव करता है. अगर कोई लॉगिंग सेशन चालू नहीं है, तो इस कॉल को अनदेखा कर दिया जाता है.