ConnectionMigrationOptions.Builder

class ConnectionMigrationOptions.Builder


บิลเดอร์สำหรับ ConnectionMigrationOptions

สรุป

ฟังก์ชันสาธารณะ

ConnectionMigrationOptions.Builder!

กำหนดว่าการเชื่อมต่อจะย้ายไปยังเครือข่ายอื่นได้หรือไม่เมื่อ Cronet ตรวจพบว่าเส้นทางที่ใช้อยู่ในปัจจุบันมีประสิทธิภาพลดลง

ConnectionMigrationOptions.Builder!

เปิดใช้ความเป็นไปได้ในการย้ายการเชื่อมต่อไปยังที่อยู่เซิร์ฟเวอร์อื่นตามคำขอของเซิร์ฟเวอร์

ConnectionMigrationOptions!

สร้างและแสดงผลอินสแตนซ์ ConnectionMigrationOptions สุดท้ายตามค่าในบิลเดอร์นี้

ConnectionMigrationOptions.Builder!
enableDefaultNetworkMigration(
    enableDefaultNetworkConnectionMigration: Boolean
)

เปิดใช้ความเป็นไปได้ในการย้ายการเชื่อมต่อเมื่อมีการเปลี่ยนแปลงเครือข่ายเริ่มต้น

ConnectionMigrationOptions.Builder!

เปิดใช้ความเป็นไปได้ในการย้ายการเชื่อมต่อหากเส้นทางปัจจุบันมีประสิทธิภาพไม่ดี

ConnectionMigrationOptions.Builder!

กำหนดค่าว่าจะเปิดใช้การย้ายการเชื่อมต่อที่ไม่ได้ใช้งานหรือไม่

ConnectionMigrationOptions.Builder!

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

ConnectionMigrationOptions.Builder!

กำหนดระยะเวลาที่ไม่ได้ใช้งานสูงสุดเป็นวินาทีที่การเชื่อมต่อจะยังคงย้ายได้

ConnectionMigrationOptions.Builder!

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

ConnectionMigrationOptions.Builder!

กำหนดระยะเวลาสูงสุดที่การเชื่อมต่อที่ย้ายข้อมูลอย่างรวดเร็วควรอยู่ในเครือข่ายที่ไม่ใช่ค่าเริ่มต้นก่อนที่จะย้ายกลับ

ConnectionMigrationOptions.Builder!

กำหนดจำนวนการย้ายข้อมูลสูงสุดไปยังเครือข่ายที่ไม่ใช่ค่าเริ่มต้นเมื่อพบข้อผิดพลาดในการเขียน

ฟังก์ชันสาธารณะ

allowNonDefaultNetworkUsage

@ConnectionMigrationOptions.Experimental
fun allowNonDefaultNetworkUsage(enable: Boolean): ConnectionMigrationOptions.Builder!

กำหนดว่าการเชื่อมต่อจะย้ายไปยังเครือข่ายอื่นได้หรือไม่เมื่อ Cronet ตรวจพบว่าเส้นทางที่ใช้อยู่ในปัจจุบันมีประสิทธิภาพลดลง

หมายเหตุ: การตั้งค่านี้อาจทำให้มีการส่งคำขอในเครือข่ายแบบคิดค่าบริการที่ไม่ใช่ค่าเริ่มต้น ตรวจสอบว่าคุณใช้เครือข่ายแบบคิดค่าบริการอย่างประหยัด และปรับแต่งพารามิเตอร์ เช่น setMaxPathDegradingNonDefaultNetworkMigrationsCount และ setMaxTimeOnNonDefaultNetworkSeconds เพื่อจำกัดเวลาในเครือข่ายที่ไม่ใช่ค่าเริ่มต้น

แสดงผล
ConnectionMigrationOptions.Builder!

เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

allowServerMigration

@ConnectionMigrationOptions.Experimental
fun allowServerMigration(allowServerMigration: Boolean): ConnectionMigrationOptions.Builder!

เปิดใช้ความเป็นไปได้ในการย้ายการเชื่อมต่อไปยังที่อยู่เซิร์ฟเวอร์อื่นตามคำขอของเซิร์ฟเวอร์

แสดงผล
ConnectionMigrationOptions.Builder!

เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

build

fun build(): ConnectionMigrationOptions!

สร้างและแสดงผลอินสแตนซ์ ConnectionMigrationOptions สุดท้ายตามค่าในบิลเดอร์นี้

enableDefaultNetworkMigration

fun enableDefaultNetworkMigration(
    enableDefaultNetworkConnectionMigration: Boolean
): ConnectionMigrationOptions.Builder!

เปิดใช้ความเป็นไปได้ในการย้ายการเชื่อมต่อเมื่อมีการเปลี่ยนแปลงเครือข่ายเริ่มต้น หากเปิดใช้ ระบบจะย้ายการเชื่อมต่อ QUIC ที่ใช้งานอยู่ไปยังเครือข่ายใหม่เมื่อแพลตฟอร์มระบุว่าเครือข่ายเริ่มต้นกำลังเปลี่ยนแปลง

แสดงผล
ConnectionMigrationOptions.Builder!

เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

enablePathDegradationMigration

fun enablePathDegradationMigration(enable: Boolean): ConnectionMigrationOptions.Builder!

เปิดใช้ความเป็นไปได้ในการย้ายการเชื่อมต่อหากเส้นทางปัจจุบันมีประสิทธิภาพไม่ดี

การดำเนินการนี้อาจส่งผลให้มีการย้ายการเชื่อมต่อภายในเครือข่ายเริ่มต้นเดียวกัน หรือไปยังเครือข่ายที่ไม่ใช่ค่าเริ่มต้น ทั้งนี้ขึ้นอยู่กับการกำหนดค่าอื่นๆ

แสดงผล
ConnectionMigrationOptions.Builder!

เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

ดูเพิ่มเติม
allowNonDefaultNetworkUsage

migrateIdleConnections

@ConnectionMigrationOptions.Experimental
fun migrateIdleConnections(migrateIdleConnections: Boolean): ConnectionMigrationOptions.Builder!

กำหนดค่าว่าจะเปิดใช้การย้ายการเชื่อมต่อที่ไม่ได้ใช้งานหรือไม่

หากตั้งค่าเป็น "จริง" ระบบจะย้ายการเชื่อมต่อที่ไม่มีการใช้งานด้วย ตราบใดที่การเชื่อมต่อดังกล่าวไม่ได้ไม่มีการใช้งานนานเกินไป การตั้งค่านี้ใช้ร่วมกันสำหรับการย้ายการเชื่อมต่อทุกประเภท คุณสามารถปรับแต่งระยะเวลาที่ไม่ได้ใช้งานสูงสุดที่การเชื่อมต่อจะยังคงย้ายได้โดยใช้ setIdleConnectionMigrationPeriodSeconds

แสดงผล
ConnectionMigrationOptions.Builder!

เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

retryPreHandshakeErrorsOnNonDefaultNetwork

@ConnectionMigrationOptions.Experimental
fun retryPreHandshakeErrorsOnNonDefaultNetwork(
    retryPreHandshakeErrorsOnAlternateNetwork: Boolean
): ConnectionMigrationOptions.Builder!

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

หากตั้งค่าเป็น "จริง" ระบบอาจสร้างการเชื่อมต่อใหม่ในเครือข่ายอื่นหากการเชื่อมต่อล้มเหลวในเครือข่ายเริ่มต้นก่อนที่จะมีการยืนยันการแฮนด์เชค

หมายเหตุ: การตั้งค่านี้อาจทำให้มีการส่งคำขอในเครือข่ายแบบคิดค่าบริการที่ไม่ใช่ค่าเริ่มต้นเช่นเดียวกับ allowNonDefaultNetworkUsage โปรดใช้ด้วยความระมัดระวัง

แสดงผล
ConnectionMigrationOptions.Builder!

เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

setIdleConnectionMigrationPeriodSeconds

@ConnectionMigrationOptions.Experimental
fun setIdleConnectionMigrationPeriodSeconds(
    idleConnectionMigrationPeriodSeconds: Long
): ConnectionMigrationOptions.Builder!

กำหนดระยะเวลาที่ไม่ได้ใช้งานสูงสุดเป็นวินาทีที่การเชื่อมต่อจะยังคงย้ายได้ การตั้งค่านี้ใช้ร่วมกันสำหรับการย้ายการเชื่อมต่อทุกประเภท

การตั้งค่านี้จะเกี่ยวข้องก็ต่อเมื่อเปิดใช้ migrateIdleConnections

แสดงผล
ConnectionMigrationOptions.Builder!

เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

setMaxPathDegradingNonDefaultNetworkMigrationsCount

@ConnectionMigrationOptions.Experimental
fun setMaxPathDegradingNonDefaultNetworkMigrationsCount(
    maxPathDegradingEagerMigrationsCount: Int
): ConnectionMigrationOptions.Builder!

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

การตั้งค่านี้จะเกี่ยวข้องก็ต่อเมื่อเปิดใช้ allowNonDefaultNetworkUsage

แสดงผล
ConnectionMigrationOptions.Builder!

เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

setMaxTimeOnNonDefaultNetworkSeconds

@ConnectionMigrationOptions.Experimental
fun setMaxTimeOnNonDefaultNetworkSeconds(
    maxTimeOnNonDefaultNetworkSeconds: Long
): ConnectionMigrationOptions.Builder!

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

การตั้งค่านี้จะเกี่ยวข้องก็ต่อเมื่อเปิดใช้ allowNonDefaultNetworkUsage

แสดงผล
ConnectionMigrationOptions.Builder!

เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

setMaxWriteErrorNonDefaultNetworkMigrationsCount

@ConnectionMigrationOptions.Experimental
fun setMaxWriteErrorNonDefaultNetworkMigrationsCount(
    maxWriteErrorEagerMigrationsCount: Int
): ConnectionMigrationOptions.Builder!

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

การตั้งค่านี้จะเกี่ยวข้องก็ต่อเมื่อเปิดใช้ allowNonDefaultNetworkUsage

แสดงผล
ConnectionMigrationOptions.Builder!

เครื่องมือสร้างนี้สำหรับการเชื่อมโยง