> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PartyRegionUpdateConfiguration

> Configuration utilisée par la bibliothèque Party pour contrôler la façon dont elle effectue la découverte automatique des régions et les mises à jour des mesures de qualité de connexion.

Configuration utilisée par la bibliothèque Party pour contrôler la façon dont elle effectue la découverte automatique des régions et les mises à jour des mesures de qualité de connexion.

## Syntaxe

```cpp theme={null}
struct PartyRegionUpdateConfiguration {  
    PartyRegionUpdateMode mode;  
    uint32_t refreshIntervalInSeconds;  
}  
```

### Membres

**`mode`**   [PartyRegionUpdateMode](/fr/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode)

Le mode qui contrôle le moment où la découverte des régions et les mises à jour des mesures de qualité de connexion sont effectuées.

La valeur par défaut est [PartyRegionUpdateMode::Immediate](/fr/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode) lorsque [PartyOption::RegionUpdateConfiguration](/fr/services/playfab/multiplayer/networking/reference/enums/partyoption) n'a pas été configuré.

**`refreshIntervalInSeconds`**   uint32\_t

Le nombre de secondes devant s'écouler après la fin des mesures de qualité des régions avant qu'un nouveau processus de découverte des régions et de mesure de la qualité de connexion puisse commencer.

Cet intervalle d'actualisation est utilisé chaque fois qu'un [PartyRegionsChangedStateChange](/fr/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange) est fourni, afin de déterminer quand la prochaine mesure de la qualité des régions peut démarrer selon le mode de mise à jour défini par le champ *mode*. <br /><br /> Le fait de devenir éligible à une actualisation ne garantit pas que l'actualisation commence exactement à ce moment-là. Si le champ *mode* est défini sur [PartyRegionUpdateMode::Deferred](/fr/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode), la prochaine actualisation n'a lieu que lorsque l'une des méthodes applicables est appelée pour déclencher une mise à jour des régions. La bibliothèque attend également que l'appareil local ne se trouve plus dans aucun réseau Party et applique un léger délai aléatoire pour tenter d'éviter la charge du service PlayFab provenant de plusieurs appareils synchronisés involontairement.   <br /><br /> La valeur par défaut est 28800 (8 heures) lorsque [PartyOption::RegionUpdateConfiguration](/fr/services/playfab/multiplayer/networking/reference/enums/partyoption) n'a pas été configuré.   <br /><br /> Une valeur de zéro amène la bibliothèque Party à ne jamais actualiser automatiquement les mesures à l'avenir. Sinon, la valeur minimale autorisée est de 30 secondes.

## Remarques

Cette structure peut être utilisée avec [PartyOption::RegionUpdateConfiguration](/fr/services/playfab/multiplayer/networking/reference/enums/partyoption) pour remplacer ou interroger la configuration actuelle de la bibliothèque Party via [PartyManager::SetOption()](/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption) ou [PartyManager::GetOption()](/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption), respectivement. Elle configure le comportement du processus de découverte des régions et de mesure de la qualité de connexion qui produit les changements d'état [PartyRegionsChangedStateChange](/fr/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange).

## Configuration requise

**En-tête :** Party.h

## Voir aussi

[Membres de Party](/fr/services/playfab/multiplayer/networking/reference/party_members)\
[PartyOption::RegionUpdateConfiguration](/fr/services/playfab/multiplayer/networking/reference/enums/partyoption)\
[PartyRegionUpdateMode](/fr/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode)\
[PartyRegionsChangedStateChange](/fr/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange)\
[PartyManager::SetOption](/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption)\
[PartyManager::GetOption](/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption)


## Related topics

- [PartyRegionUpdateMode](/fr/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)
- [PartyOption](/fr/services/playfab/multiplayer/networking/reference/enums/partyoption.md)
- [Vue d'ensemble de l'API C/C++ de Party](/fr/services/playfab/multiplayer/networking/reference/party_members.md)
- [PartyRegionQualityMeasurementConfiguration](/fr/services/playfab/multiplayer/networking/reference/structs/partyregionqualitymeasurementconfiguration.md)
- [PartyRegionsChangedStateChange](/fr/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)