سازنده‌ی گزینه‌های اتصال

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

تنظیم می‌کند که آیا وقتی Cronet افت کیفیت مسیر فعلی مورد استفاده را تشخیص می‌دهد، می‌توان اتصالات را به شبکه‌ی جایگزین منتقل کرد یا خیر.

توجه: این تنظیم می‌تواند منجر به ارسال درخواست‌ها به شبکه‌های غیر پیش‌فرض با محدودیت زمانی شود. مطمئن شوید که از شبکه‌های محدود زمانی به میزان کم استفاده می‌کنید و پارامترهایی مانند setMaxPathDegradingNonDefaultNetworkMigrationsCount و setMaxTimeOnNonDefaultNetworkSeconds به دقت تنظیم کنید تا زمان در شبکه‌های غیر پیش‌فرض محدود شود.

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

امکان انتقال اتصالات به آدرس سرور جایگزین را بنا به درخواست سرور فعال می‌کند.

fun build(): ConnectionMigrationOptions!

نمونه نهایی ConnectionMigrationOptions را بر اساس مقادیر موجود در این سازنده ایجاد و برمی‌گرداند.

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

امکان انتقال اتصالات در هنگام تغییر شبکه پیش‌فرض را فعال می‌کند. در صورت فعال بودن، اتصالات فعال QUIC هنگامی که پلتفرم نشان می‌دهد شبکه پیش‌فرض در حال تغییر است، به شبکه جدید منتقل می‌شوند.

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

در صورت عملکرد ضعیف مسیر فعلی، امکان انتقال اتصالات را فراهم می‌کند.

بسته به پیکربندی‌های دیگر، این می‌تواند منجر به انتقال اتصالات در همان شبکه پیش‌فرض یا به یک شبکه غیر پیش‌فرض شود.

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

پیکربندی می‌کند که آیا انتقال اتصالات غیرفعال باید فعال باشد یا خیر.

اگر روی true تنظیم شود، اتصالات غیرفعال نیز منتقل می‌شوند، البته تا زمانی که برای مدت طولانی غیرفعال نبوده باشند. این تنظیم برای همه انواع مهاجرت اتصال مشترک است. حداکثر مدت زمان غیرفعال بودن که اتصالات همچنان منتقل می‌شوند را می‌توان با استفاده از setIdleConnectionMigrationPeriodSeconds تنظیم کرد.

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

تنظیم می‌کند که آیا اتصالات دارای خطاهای پیش از دست‌دهی باید در یک شبکه جایگزین دوباره امتحان شوند یا خیر.

اگر درست باشد، اگر اتصال در شبکه پیش‌فرض قبل از تأیید دست‌دهی با شکست مواجه شود، ممکن است اتصال جدیدی از طریق شبکه جایگزین برقرار شود.

توجه: مشابه allowNonDefaultNetworkUsage این تنظیم می‌تواند منجر به ارسال درخواست‌ها به شبکه‌های غیر پیش‌فرض با محدودیت سرعت شود. با احتیاط استفاده کنید!

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

حداکثر مدت زمان بیکاری که در آن اتصالات همچنان منتقل می‌شوند را بر حسب ثانیه تنظیم می‌کند. این تنظیم برای همه انواع انتقال اتصال مشترک است.

فقط در صورتی مرتبط است که migrateIdleConnections فعال باشد.

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

حداکثر تعداد مهاجرت‌ها به شبکه غیر پیش‌فرض را در صورت مواجهه با تخریب مسیر برای اتصال موجود تنظیم می‌کند. به صورت تجمعی برای هر شبکه به ازای هر اتصال شمارش می‌شود.

فقط در صورتی مرتبط است که allowNonDefaultNetworkUsage فعال باشد.

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

حداکثر مدت زمانی را که اتصالات منتقل‌شده‌ی مشتاقانه باید قبل از انتقال مجدد، در شبکه‌ی غیر پیش‌فرض باقی بمانند، تعیین می‌کند. این زمان تجمعی نیست - هر انتقال از شبکه‌ی پیش‌فرض برای هر اتصال، به‌طور جداگانه اندازه‌گیری و با این مقدار مقایسه می‌شود.

فقط در صورتی مرتبط است که allowNonDefaultNetworkUsage فعال باشد.

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

حداکثر تعداد مهاجرت‌ها به شبکه غیر پیش‌فرض را در صورت مواجهه با خطاهای نوشتن تنظیم می‌کند. به صورت تجمعی در هر شبکه در هر اتصال شمارش می‌شود.

فقط در صورتی مرتبط است که allowNonDefaultNetworkUsage فعال باشد.