ConnectionMigrationOptions.Builder

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

Indique si les connexions peuvent être migrées vers un autre réseau lorsque Cronet détecte une dégradation du chemin d'accès actuellement utilisé.

Remarque : Ce paramètre peut entraîner l'envoi de requêtes sur des réseaux à usage limité non par défaut. Assurez-vous d'utiliser les réseaux à usage limité avec parcimonie et d'ajuster les paramètres tels que setMaxPathDegradingNonDefaultNetworkMigrationsCount et setMaxTimeOnNonDefaultNetworkSeconds pour limiter le temps passé sur les réseaux non par défaut.

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

Permet de migrer les connexions vers une autre adresse de serveur à la demande du serveur.

fun build(): ConnectionMigrationOptions!

Crée et renvoie l'instance ConnectionMigrationOptions finale, en fonction des valeurs de ce compilateur.

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

Permet de migrer les connexions lors d'un changement de réseau par défaut. Si cette option est activée, les connexions QUIC actives seront migrées vers le nouveau réseau lorsque la plate-forme indique que le réseau par défaut est en cours de modification.

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

Permet de migrer les connexions si le chemin d'accès actuel est peu performant.

En fonction de la configuration, cela peut entraîner la migration des connexions au sein du même réseau par défaut ou vers un réseau non par défaut.

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

Configure si la migration des connexions inactives doit être activée ou non.

Si la valeur est définie sur "true", les connexions inactives seront également migrées, à condition qu'elles ne soient pas inactives depuis trop longtemps. Le paramètre est partagé pour tous les types de migration de connexion. La période d'inactivité maximale pendant laquelle les connexions seront toujours migrées peut être personnalisée à l'aide de setIdleConnectionMigrationPeriodSeconds.

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

Indique si les connexions présentant des erreurs de pré-établissement doivent être retentées sur un autre réseau.

Si la valeur est "true", une nouvelle connexion peut être établie sur un autre réseau si elle échoue sur le réseau par défaut avant que l'établissement ne soit confirmé.

Remarque : Comme pour allowNonDefaultNetworkUsage, ce paramètre peut entraîner l'envoi de requêtes sur des réseaux à usage limité non par défaut. À utiliser avec précaution !

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

Définit la période d'inactivité maximale pendant laquelle les connexions seront toujours migrées, en secondes. Le paramètre est partagé pour tous les types de migration de connexion.

Ne s'applique que si migrateIdleConnections est activé.

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

Définit le nombre maximal de migrations vers le réseau non par défaut en cas de dégradation du chemin d'accès pour la connexion existante. Comptabilisé de manière cumulative par réseau et par connexion.

Ne s'applique que si allowNonDefaultNetworkUsage est activé.

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

Définit la période maximale pendant laquelle les connexions migrées de manière anticipée doivent rester sur le réseau non par défaut avant d'être migrées à nouveau. Cette durée n'est pas cumulative : chaque migration hors du réseau par défaut pour chaque connexion est mesurée et comparée à cette valeur séparément.

Ne s'applique que si allowNonDefaultNetworkUsage est activé.

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

Définit le nombre maximal de migrations vers le réseau non par défaut en cas d'erreurs d'écriture. Comptabilisé de manière cumulative par réseau et par connexion.

Ne s'applique que si allowNonDefaultNetworkUsage est activé.