ConnectionMigrationOptions.Builder

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

Legt fest, ob Verbindungen zu einem alternativen Netzwerk migriert werden können, wenn Cronet eine Verschlechterung des aktuell verwendeten Pfads erkennt.

Hinweis: Diese Einstellung kann dazu führen, dass Anfragen über getaktete Nicht-Standardnetzwerke gesendet werden. Verwenden Sie getaktete Netzwerke sparsam und optimieren Sie Parameter wie setMaxPathDegradingNonDefaultNetworkMigrationsCount und setMaxTimeOnNonDefaultNetworkSeconds, um die Zeit in Nicht-Standardnetzwerken zu begrenzen.

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

Ermöglicht die Migration von Verbindungen zu einer alternativen Serveradresse auf Anfrage des Servers.

public ConnectionMigrationOptions build()

Erstellt und gibt die endgültige ConnectionMigrationOptions-Instanz basierend auf den Werten in diesem Builder zurück.

public ConnectionMigrationOptions.Builder enableDefaultNetworkMigration(
    boolean enableDefaultNetworkConnectionMigration
)

Ermöglicht die Migration von Verbindungen bei einer Änderung des Standardnetzwerks. Wenn diese Option aktiviert ist, werden aktive QUIC-Verbindungen zum neuen Netzwerk migriert, wenn die Plattform angibt, dass sich das Standardnetzwerk ändert.

public ConnectionMigrationOptions.Builder enablePathDegradationMigration(boolean enable)

Ermöglicht die Migration von Verbindungen, wenn die Leistung des aktuellen Pfads schlecht ist.

Je nach Konfiguration kann dies dazu führen, dass die Verbindungen innerhalb desselben Standardnetzwerks oder zu einem Nicht-Standardnetzwerk migriert werden.

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

Konfiguriert, ob die Migration inaktiver Verbindungen aktiviert werden soll.

Wenn diese Option auf „true“ gesetzt ist, werden auch inaktive Verbindungen migriert, sofern sie nicht zu lange inaktiv waren. Die Einstellung gilt für alle Arten der Verbindungsmigration. Der maximale Zeitraum, in dem Verbindungen noch migriert werden, kann mit setIdleConnectionMigrationPeriodSeconds angepasst werden.

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

Legt fest, ob Verbindungen mit Fehlern vor dem Handshake in einem alternativen Netzwerk wiederholt werden sollen.

Wenn diese Option auf „true“ gesetzt ist, kann eine neue Verbindung in einem alternativen Netzwerk hergestellt werden, wenn sie im Standardnetzwerk fehlschlägt, bevor der Handshake bestätigt wird.

Hinweis: Ähnlich wie bei allowNonDefaultNetworkUsage kann diese Einstellung dazu führen, dass Anfragen über getaktete Nicht-Standardnetzwerke gesendet werden. Mit Vorsicht zu verwenden.

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

Legt den maximalen Zeitraum in Sekunden fest, in dem Verbindungen noch migriert werden. Die Einstellung gilt für alle Arten der Verbindungsmigration.

Nur relevant, wenn migrateIdleConnections aktiviert ist.

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

Legt die maximale Anzahl von Migrationen zum Nicht-Standardnetzwerk fest, wenn eine Verschlechterung des Pfads für die vorhandene Verbindung festgestellt wird. Wird kumulativ pro Netzwerk und Verbindung gezählt.

Nur relevant, wenn allowNonDefaultNetworkUsage aktiviert ist.

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

Legt den maximalen Zeitraum fest, in dem eilig migrierte Verbindungen im Nicht-Standardnetzwerk bleiben sollen, bevor sie zurückmigriert werden. Diese Zeit wird nicht kumulativ gezählt. Jede Migration aus dem Standardnetzwerk für jede Verbindung wird separat gemessen und mit diesem Wert verglichen.

Nur relevant, wenn allowNonDefaultNetworkUsage aktiviert ist.

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

Legt die maximale Anzahl von Migrationen zum Nicht-Standardnetzwerk fest, wenn Schreibfehler auftreten. Wird kumulativ pro Netzwerk und Verbindung gezählt.

Nur relevant, wenn allowNonDefaultNetworkUsage aktiviert ist.