ConnectionMigrationOptions.Builder

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

Đặt xem các kết nối có thể được di chuyển sang một mạng thay thế hay không khi Cronet phát hiện thấy đường dẫn hiện đang được sử dụng bị suy giảm.

Lưu ý: Chế độ cài đặt này có thể khiến các yêu cầu được gửi trên các mạng có đo lượng dữ liệu không phải mặc định. Đảm bảo bạn chỉ sử dụng mạng có đo lượng dữ liệu khi cần thiết và tinh chỉnh các tham số như setMaxPathDegradingNonDefaultNetworkMigrationsCount và setMaxTimeOnNonDefaultNetworkSeconds để giới hạn thời gian trên các mạng không phải mạng mặc định.

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

Cho phép di chuyển các kết nối sang một địa chỉ máy chủ thay thế theo yêu cầu của máy chủ.

public ConnectionMigrationOptions build()

Tạo và trả về thực thể ConnectionMigrationOptions cuối cùng, dựa trên các giá trị trong trình tạo này.

public ConnectionMigrationOptions.Builder enableDefaultNetworkMigration(
    boolean enableDefaultNetworkConnectionMigration
)

Cho phép di chuyển các kết nối khi mạng mặc định thay đổi. Nếu được bật, các kết nối QUIC đang hoạt động sẽ được di chuyển sang mạng mới khi nền tảng cho biết mạng mặc định đang thay đổi.

public ConnectionMigrationOptions.Builder enablePathDegradationMigration(boolean enable)

Cho phép di chuyển các kết nối nếu đường dẫn hiện tại hoạt động kém.

Tuỳ thuộc vào cấu hình khác, điều này có thể dẫn đến việc di chuyển các kết nối trong cùng một mạng mặc định hoặc đến một mạng không mặc định.

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

Định cấu hình xem có nên bật tính năng di chuyển các kết nối ở trạng thái rảnh hay không.

Nếu bạn đặt chính sách này thành true, thì các kết nối không hoạt động cũng sẽ được di chuyển, miễn là chúng không ở trạng thái không hoạt động quá lâu. Chế độ cài đặt này được chia sẻ cho tất cả các loại di chuyển kết nối. Bạn có thể tuỳ chỉnh khoảng thời gian không hoạt động tối đa mà các kết nối vẫn sẽ được di chuyển bằng cách sử dụng setIdleConnectionMigrationPeriodSeconds.

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

Đặt xem có nên thử lại các kết nối có lỗi trước khi bắt tay trên một mạng thay thế hay không.

Nếu đúng, một kết nối mới có thể được thiết lập trên mạng thay thế nếu kết nối đó không thành công trên mạng mặc định trước khi quá trình bắt tay được xác nhận.

Lưu ý: tương tự như allowNonDefaultNetworkUsage, chế độ cài đặt này có thể khiến các yêu cầu được gửi trên các mạng có đo lượng dữ liệu không phải mặc định. Hãy thận trọng khi sử dụng!

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

Đặt khoảng thời gian tối đa mà các kết nối vẫn được di chuyển khi không hoạt động (tính bằng giây). Chế độ cài đặt này được chia sẻ cho tất cả các loại di chuyển kết nối.

Chỉ phù hợp nếu bạn bật migrateIdleConnections.

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

Đặt số lượng tối đa các lượt di chuyển sang mạng không mặc định khi gặp phải tình trạng giảm chất lượng đường dẫn cho kết nối hiện có. Được tính luỹ kế trên mỗi mạng cho mỗi kết nối.

Chỉ phù hợp nếu bạn bật allowNonDefaultNetworkUsage.

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

Đặt khoảng thời gian tối đa mà các kết nối được di chuyển sớm sẽ vẫn nằm trên mạng không mặc định trước khi được di chuyển trở lại. Thời gian này không phải là thời gian tích luỹ – mỗi lần di chuyển khỏi mạng mặc định cho từng kết nối sẽ đo lường và so sánh với giá trị này một cách riêng biệt.

Chỉ phù hợp nếu bạn bật allowNonDefaultNetworkUsage.

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

Đặt số lượng di chuyển tối đa sang mạng không mặc định khi gặp lỗi ghi. Được tính luỹ kế trên mỗi mạng cho mỗi kết nối.

Chỉ phù hợp nếu bạn bật allowNonDefaultNetworkUsage.