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

> La configuración usada por la biblioteca Party para controlar cómo realiza las actualizaciones automáticas de detección de regiones y de medición de la calidad de conexión.

La configuración usada por la biblioteca Party para controlar cómo realiza las actualizaciones automáticas de detección de regiones y de medición de la calidad de conexión.

## Sintaxis

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

### Miembros

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

El modo que controla cuándo se realizan las actualizaciones de detección de regiones y de medición de la calidad de conexión.

El valor predeterminado es [PartyRegionUpdateMode::Immediate](/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode) cuando no se ha configurado [PartyOption::RegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption).

**`refreshIntervalInSeconds`**   uint32\_t

El número de segundos que pueden transcurrir después de que se completen las mediciones de calidad de las regiones antes de que pueda comenzar un nuevo proceso de detección de regiones y de medición de la calidad de conexión.

Este intervalo de actualización se usa cada vez que se proporciona un [PartyRegionsChangedStateChange](/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange) para determinar cuándo la siguiente medición de calidad de regiones es apta para iniciarse según el modo de actualización definido por el campo *mode*. <br /><br /> Ser apto para una actualización no garantiza que la actualización comience exactamente en ese momento. Si el campo *mode* está establecido en [PartyRegionUpdateMode::Deferred](/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode), la siguiente actualización no se produce hasta que se llame a uno de los métodos aplicables para desencadenar una actualización de regiones. La biblioteca también espera hasta que el dispositivo local ya no esté en ninguna red de Party y aplica un pequeño retraso aleatorio para intentar evitar la carga del servicio de PlayFab provocada por varios dispositivos sincronizados de manera no intencionada.   <br /><br /> El valor predeterminado es 28800 (8 horas) cuando no se ha configurado [PartyOption::RegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption).   <br /><br /> Un valor de cero hace que la biblioteca Party nunca actualice automáticamente las mediciones en el futuro. De lo contrario, el valor mínimo permitido es 30 segundos.

## Comentarios

Esta estructura se puede usar junto con [PartyOption::RegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption) para invalidar o consultar la configuración actual de la biblioteca Party mediante [PartyManager::SetOption()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption) o [PartyManager::GetOption()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption), respectivamente. Configura el comportamiento del proceso de detección de regiones y de medición de la calidad de conexión que produce los cambios de estado [PartyRegionsChangedStateChange](/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange).

## Requisitos

**Encabezado:** Party.h

## Consulte también

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


## Related topics

- [PartyRegionUpdateMode](/es/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)
- [PartyOption](/es/services/playfab/multiplayer/networking/reference/enums/partyoption.md)
- [Información general de la API de C/C++ de Party](/es/services/playfab/multiplayer/networking/reference/party_members.md)
- [PartyRegionQualityMeasurementConfiguration](/es/services/playfab/multiplayer/networking/reference/structs/partyregionqualitymeasurementconfiguration.md)
- [PartyRegionsChangedStateChange](/es/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)