ConnectionMigrationOptions.Builder

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder allowNonDefaultNetworkUsage(boolean enable)

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

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

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder allowServerMigration(boolean allowServerMigration)

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

public ConnectionMigrationOptions build()

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

public ConnectionMigrationOptions.Builder enableDefaultNetworkMigration(
    boolean enableDefaultNetworkConnectionMigration
)

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

public ConnectionMigrationOptions.Builder enablePathDegradationMigration(boolean enable)

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

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

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder migrateIdleConnections(boolean migrateIdleConnections)

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

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

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder retryPreHandshakeErrorsOnNonDefaultNetwork(
    boolean retryPreHandshakeErrorsOnAlternateNetwork
)

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

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

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

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder setIdleConnectionMigrationPeriodSeconds(
    long idleConnectionMigrationPeriodSeconds
)

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

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

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder setMaxPathDegradingNonDefaultNetworkMigrationsCount(
    int maxPathDegradingEagerMigrationsCount
)

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

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

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder setMaxTimeOnNonDefaultNetworkSeconds(
    long maxTimeOnNonDefaultNetworkSeconds
)

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

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

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder setMaxWriteErrorNonDefaultNetworkMigrationsCount(
    int maxWriteErrorEagerMigrationsCount
)

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

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