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 הסופי, על סמך הערכים ב-builder הזה.

public ConnectionMigrationOptions.Builder enableDefaultNetworkMigration(
    boolean enableDefaultNetworkConnectionMigration
)

מאפשרת להעביר חיבורים כשמשנים את רשת ברירת המחדל. אם ההגדרה הזו מופעלת, חיבורי QUIC פעילים יועברו לרשת החדשה כשהפלטפורמה תציין שהרשת שמוגדרת כברירת מחדל משתנה.

public ConnectionMigrationOptions.Builder enablePathDegradationMigration(boolean enable)

ההגדרה הזו מאפשרת להעביר חיבורים אם הביצועים של הנתיב הנוכחי נמוכים.

בהתאם להגדרות אחרות, יכול להיות שהחיבורים יועברו באותה רשת ברירת מחדל, או לרשת שאינה רשת ברירת מחדל.

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

ההגדרה קובעת אם להפעיל או להשבית את ההעברה של חיבורים לא פעילים.

אם היא מוגדרת כ-True, גם חיבורים לא פעילים יועברו, כל עוד הם לא היו לא פעילים יותר מדי זמן. ההגדרה משותפת לכל סוגי ההעברות של החיבורים. אפשר להתאים אישית את התקופה המקסימלית של חוסר פעילות שבמהלכה החיבורים עדיין יועברו באמצעות setIdleConnectionMigrationPeriodSeconds.

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

ההגדרה קובעת אם המערכת תנסה שוב להתחבר לרשת חלופית במקרה של שגיאות לפני לחיצת היד.

אם הערך הוא true, יכול להיות שיווצר חיבור חדש לרשת חלופית אם החיבור לרשת ברירת המחדל ייכשל לפני אישור הלחיצה.

הערה: בדומה ל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 מופעלת.