CronetEngine.Builder

const val HTTP_CACHE_DISABLED = 0: Int

การตั้งค่าเพื่อปิดใช้แคช HTTP ระบบอาจยังคงจัดเก็บข้อมูลบางอย่างไว้ในหน่วยความจำชั่วคราว ส่งต่อให้ enableHttpCache

const val HTTP_CACHE_DISK = 3: Int

การตั้งค่าเพื่อเปิดใช้แคชในดิสก์ รวมถึงข้อมูล HTTP ต้องเรียกใช้ setStoragePath ก่อนส่งค่าคงที่นี้ไปยัง enableHttpCache

const val HTTP_CACHE_DISK_NO_HTTP = 2: Int

การตั้งค่าเพื่อเปิดใช้แคชในดิสก์ โดยไม่รวมข้อมูล HTTP ต้องเรียกใช้ setStoragePath ก่อนส่งค่าคงที่นี้ไปยัง enableHttpCache

const val HTTP_CACHE_IN_MEMORY = 1: Int

การตั้งค่าเพื่อเปิดใช้แคช HTTP ในหน่วยความจำ รวมถึงข้อมูล HTTP ส่งต่อให้ enableHttpCache

Builder(context: Context!)

สร้างออบเจ็กต์ Builder ที่ช่วยสร้าง CronetEngine การกำหนดค่าเริ่มต้นจะเปิดใช้ HTTP/2 และ QUIC แต่ปิดใช้แคช HTTP

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

ปักหมุดชุดคีย์สาธารณะสำหรับโฮสต์ที่กำหนด การปักหมุดชุดคีย์สาธารณะทำให้ pinsSha256 ต้องสื่อสารกับ hostName เพื่อตรวจสอบสิทธิ์ด้วยใบรับรองที่มีคีย์สาธารณะจากชุดที่ปักหมุดไว้ แอปสามารถตรึงคีย์สาธารณะของใบรับรองรูท ใบรับรองระดับกลาง หรือใบรับรองรายการสุดท้าย การตรวจสอบสิทธิ์จะล้มเหลวและจะไม่มีการสื่อสารที่ปลอดภัยหากไม่มีคีย์สาธารณะใดๆ ในห่วงโซ่ใบรับรองของโฮสต์ แม้ว่าโฮสต์จะพยายามตรวจสอบสิทธิ์ด้วยใบรับรองที่ได้รับอนุญาตจากที่เก็บใบรับรองที่เชื่อถือได้ของอุปกรณ์ก็ตาม

การเรียกใช้เมธอดนี้หลายครั้งด้วยชื่อโฮสต์เดียวกันจะลบล้างพินที่ตั้งไว้ก่อนหน้านี้สำหรับโฮสต์

ดูข้อมูลเพิ่มเติมเกี่ยวกับการตรึงคีย์สาธารณะได้ใน RFC 7469

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

เพิ่มคำแนะนำว่า host รองรับ QUIC โปรดทราบว่าต้องใช้ enableHttpCache (HTTP_CACHE_DISK) เพื่อใช้ประโยชน์จากการสร้างการเชื่อมต่อ 0-RTT ระหว่างเซสชัน

fun build(): CronetEngine!

สร้าง CronetEngine โดยใช้การกำหนดค่าของบิลด์นี้

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

กำหนดว่าจะเปิดใช้การบีบอัด Brotli หรือไม่ หากเปิดใช้ ระบบจะโฆษณา Brotli ในส่วนหัวของคำขอ Accept-Encoding ค่าเริ่มต้นคือปิดใช้

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

ตั้งค่าว่าจะเปิดใช้โปรโตคอล HTTP/2 หรือไม่ ค่าเริ่มต้นคือเปิดใช้

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

เปิดหรือปิดใช้การแคชข้อมูล HTTP และข้อมูลอื่นๆ เช่น ข้อมูลเซิร์ฟเวอร์ QUIC

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

เปิดใช้เครื่องมือประมาณคุณภาพเครือข่าย ซึ่งจะรวบรวมและรายงานการวัดเวลาในการรับส่ง (RTT) และปริมาณงานขาลงที่เลเยอร์ต่างๆ ของสแต็กเครือข่าย หลังจากเปิดใช้ตัวประมาณแล้ว คุณจะเพิ่มผู้ฟัง RTT และอัตราการส่งข้อมูลได้ด้วย addRttListener และ addThroughputListener รวมถึงนำออกได้ด้วย removeRttListener และ removeThroughputListener เครื่องมือประมาณจะใช้หน่วยความจำและ CPU เมื่อเปิดใช้เท่านั้น

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

เปิดใช้หรือปิดใช้การข้ามการปักหมุดคีย์สาธารณะสำหรับ Trust Anchor ในเครื่อง เราไม่แนะนำอย่างยิ่งให้ปิดใช้การข้ามสำหรับจุดยึดความน่าเชื่อถือในเครื่อง เนื่องจากอาจทำให้แอปสื่อสารกับโฮสต์ที่ปักหมุดไม่ได้ เช่น ผู้ใช้อาจต้องการส่งการรับส่งข้อมูลทั้งหมดผ่านพร็อกซีที่เปิดใช้ SSL โดยเปลี่ยนการตั้งค่าพร็อกซีของอุปกรณ์และเพิ่มใบรับรองพร็อกซีลงในรายการ Trust Anchor ในเครื่อง การปิดใช้การข้ามจะทำให้แอปไม่ส่งการเข้าชมไปยังโฮสต์ที่ปักหมุดไว้ ดูข้อมูลเพิ่มเติมได้ที่ "Key Pinning ทำงานร่วมกับพร็อกซีและตัวกรองในเครื่องอย่างไร" ที่ https://www.chromium.org/Home/chromium-security/security-faq

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

ตั้งค่าว่าจะเปิดใช้โปรโตคอล QUIC หรือไม่ ค่าเริ่มต้นคือเปิดใช้ หากเปิดใช้ QUIC ระบบจะส่งรหัส User-Agent ของ QUIC ที่มีชื่อแอปพลิเคชันและเวอร์ชัน 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 จัดการการกำหนดค่าพร็อกซีของระบบภายในอยู่แล้ว

การกำหนดค่าพร็อกซีที่กำหนดผ่าน API นี้เรียกว่าการกำหนดค่าพร็อกซี "แอป" การกำหนดค่าพร็อกซีของแอปและระบบจะแยกกัน และที่สำคัญคือแตกต่างกัน ปัจจุบันการกำหนดค่าพร็อกซีของแอปและระบบจะแยกกัน โดยการระบุ ProxyOptions จะลบล้างการกำหนดค่าพร็อกซีของระบบ หากมี ซึ่งอาจทำให้เกิดปัญหาการเชื่อมต่อในบางสถานการณ์ที่มีการกำหนดค่าพร็อกซีของระบบ ในสถานการณ์ดังกล่าว ผู้ใช้อาจไม่มีสิทธิ์เข้าถึงอินเทอร์เน็ต เว้นแต่จะมีการกำหนดค่า ProxyOptions ด้วย null สุดท้ายเป็นตัวสำรอง โปรดดูเอกสารประกอบของ ProxyOptions

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

กำหนดค่าลักษณะการทำงานของ Cronet เมื่อใช้ QUIC ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบของ QuicOptions และเมธอดแต่ละรายการของ QuicOptions.Builder

เกี่ยวข้องเฉพาะในกรณีที่เปิดใช้ enableQuic

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

กำหนดไดเรกทอรีสำหรับแคช HTTP และที่เก็บคุกกี้ ไดเรกทอรีต้องมีอยู่

หมายเหตุ: อย่าใช้ไดเรกทอรีพื้นที่เก็บข้อมูลเดียวกันกับ CronetEngine มากกว่า 1 รายการในครั้งเดียว การเข้าถึงไดเรกทอรีที่เก็บข้อมูลไม่รองรับการเข้าถึงพร้อมกันโดย CronetEngine หลายรายการ

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

กำหนดลำดับความสำคัญของชุดข้อความภายในของ Cronet

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

ลบล้างส่วนหัว User-Agent สำหรับคำขอทั้งหมด ส่วนหัว User-Agent ที่ตั้งค่าอย่างชัดเจน (ตั้งค่าโดยใช้ addHeader) จะลบล้างค่าที่ตั้งค่าโดยใช้ฟังก์ชันนี้

protected val mParsedExperimentalOptions: JSONObject!

การแสดงตัวเลือกทดลองในรูปแบบ JSON