> ## 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.

# PartyRegionQualityMeasurementConfiguration

> Configuration utilisée par la bibliothèque Party pour contrôler le comportement de mesure de la qualité des régions.

Configuration utilisée par la bibliothèque Party pour contrôler le comportement de mesure de la qualité des régions.

## Syntaxe

```cpp theme={null}
struct PartyRegionQualityMeasurementConfiguration {  
    uint32_t totalMeasurementTimeoutInMilliseconds;  
    uint16_t highLatencyHintInMilliseconds;  
    uint16_t minRequiredSuccessfulResponses;  
    uint16_t idealNumberOfSuccessfulResponses;  
    uint16_t maxRetriesWithNoResponse;  
    uint16_t maxTimeoutsAfterResponse;  
}  
```

### Membres

**`totalMeasurementTimeoutInMilliseconds`**   uint32\_t

Le nombre maximal de millisecondes accordé pour résoudre les noms d'hôte et tenter de mesurer les conditions réseau entre l'appareil local et les serveurs de balise de qualité de service PlayFab.

Cette valeur contrôle la durée maximale autorisée, en millisecondes, pour que la bibliothèque Party résolve les noms d'hôte des serveurs de balise de qualité de service PlayFab pour toutes les régions disponibles et leur envoie des messages légers afin de mesurer la qualité de connexion. Si des problèmes environnementaux entraînent une résolution de noms lente ou une latence élevée/une perte de paquets vers certaines régions, seules les régions contactées avec succès au moins une fois dans ce délai sont signalées dans le résultat [PartyRegionsChangedStateChange](/fr-CA/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange). <br /><br /> Cette valeur n'inclut pas et n'affecte pas le temps nécessaire à la bibliothèque Party pour récupérer la liste des régions disponibles auprès du service PlayFab.   <br /><br /> Les applications doivent généralement définir ce délai d'expiration en fonction des objectifs d'expérience utilisateur et des pires cas, plutôt que d'essayer de déduire un nombre à partir d'hypothèses techniques. La durée exacte nécessaire pour mesurer une région donnée ou toutes les régions peut varier considérablement selon des facteurs tels que le nombre de régions disponibles, les conditions actuelles de l'environnement réseau, les délais d'expiration ajustés dynamiquement par la bibliothèque Party en fonction de la latence observée, etc.   <br /><br /> Cette valeur constitue en pratique un délai d'expiration dans le pire des cas pour les appareils qui subissent des échecs complets ou partiels. Il peut être utile de la comparer aux observations réelles des réussites typiques. Avec les valeurs par défaut de PartyRegionQualityMeasurementConfiguration, la disponibilité des régions et les modes d'utilisation des joueurs, la bibliothèque Party observe actuellement que la plupart des appareils dans le monde terminent l'ensemble du processus de mesure avec succès en 2,3 secondes ou moins, et que 97 % des appareils le terminent avec succès en moins de 6 secondes. Cette durée devrait augmenter légèrement au fil du temps à mesure que de nouvelles régions sont introduites.   <br /><br /> La valeur par défaut est 15000 (15 secondes) lorsque [PartyOption::RegionQualityMeasurementConfiguration](/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyoption) n'a pas été configuré.   <br /><br /> Une valeur de zéro signifie qu'il n'y a pas de délai d'expiration; toutes les mesures peuvent donc se terminer, quel que soit le temps nécessaire aux régions pour réussir ou échouer. Sinon, la valeur minimale est de 50 millisecondes.

**`highLatencyHintInMilliseconds`**   uint16\_t

Indication du seuil de latence le plus élevé, en millisecondes, au-delà duquel l'application considère qu'une région est trop latente pour consacrer du temps supplémentaire à une mesure détaillée.

Cette valeur cible représente une limite supérieure souple pour la latence des régions. Elle n'empêche pas directement d'inclure des régions dont la latence mesurée est plus élevée, mais elle amène la bibliothèque Party à choisir des valeurs de délai d'expiration et de nouvelle tentative optimisées pour les régions dont la latence est inférieure à ce nombre. Elle est également examinée pour chaque région une fois le nombre minimal de réponses (configuré dans le champ *minRequiredSuccessfulResponses*) reçu. Si la latence médiane mesurée pour une région est supérieure à cette cible, le nombre idéal de réponses (configuré dans le champ *idealNumberOfSuccessfulResponses*) n'est pas utilisé et aucune autre tentative de mesure n'est envoyée. <br /><br /> Cette valeur ne peut pas être zéro.   <br /><br /> La valeur par défaut est 200 lorsque [PartyOption::RegionQualityMeasurementConfiguration](/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyoption) n'a pas été configuré.

**`minRequiredSuccessfulResponses`**   uint16\_t

Le nombre minimal de réponses réussies aux messages de mesure nécessaires pour chaque région pour une évaluation de base.

Chaque région potentielle à mesurer doit répondre avec succès au moins ce nombre de fois au cours de l'échange de messages légers de mesure de la qualité avant que les résultats soient considérés comme suffisamment précis pour être évalués par rapport à la latence cible du champ *highLatencyHintInMilliseconds*. La définition d'exigences minimales plus élevées produit davantage d'échantillons de mesure, et donc plus de cohérence et de précision face aux fluctuations de paquets aberrantes, au prix d'un temps d'exécution plus long. <br /><br /> Même sans réponses réussies suffisantes, la mesure d'une région particulière est considérée comme terminée si l'un des événements suivants se produit : aucune réponse réussie n'arrive et le nombre de tentatives dépasse la valeur configurée dans le champ *maxRetriesWithNoResponse*; au moins une réponse est arrivée et le nombre de tentatives dépasse la valeur configurée dans le champ *maxTimeoutsAfterResponse*; ou le délai d'expiration global pour toutes les régions, configuré dans le champ *totalMeasurementTimeoutInMilliseconds*, s'est écoulé.   <br /><br /> Cette valeur ne peut pas être zéro.   <br /><br /> La valeur par défaut est 3 lorsque [PartyOption::RegionQualityMeasurementConfiguration](/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyoption) n'a pas été configuré.   <br />
**`idealNumberOfSuccessfulResponses`**   uint16\_t

Le nombre de réponses réussies aux messages de mesure souhaité pour chaque région afin d'obtenir une évaluation approfondie.

Cette valeur représente le nombre total préféré de réponses réussies pour atteindre la précision souhaitée des mesures de latence des régions intéressantes. Cette valeur doit être égale ou supérieure à la valeur minimale du champ *minRequiredSuccessfulResponses*. La bibliothèque Party ne tente d'obtenir la différence de réponses supplémentaires entre le minimum et cette valeur idéale pour une région que si la latence médiane mesurée pour cette région est déjà inférieure ou égale au seuil configuré dans le champ *highLatencyHintInMilliseconds*. Le nombre idéal de réponses de ce champ permet de continuer à affiner la précision des mesures pour les régions susceptibles d'être plus intéressantes pour l'appareil local, sans consacrer ce temps supplémentaire aux régions à latence plus élevée. <br /><br /> Si le nombre minimal de réponses pour une région n'a pas été obtenu, cette cible idéale supplémentaire n'est pas tentée. Sinon, si la limite *maxTimeoutsAfterResponse* de la région est atteinte ou si le délai d'expiration global *totalMeasurementTimeoutInMilliseconds* pour toutes les régions s'écoule, la mesure de la région est considérée comme terminée, même sans avoir reçu ce nombre idéal de réponses réussies.   <br /><br /> La valeur par défaut est 4 lorsque [PartyOption::RegionQualityMeasurementConfiguration](/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyoption) n'a pas été configuré.

**`maxRetriesWithNoResponse`**   uint16\_t

Le nombre maximal de renvois supplémentaires d'un message de mesure initial à une région sans aucune réponse avant de considérer la région comme inaccessible.

Cette valeur configure le nombre total de tentatives supplémentaires, au-delà de la première, que la bibliothèque Party effectue en retournant le premier message léger de mesure de la qualité à une région avant de considérer cette région comme indisponible. Si au moins une réponse réussie est reçue du serveur de balise de qualité de service de la région, ce maximum n'est plus utilisé; c'est alors le champ *maxTimeoutsAfterResponse* qui régit le nombre de tentatives autorisées à expirer. <br /><br /> Des valeurs maximales de nouvelles tentatives plus élevées tolèrent mieux les problèmes environnementaux temporaires tels que la perte de paquets, au prix d'un délai plus long avant l'abandon des régions inaccessibles. La durée maximale absolue autorisée pour la mesure de toutes les régions est plafonnée par la valeur distincte du champ *totalMeasurementTimeoutInMilliseconds*.   <br /><br /> La valeur par défaut est 3 lorsque [PartyOption::RegionQualityMeasurementConfiguration](/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyoption) n'a pas été configuré.

**`maxTimeoutsAfterResponse`**   uint16\_t

Le nombre maximal de tentatives de message de mesure autorisées à expirer pour une région qui a déjà répondu avant de considérer le chemin réseau comme trop peu fiable pour poursuivre la mesure.

Si au moins une réponse réussie a été reçue du serveur de balise de qualité de service d'une région, cette valeur détermine le nombre total de tentatives expirées que la bibliothèque Party autorise en essayant d'obtenir *minRequiredSuccessfulResponses* et *idealNumberOfSuccessfulResponses* résultats de mesure pour la région. <br /><br /> Des valeurs maximales de délai d'expiration plus élevées tolèrent mieux les problèmes environnementaux temporaires tels que la perte de paquets, au prix d'un délai potentiellement plus long pour terminer la mesure des régions présentant ces caractéristiques de mauvaise qualité. La durée maximale absolue autorisée pour la mesure de toutes les régions est plafonnée par la valeur distincte du champ *totalMeasurementTimeoutInMilliseconds*.   <br /><br /> La valeur par défaut est 3 lorsque [PartyOption::RegionQualityMeasurementConfiguration](/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyoption) n'a pas été configuré.

## Remarques

Cette structure peut être utilisée avec [PartyOption::RegionQualityMeasurementConfiguration](/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyoption) pour remplacer ou interroger la configuration actuelle de la bibliothèque Party au moyen de [PartyManager::SetOption()](/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption) ou [PartyManager::GetOption()](/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption), respectivement. Elle configure le comportement de bas niveau du processus de mesure de la qualité des régions associé aux changements d'état [PartyRegionsChangedStateChange](/fr-CA/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange).

## Configuration requise

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

## Voir aussi

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


## Related topics

- [PartyOption](/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyoption.md)
- [PartyRegionsChangedStateChange](/fr-CA/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)
- [Vue d'ensemble de l'API C/C++ de Party](/fr-CA/services/playfab/multiplayer/networking/reference/party_members.md)
- [Notes de version de PlayFab Party](/fr-CA/services/playfab/multiplayer/networking/release-notes.md)
- [PartyManager::GetRegions](/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getregions.md)