‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

ConnectionMigrationOptions.Builder

class ConnectionMigrationOptions.Builder

‫Builder ל-ConnectionMigrationOptions.

סיכום

פונקציות ציבוריות
`ConnectionMigrationOptions.Builder!`	`@ConnectionMigrationOptions.Experimental allowNonDefaultNetworkUsage(enable: Boolean)` ההגדרה קובעת אם אפשר להעביר חיבורים לרשת חלופית כש-Cronet מזהה ירידה באיכות הנתיב שנמצא בשימוש כרגע.
`ConnectionMigrationOptions.Builder!`	`@ConnectionMigrationOptions.Experimental allowServerMigration(allowServerMigration: Boolean)` מאפשרת להעביר חיבורים לכתובת שרת חלופית לפי בקשת השרת.
`ConnectionMigrationOptions!`	`build()` יוצרת ומחזירה את מופע `ConnectionMigrationOptions` הסופי, על סמך הערכים ב-builder הזה.
`ConnectionMigrationOptions.Builder!`	`enableDefaultNetworkMigration( enableDefaultNetworkConnectionMigration: Boolean )` מאפשרת להעביר חיבורים כשמשנים את רשת ברירת המחדל.
`ConnectionMigrationOptions.Builder!`	`enablePathDegradationMigration(enable: Boolean)` ההגדרה הזו מאפשרת להעביר חיבורים אם הביצועים של הנתיב הנוכחי נמוכים.
`ConnectionMigrationOptions.Builder!`	`@ConnectionMigrationOptions.Experimental migrateIdleConnections(migrateIdleConnections: Boolean)` ההגדרה קובעת אם להפעיל או להשבית את ההעברה של חיבורים לא פעילים.
`ConnectionMigrationOptions.Builder!`	`@ConnectionMigrationOptions.Experimental retryPreHandshakeErrorsOnNonDefaultNetwork( retryPreHandshakeErrorsOnAlternateNetwork: Boolean )` ההגדרה קובעת אם המערכת תנסה שוב להתחבר לרשת חלופית במקרה של שגיאות לפני לחיצת היד.
`ConnectionMigrationOptions.Builder!`	`@ConnectionMigrationOptions.Experimental setIdleConnectionMigrationPeriodSeconds( idleConnectionMigrationPeriodSeconds: Long )` ההגדרה קובעת את תקופת חוסר הפעילות המקסימלית שבמהלכה החיבורים עדיין יועברו, בשניות.
`ConnectionMigrationOptions.Builder!`	`@ConnectionMigrationOptions.Experimental setMaxPathDegradingNonDefaultNetworkMigrationsCount( maxPathDegradingEagerMigrationsCount: Int )` ההגדרה הזו קובעת את המספר המקסימלי של העברות לרשת שאינה ברירת המחדל, כשמזוהה ירידה באיכות הנתיב של החיבור הקיים.
`ConnectionMigrationOptions.Builder!`	`@ConnectionMigrationOptions.Experimental setMaxTimeOnNonDefaultNetworkSeconds( maxTimeOnNonDefaultNetworkSeconds: Long )` ההגדרה הזו קובעת את התקופה המקסימלית שבה חיבורים שהועברו מראש צריכים להישאר ברשת שאינה ברירת המחדל לפני שהם מועברים בחזרה.
`ConnectionMigrationOptions.Builder!`	`@ConnectionMigrationOptions.Experimental setMaxWriteErrorNonDefaultNetworkMigrationsCount( maxWriteErrorEagerMigrationsCount: Int )` מגדיר את המספר המקסימלי של העברות לרשת שאינה ברירת המחדל במקרה של שגיאות כתיבה.

פונקציות ציבוריות

allowNonDefaultNetworkUsage

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

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

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

החזרות
`ConnectionMigrationOptions.Builder!`	ה-builder הזה לשרשור

allowServerMigration

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

מאפשרת להעביר חיבורים לכתובת שרת חלופית לפי בקשת השרת.

החזרות
`ConnectionMigrationOptions.Builder!`	ה-builder הזה לשרשור

לבנות גרסת build

fun build(): ConnectionMigrationOptions!

יוצרת ומחזירה את מופע ConnectionMigrationOptions הסופי, על סמך הערכים ב-builder הזה.

enableDefaultNetworkMigration

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

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

החזרות
`ConnectionMigrationOptions.Builder!`	ה-builder הזה לשרשור

עוד באותו הקשר
`Android Network State`	מצב הרשת ב-Android

enablePathDegradationMigration

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

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

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

החזרות
`ConnectionMigrationOptions.Builder!`	ה-builder הזה לשרשור

עוד באותו הקשר
`allowNonDefaultNetworkUsage`

migrateIdleConnections

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

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

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

החזרות
`ConnectionMigrationOptions.Builder!`	ה-builder הזה לשרשור

retryPreHandshakeErrorsOnNonDefaultNetwork

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

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

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

הערה: בדומה לallowNonDefaultNetworkUsage, ההגדרה הזו עלולה לגרום לשליחת בקשות ברשתות בתשלום שלא מוגדרות כברירת מחדל. חשוב להשתמש בזהירות!

החזרות
`ConnectionMigrationOptions.Builder!`	ה-builder הזה לשרשור

setIdleConnectionMigrationPeriodSeconds

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

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

רלוונטי רק אם האפשרות migrateIdleConnections מופעלת.

החזרות
`ConnectionMigrationOptions.Builder!`	ה-builder הזה לשרשור

setMaxPathDegradingNonDefaultNetworkMigrationsCount

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

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

רלוונטי רק אם האפשרות allowNonDefaultNetworkUsage מופעלת.

החזרות
`ConnectionMigrationOptions.Builder!`	ה-builder הזה לשרשור

setMaxTimeOnNonDefaultNetworkSeconds

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

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

רלוונטי רק אם האפשרות allowNonDefaultNetworkUsage מופעלת.

החזרות
`ConnectionMigrationOptions.Builder!`	ה-builder הזה לשרשור

setMaxWriteErrorNonDefaultNetworkMigrationsCount

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

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

רלוונטי רק אם האפשרות allowNonDefaultNetworkUsage מופעלת.

החזרות
`ConnectionMigrationOptions.Builder!`	ה-builder הזה לשרשור