سازندهی گزینههای اتصال
public class ConnectionMigrationOptions.Builder
سازنده برای ConnectionMigrationOptions .
خلاصه
روشهای عمومی | |
|---|---|
ConnectionMigrationOptions.Builder | @ ConnectionMigrationOptions.Experimentalتنظیم میکند که آیا وقتی Cronet افت کیفیت مسیر فعلی مورد استفاده را تشخیص میدهد، میتوان اتصالات را به شبکهی جایگزین منتقل کرد یا خیر. |
ConnectionMigrationOptions.Builder | @ ConnectionMigrationOptions.Experimentalامکان انتقال اتصالات به آدرس سرور جایگزین را بنا به درخواست سرور فعال میکند. |
ConnectionMigrationOptions | build () نمونه نهایی |
ConnectionMigrationOptions.Builder | enableDefaultNetworkMigration (امکان انتقال اتصالات را در تغییر شبکه پیشفرض فعال میکند. |
ConnectionMigrationOptions.Builder | enablePathDegradationMigration (boolean enable)در صورت عملکرد ضعیف مسیر فعلی، امکان انتقال اتصالات را فراهم میکند. |
ConnectionMigrationOptions.Builder | @ ConnectionMigrationOptions.Experimentalپیکربندی میکند که آیا انتقال اتصالات غیرفعال باید فعال باشد یا خیر. |
ConnectionMigrationOptions.Builder | @ ConnectionMigrationOptions.Experimentalتنظیم میکند که آیا اتصالات دارای خطاهای پیش از دستدهی باید در یک شبکه جایگزین دوباره امتحان شوند یا خیر. |
ConnectionMigrationOptions.Builder | @ ConnectionMigrationOptions.Experimentalحداکثر مدت زمان بیکاری که در آن اتصالات همچنان منتقل میشوند را بر حسب ثانیه تنظیم میکند. |
ConnectionMigrationOptions.Builder | @ ConnectionMigrationOptions.Experimentalحداکثر تعداد مهاجرتها به شبکه غیر پیشفرض را در صورت مواجهه با تخریب مسیر برای اتصال موجود تنظیم میکند. |
ConnectionMigrationOptions.Builder | @ ConnectionMigrationOptions.Experimentalحداکثر مدت زمانی را که اتصالات منتقل شده با اشتیاق باید قبل از انتقال مجدد، در شبکه غیر پیشفرض باقی بمانند، تنظیم میکند. |
ConnectionMigrationOptions.Builder | @ ConnectionMigrationOptions.Experimentalحداکثر تعداد مهاجرتها به شبکه غیر پیشفرض را در صورت مواجهه با خطاهای نوشتن تنظیم میکند. |
روشهای عمومی
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 | این سازنده برای زنجیر کردن |
ساختن
public ConnectionMigrationOptions build()
نمونه نهایی ConnectionMigrationOptions را بر اساس مقادیر موجود در این سازنده ایجاد و برمیگرداند.
enableDefaultNetworkMigration
public ConnectionMigrationOptions.Builder enableDefaultNetworkMigration(
boolean enableDefaultNetworkConnectionMigration
)
امکان انتقال اتصالات در هنگام تغییر شبکه پیشفرض را فعال میکند. در صورت فعال بودن، اتصالات فعال QUIC هنگامی که پلتفرم نشان میدهد شبکه پیشفرض در حال تغییر است، به شبکه جدید منتقل میشوند.
| بازگشتها | |
|---|---|
ConnectionMigrationOptions.Builder | این سازنده برای زنجیر کردن |
| همچنین ببینید | |
|---|---|
Android Network State |
enablePathDegradationMigration
public ConnectionMigrationOptions.Builder enablePathDegradationMigration(boolean enable)
در صورت عملکرد ضعیف مسیر فعلی، امکان انتقال اتصالات را فراهم میکند.
بسته به پیکربندیهای دیگر، این میتواند منجر به انتقال اتصالات در همان شبکه پیشفرض یا به یک شبکه غیر پیشفرض شود.
| بازگشتها | |
|---|---|
ConnectionMigrationOptions.Builder | این سازنده برای زنجیر کردن |
| همچنین ببینید | |
|---|---|
allowNonDefaultNetworkUsage |
migrateIdleConnections
@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder migrateIdleConnections(boolean migrateIdleConnections)
پیکربندی میکند که آیا انتقال اتصالات غیرفعال باید فعال باشد یا خیر.
اگر روی true تنظیم شود، اتصالات غیرفعال نیز منتقل میشوند، البته تا زمانی که برای مدت طولانی غیرفعال نبوده باشند. این تنظیم برای همه انواع مهاجرت اتصال مشترک است. حداکثر مدت زمان غیرفعال بودن که اتصالات همچنان منتقل میشوند را میتوان با استفاده از 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 | این سازنده برای زنجیر کردن |