ConnectionMigrationOptions.Builder

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

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 kostenpflichtige Nicht-Standardnetzwerke gesendet werden. Verwenden Sie kostenpflichtige Netzwerke sparsam und optimieren Sie Parameter wie setMaxPathDegradingNonDefaultNetworkMigrationsCount und setMaxTimeOnNonDefaultNetworkSeconds, um die Zeit in Nicht-Standardnetzwerken zu begrenzen.

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

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

fun build(): ConnectionMigrationOptions!

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

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

Ermöglicht die Migration von Verbindungen bei Ä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.

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

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

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

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

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
fun retryPreHandshakeErrorsOnNonDefaultNetwork(
    retryPreHandshakeErrorsOnAlternateNetwork: Boolean
): ConnectionMigrationOptions.Builder!

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 kostenpflichtige Nicht-Standardnetzwerke gesendet werden. Mit Vorsicht zu verwenden!

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

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
fun setMaxPathDegradingNonDefaultNetworkMigrationsCount(
    maxPathDegradingEagerMigrationsCount: Int
): ConnectionMigrationOptions.Builder!

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
fun setMaxTimeOnNonDefaultNetworkSeconds(
    maxTimeOnNonDefaultNetworkSeconds: Long
): ConnectionMigrationOptions.Builder!

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
fun setMaxWriteErrorNonDefaultNetworkMigrationsCount(
    maxWriteErrorEagerMigrationsCount: Int
): ConnectionMigrationOptions.Builder!

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.