CronetEngine.Builder

const val HTTP_CACHE_DISABLED = 0: Int

एचटीटीपी कैश मेमोरी को बंद करने की सेटिंग. कुछ डेटा अब भी कुछ समय के लिए मेमोरी में सेव किया जा सकता है. enableHttpCache को पास किया गया.

const val HTTP_CACHE_DISK = 3: Int

इस सेटिंग का इस्तेमाल, डिस्क पर मौजूद कैश मेमोरी को चालू करने के लिए किया जाता है. इसमें एचटीटीपी डेटा भी शामिल है. इस कॉन्स्टेंट को enableHttpCache में पास करने से पहले, setStoragePath को कॉल करना ज़रूरी है.

const val HTTP_CACHE_DISK_NO_HTTP = 2: Int

इस सेटिंग का इस्तेमाल, डिस्क पर मौजूद कैश मेमोरी को चालू करने के लिए किया जाता है. इसमें एचटीटीपी डेटा शामिल नहीं होता. इस कॉन्स्टेंट को enableHttpCache में पास करने से पहले, setStoragePath को कॉल करना ज़रूरी है.

const val HTTP_CACHE_IN_MEMORY = 1: Int

एचटीटीपी डेटा के साथ-साथ, इन-मेमोरी एचटीटीपी कैश मेमोरी को चालू करने की सेटिंग. enableHttpCache को पास किया गया.

Builder(context: Context!)

यह एक Builder ऑब्जेक्ट बनाता है, जिससे CronetEngine बनाने में मदद मिलती है. डिफ़ॉल्ट कॉन्फ़िगरेशन में, HTTP/2 और QUIC चालू होते हैं. हालांकि, इसमें एचटीटीपी कैश मेमोरी बंद होती है.

fun addPublicKeyPins(
    hostName: String!,
    pinsSha256: (Mutable)Set<ByteArray!>!,
    includeSubdomains: Boolean,
    expirationDate: Date!
): CronetEngine.Builder!

यह कुकी, किसी होस्ट के लिए सार्वजनिक कुंजियों का सेट पिन करती है. सार्वजनिक कुंजियों का एक सेट पिन करने पर, pinsSha256 को hostName के साथ कम्यूनिकेट करना होता है. ऐसा इसलिए, ताकि पिन किए गए सेट की सार्वजनिक कुंजी वाले सर्टिफ़िकेट से पुष्टि की जा सके. कोई ऐप्लिकेशन, रूट सर्टिफ़िकेट, किसी भी इंटरमीडिएट सर्टिफ़िकेट या एंड-एंट्री सर्टिफ़िकेट के सार्वजनिक पासकोड को पिन कर सकता है. अगर होस्ट की सर्टिफ़िकेट चेन में कोई भी सार्वजनिक कुंजी मौजूद नहीं है, तो पुष्टि नहीं हो पाएगी और सुरक्षित कम्यूनिकेशन नहीं हो पाएगा. भले ही, होस्ट उस सर्टिफ़िकेट से पुष्टि करने की कोशिश करे जिसे डिवाइस के भरोसेमंद सर्टिफ़िकेट स्टोर से अनुमति मिली है.

एक ही होस्ट के नाम के साथ इस तरीके को कई बार कॉल करने पर, होस्ट के लिए पहले से सेट किए गए पिन बदल जाते हैं.

पब्लिक की पिनिंग के बारे में ज़्यादा जानकारी के लिए, आरएफ़सी 7469 पर जाएं.

fun addQuicHint(host: String!, port: Int, alternatePort: Int): CronetEngine.Builder!

यह कुकी, इस बात का सुझाव देती है कि host QUIC प्रोटोकॉल के साथ काम करता है. ध्यान दें कि सेशन के बीच 0-RTT कनेक्शन का फ़ायदा पाने के लिए, enableHttpCache (HTTP_CACHE_DISK) ज़रूरी है.

fun build(): CronetEngine!

इस बिल्डर के कॉन्फ़िगरेशन का इस्तेमाल करके, CronetEngine बनाएं.

fun enableBrotli(value: Boolean): CronetEngine.Builder!

यह कुकी सेट करती है कि Brotli कंप्रेशन चालू है या नहीं. इस विकल्प को चालू करने पर, Accept-Encoding अनुरोध हेडर में Brotli का विज्ञापन दिखाया जाएगा. डिफ़ॉल्ट रूप से, यह सुविधा बंद होती है.

fun enableHttp2(value: Boolean): CronetEngine.Builder!

यह कुकी सेट करती है कि HTTP/2 प्रोटोकॉल चालू है या नहीं. यह डिफ़ॉल्ट रूप से चालू होता है.

fun enableHttpCache(cacheMode: Int, maxSize: Long): CronetEngine.Builder!

यह कुकी, एचटीटीपी डेटा और अन्य जानकारी को कैश मेमोरी में सेव करने की सुविधा को चालू या बंद करती है. जैसे, QUIC सर्वर की जानकारी.

fun enableNetworkQualityEstimator(value: Boolean): CronetEngine.Builder!

यह नेटवर्क क्वालिटी एस्टिमेटर को चालू करता है. यह नेटवर्क स्टैक की अलग-अलग लेयर पर, राउंड ट्रिप टाइम (आरटीटी) और डाउनस्ट्रीम थ्रूपुट के मेज़रमेंट इकट्ठा करता है और उनकी रिपोर्ट बनाता है. अनुमान लगाने की सुविधा चालू करने के बाद, आरटीटी और थ्रूपुट के लिसनर को addRttListener और addThroughputListener की मदद से जोड़ा जा सकता है. साथ ही, removeRttListener और removeThroughputListener की मदद से हटाया जा सकता है. अनुमान लगाने वाला टूल, मेमोरी और सीपीयू का इस्तेमाल सिर्फ़ तब करता है, जब इसे चालू किया जाता है.

fun enablePublicKeyPinningBypassForLocalTrustAnchors(value: Boolean): CronetEngine.Builder!

यह नीति, लोकल ट्रस्ट ऐंकर के लिए सार्वजनिक कुंजी पिनिंग बायपास करने की सुविधा को चालू या बंद करती है. लोकल ट्रस्ट ऐंकर के लिए, बायपास करने की सुविधा बंद करने का सुझाव नहीं दिया जाता. ऐसा इसलिए, क्योंकि इससे ऐप्लिकेशन को पिन किए गए होस्ट के साथ कम्यूनिकेट करने से रोका जा सकता है. उदाहरण के लिए, कोई उपयोगकर्ता डिवाइस की प्रॉक्सी सेटिंग बदलकर और प्रॉक्सी सर्टिफ़िकेट को लोकल ट्रस्ट ऐंकर की सूची में जोड़कर, सभी ट्रैफ़िक को एसएसएल की सुविधा वाली प्रॉक्सी के ज़रिए भेजना चाहे. बाइपास करने की सुविधा बंद करने पर, हो सकता है कि ऐप्लिकेशन पिन किए गए होस्ट को कोई ट्रैफ़िक न भेज पाए. ज़्यादा जानकारी के लिए, https://www.chromium.org/Home/chromium-security/security-faq पर 'How does key pinning interact with local proxies and filters?' लेख पढ़ें

fun enableQuic(value: Boolean): CronetEngine.Builder!

इस नीति से यह तय किया जाता है कि QUIC प्रोटोकॉल चालू है या नहीं. यह डिफ़ॉल्ट रूप से चालू होता है. अगर QUIC चालू है, तो QUIC User Agent Id को सर्वर पर भेजा जाता है. इसमें ऐप्लिकेशन का नाम और Cronet का वर्शन शामिल होता है.

fun getDefaultUserAgent(): String!

यह कुकी, User-Agent स्ट्रिंग बनाती है. इसमें ऐप्लिकेशन का नाम और वर्शन, सिस्टम बिल्ड वर्शन, मॉडल और आईडी, और Cronet वर्शन शामिल होता है.

@ConnectionMigrationOptions.Experimental
fun setConnectionMigrationOptions(
    connectionMigrationOptions: ConnectionMigrationOptions!
): CronetEngine.Builder!

यह कुकी, कनेक्शन माइग्रेशन के तरीके को कॉन्फ़िगर करती है. ज़्यादा जानकारी के लिए, ConnectionMigrationOptions और ConnectionMigrationOptions.Builder के अलग-अलग तरीकों के दस्तावेज़ देखें.

यह सिर्फ़ तब काम करता है, जब enableQuic चालू हो.

@DnsOptions.Experimental
fun setDnsOptions(dnsOptions: DnsOptions!): CronetEngine.Builder!

यह कुकी, होस्टनेम लुकअप के व्यवहार को कॉन्फ़िगर करती है. ज़्यादा जानकारी के लिए, DnsOptions और DnsOptions.Builder के अलग-अलग तरीकों के दस्तावेज़ देखें.

यह सिर्फ़ तब काम करता है, जब enableQuic चालू हो.

fun setLibraryLoader(loader: CronetEngine.Builder.LibraryLoader!): CronetEngine.Builder!

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

fun setProxyOptions(proxyOptions: ProxyOptions): CronetEngine.Builder!

यह कुकी, प्रॉक्सी के व्यवहार को कॉन्फ़िगर करती है. इससे इन पर अलग-अलग तरीकों से असर पड़ता है: कनेक्शन बनाना, UrlRequest, और BidirectionalStream. ज़्यादा जानकारी के लिए, Proxy का दस्तावेज़ देखें.

इसे प्रॉक्सी कॉन्फ़िगरेशन के साथ भ्रमित नहीं किया जाना चाहिए. प्रॉक्सी कॉन्फ़िगरेशन को इन लोगों या कंपनियों ने सेट अप किया है: उपयोगकर्ता; कुछ एंटरप्राइज़ प्रोफ़ाइल कॉन्फ़िगरेशन या (ज़्यादातर मामलों में) कुछ नेटवर्क ऑटो कॉन्फ़िगरेशन (जैसे, वेब प्रॉक्सी ऑटो-डिस्कवरी प्रोटोकॉल). इसे आम तौर पर "सिस्टम" प्रॉक्सी कॉन्फ़िगरेशन कहा जाता है. अगर यह मौजूद है, तो लोकल और/या इंटरनेट कनेक्टिविटी पाने के लिए, सिस्टम के प्रॉक्सी कॉन्फ़िगरेशन का पालन करना ज़रूरी होता है. CronetEngine, सिस्टम प्रॉक्सी कॉन्फ़िगरेशन को पहले से ही अंदरूनी तौर पर मैनेज करता है.

इस एपीआई के ज़रिए तय किए गए प्रॉक्सी कॉन्फ़िगरेशन को "ऐप्लिकेशन" प्रॉक्सी कॉन्फ़िगरेशन कहा जाता है. ऐप्लिकेशन और सिस्टम प्रॉक्सी कॉन्फ़िगरेशन अलग-अलग होते हैं. साथ ही, ये एक-दूसरे से अलग होते हैं. फ़िलहाल, ऐप्लिकेशन और सिस्टम प्रॉक्सी कॉन्फ़िगरेशन एक-दूसरे से अलग होते हैं: अगर सिस्टम प्रॉक्सी कॉन्फ़िगरेशन मौजूद है, तो ProxyOptions को सेट करने पर वह कॉन्फ़िगरेशन बदल जाता है. इससे कुछ मामलों में कनेक्टिविटी की समस्याएं हो सकती हैं. ऐसा तब होता है, जब सिस्टम प्रॉक्सी कॉन्फ़िगरेशन मौजूद हो. ऐसे मामलों में, उपयोगकर्ताओं के पास इंटरनेट का ऐक्सेस नहीं होगा. हालांकि, अगर ProxyOptions को फ़ाइनल, null, फ़ॉलबैक के साथ कॉन्फ़िगर किया गया है, तो ऐसा नहीं होगा. ProxyOptions का दस्तावेज़ पढ़ें.

@QuicOptions.Experimental
fun setQuicOptions(quicOptions: QuicOptions!): CronetEngine.Builder!

QUIC का इस्तेमाल करते समय, Cronet के व्यवहार को कॉन्फ़िगर करता है. ज़्यादा जानकारी के लिए, QuicOptions और QuicOptions.Builder के अलग-अलग तरीकों के दस्तावेज़ देखें.

यह सिर्फ़ तब काम करता है, जब enableQuic चालू हो.

fun setStoragePath(value: String!): CronetEngine.Builder!

यह कुकी, एचटीटीपी कैश मेमोरी और कुकी स्टोरेज के लिए डायरेक्ट्री सेट करती है. निर्देशिका मौजूद होनी चाहिए.

ध्यान दें: एक ही स्टोरेज डायरेक्ट्री का इस्तेमाल, एक से ज़्यादा CronetEngine के साथ एक बार में न करें. स्टोरेज डायरेक्ट्री का ऐक्सेस, एक साथ कई CronetEngine को नहीं दिया जा सकता.

fun setThreadPriority(priority: Int): CronetEngine.Builder!

Cronet के इंटरनल थ्रेड की प्राथमिकता सेट करता है.

fun setUserAgent(userAgent: String!): CronetEngine.Builder!

यह सभी अनुरोधों के लिए, User-Agent हेडर को बदलता है. addHeader का इस्तेमाल करके सेट किया गया User-Agent हेडर, इस फ़ंक्शन का इस्तेमाल करके सेट की गई वैल्यू को बदल देगा.

protected val mParsedExperimentalOptions: JSONObject!

एक्सपेरिमेंट के विकल्पों को JSON फ़ॉर्मैट में दिखाया गया है.