تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

‫ConnectionMigrationOptions.Builder

public class ConnectionMigrationOptions.Builder

أداة إنشاء لـ ConnectionMigrationOptions

ملخّص

الإجراءات العامة
`ConnectionMigrationOptions.Builder`	`@ConnectionMigrationOptions.Experimental allowNonDefaultNetworkUsage(boolean enable)` لتحديد ما إذا كان يمكن نقل الاتصالات إلى شبكة بديلة عندما يرصد Cronet تدهورًا في المسار المستخدَم حاليًا
`ConnectionMigrationOptions.Builder`	`@ConnectionMigrationOptions.Experimental allowServerMigration(boolean allowServerMigration)` لتفعيل إمكانية نقل الاتصالات إلى عنوان خادم بديل بناءً على طلب الخادم
`ConnectionMigrationOptions`	`build()` لإنشاء وعرض مثيل `ConnectionMigrationOptions` النهائي استنادًا إلى القيم في أداة الإنشاء هذه
`ConnectionMigrationOptions.Builder`	`enableDefaultNetworkMigration( boolean enableDefaultNetworkConnectionMigration )` لتفعيل إمكانية نقل الاتصالات عند تغيير الشبكة التلقائية
`ConnectionMigrationOptions.Builder`	`enablePathDegradationMigration(boolean enable)` لتفعيل إمكانية نقل الاتصالات إذا كان المسار الحالي ضعيف الأداء
`ConnectionMigrationOptions.Builder`	`@ConnectionMigrationOptions.Experimental migrateIdleConnections(boolean migrateIdleConnections)` لتحديد ما إذا كان يجب تفعيل نقل الاتصالات غير النشطة أم لا
`ConnectionMigrationOptions.Builder`	`@ConnectionMigrationOptions.Experimental retryPreHandshakeErrorsOnNonDefaultNetwork( boolean retryPreHandshakeErrorsOnAlternateNetwork )` لتحديد ما إذا كان يجب إعادة محاولة الاتصالات التي تتضمّن أخطاء ما قبل المصافحة على شبكة بديلة
`ConnectionMigrationOptions.Builder`	`@ConnectionMigrationOptions.Experimental setIdleConnectionMigrationPeriodSeconds( long idleConnectionMigrationPeriodSeconds )` لضبط الحد الأقصى لفترة عدم النشاط التي سيظل يتم خلالها نقل الاتصالات، بالثواني
`ConnectionMigrationOptions.Builder`	`@ConnectionMigrationOptions.Experimental setMaxPathDegradingNonDefaultNetworkMigrationsCount( int maxPathDegradingEagerMigrationsCount )` لضبط الحد الأقصى لعدد عمليات النقل إلى الشبكة غير التلقائية عند رصد تدهور في المسار للاتصال الحالي
`ConnectionMigrationOptions.Builder`	`@ConnectionMigrationOptions.Experimental setMaxTimeOnNonDefaultNetworkSeconds( long maxTimeOnNonDefaultNetworkSeconds )` لضبط الحد الأقصى للفترة التي يجب أن تظل خلالها الاتصالات التي تم نقلها بشكل استباقي على الشبكة غير التلقائية قبل نقلها مرة أخرى
`ConnectionMigrationOptions.Builder`	`@ConnectionMigrationOptions.Experimental setMaxWriteErrorNonDefaultNetworkMigrationsCount( int maxWriteErrorEagerMigrationsCount )` لضبط الحد الأقصى لعدد عمليات النقل إلى الشبكة غير التلقائية عند رصد أخطاء في الكتابة

الإجراءات العامة

allowNonDefaultNetworkUsage

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

لتحديد ما إذا كان يمكن نقل الاتصالات إلى شبكة بديلة عندما يرصد Cronet تدهورًا في المسار المستخدَم حاليًا

ملاحظة: يمكن أن يؤدي هذا الإعداد إلى إرسال الطلبات على شبكات غير تلقائية يتم احتساب الرسوم عليها. احرص على استخدام الشبكات التي يتم احتساب الرسوم عليها باعتدال، واضبط بدقة مَعلمات مثل setMaxPathDegradingNonDefaultNetworkMigrationsCount وsetMaxTimeOnNonDefaultNetworkSeconds للحدّ من الوقت الذي يتم قضاؤه على الشبكات غير التلقائية.

المرتجعات
`ConnectionMigrationOptions.Builder`	أداة الإنشاء هذه لربط الإجراءات

allowServerMigration

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

لتفعيل إمكانية نقل الاتصالات إلى عنوان خادم بديل بناءً على طلب الخادم

المرتجعات
`ConnectionMigrationOptions.Builder`	أداة الإنشاء هذه لربط الإجراءات

build

public ConnectionMigrationOptions build()

لإنشاء وعرض مثيل ConnectionMigrationOptions النهائي استنادًا إلى القيم في أداة الإنشاء هذه

enableDefaultNetworkMigration

public ConnectionMigrationOptions.Builder enableDefaultNetworkMigration(
    boolean enableDefaultNetworkConnectionMigration
)

لتفعيل إمكانية نقل الاتصالات عند تغيير الشبكة التلقائية في حال التفعيل، سيتم نقل اتصالات QUIC النشطة إلى الشبكة الجديدة عندما تشير المنصة إلى أنّ الشبكة التلقائية تتغيّر.

المرتجعات
`ConnectionMigrationOptions.Builder`	أداة الإنشاء هذه لربط الإجراءات

انظر أيضًا
`Android Network State`	حالة شبكة Android

enablePathDegradationMigration

public ConnectionMigrationOptions.Builder enablePathDegradationMigration(boolean enable)

لتفعيل إمكانية نقل الاتصالات إذا كان المسار الحالي ضعيف الأداء

استنادًا إلى الإعدادات الأخرى، يمكن أن يؤدي ذلك إلى نقل الاتصالات ضمن الشبكة التلقائية نفسها أو إلى شبكة غير تلقائية.

المرتجعات
`ConnectionMigrationOptions.Builder`	أداة الإنشاء هذه لربط الإجراءات

انظر أيضًا
`allowNonDefaultNetworkUsage`

migrateIdleConnections

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

لتحديد ما إذا كان يجب تفعيل نقل الاتصالات غير النشطة أم لا

في حال ضبطها على "صحيح"، سيتم نقل الاتصالات غير النشطة أيضًا، طالما لم تكن غير نشطة لفترة طويلة جدًا. يتم مشاركة الإعداد لجميع أنواع نقل الاتصالات. يمكن تخصيص الحد الأقصى لفترة عدم النشاط التي سيظل يتم خلالها نقل الاتصالات باستخدام setIdleConnectionMigrationPeriodSeconds.

المرتجعات
`ConnectionMigrationOptions.Builder`	أداة الإنشاء هذه لربط الإجراءات

retryPreHandshakeErrorsOnNonDefaultNetwork

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

لتحديد ما إذا كان يجب إعادة محاولة الاتصالات التي تتضمّن أخطاء ما قبل المصافحة على شبكة بديلة

في حال ضبطها على "صحيح"، قد يتم إنشاء اتصال جديد على شبكة بديلة إذا فشل على الشبكة التلقائية قبل تأكيد المصافحة.

ملاحظة: على غرار allowNonDefaultNetworkUsage، يمكن أن يؤدي هذا الإعداد إلى إرسال الطلبات على شبكات غير تلقائية يتم احتساب الرسوم عليها. يُرجى استخدامه بحذر.

المرتجعات
`ConnectionMigrationOptions.Builder`	أداة الإنشاء هذه لربط الإجراءات

setIdleConnectionMigrationPeriodSeconds

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

لضبط الحد الأقصى لفترة عدم النشاط التي سيظل يتم خلالها نقل الاتصالات، بالثواني يتم مشاركة الإعداد لجميع أنواع نقل الاتصالات.

لا يكون هذا الإعداد ذا صلة إلا إذا تم تفعيل migrateIdleConnections.

المرتجعات
`ConnectionMigrationOptions.Builder`	أداة الإنشاء هذه لربط الإجراءات

setMaxPathDegradingNonDefaultNetworkMigrationsCount

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

لضبط الحد الأقصى لعدد عمليات النقل إلى الشبكة غير التلقائية عند رصد تدهور في المسار للاتصال الحالي يتم احتسابها بشكل تراكمي لكل شبكة ولكل اتصال.

لا يكون هذا الإعداد ذا صلة إلا إذا تم تفعيل allowNonDefaultNetworkUsage.

المرتجعات
`ConnectionMigrationOptions.Builder`	أداة الإنشاء هذه لربط الإجراءات

setMaxTimeOnNonDefaultNetworkSeconds

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

لضبط الحد الأقصى للفترة التي يجب أن تظل خلالها الاتصالات التي تم نقلها بشكل استباقي على الشبكة غير التلقائية قبل نقلها مرة أخرى هذا الوقت ليس تراكميًا، إذ يتم قياس كل عملية نقل خارج الشبكة التلقائية لكل اتصال ومقارنتها بهذه القيمة بشكل منفصل.

لا يكون هذا الإعداد ذا صلة إلا إذا تم تفعيل allowNonDefaultNetworkUsage.

المرتجعات
`ConnectionMigrationOptions.Builder`	أداة الإنشاء هذه لربط الإجراءات

setMaxWriteErrorNonDefaultNetworkMigrationsCount

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

لضبط الحد الأقصى لعدد عمليات النقل إلى الشبكة غير التلقائية عند رصد أخطاء في الكتابة يتم احتسابها بشكل تراكمي لكل شبكة ولكل اتصال.

لا يكون هذا الإعداد ذا صلة إلا إذا تم تفعيل allowNonDefaultNetworkUsage.

المرتجعات
`ConnectionMigrationOptions.Builder`	أداة الإنشاء هذه لربط الإجراءات