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

ConnectionMigrationOptions.Builder

class ConnectionMigrationOptions.Builder

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

ملخّص

الوظائف العامة
`ConnectionMigrationOptions.Builder!`	`@ConnectionMigrationOptions.Experimental allowNonDefaultNetworkUsage(enable: Boolean)` يحدِّد هذا الإعداد ما إذا كان يمكن نقل الاتصالات إلى شبكة بديلة عندما يرصد Cronet انخفاضًا في جودة المسار المستخدَم حاليًا.
`ConnectionMigrationOptions.Builder!`	`@ConnectionMigrationOptions.Experimental allowServerMigration(allowServerMigration: Boolean)` تتيح إمكانية نقل الاتصالات إلى عنوان خادم بديل بناءً على طلب الخادم.
`ConnectionMigrationOptions!`	`build()` تنشئ هذه الطريقة مثيل `ConnectionMigrationOptions` النهائي وتعرضه استنادًا إلى القيم الواردة في أداة الإنشاء هذه.
`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!`	هذه الأداة لربط

allowServerMigration

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

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

المرتجعات
`ConnectionMigrationOptions.Builder!`	هذه الأداة لربط

إنشاء

fun build(): ConnectionMigrationOptions!

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

enableDefaultNetworkMigration

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

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

المرتجعات
`ConnectionMigrationOptions.Builder!`	هذه الأداة لربط

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

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!`	هذه الأداة لربط