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