> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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](https://docs.xbox.com/es/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)

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](https://docs.xbox.com/es/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md) cuando no se ha configurado [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/es/services/playfab/multiplayer/networking/reference/enums/partyoption.md).

**`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](https://docs.xbox.com/es/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md) 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*. \
\
 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](https://docs.xbox.com/es/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md), 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.   \
\
 El valor predeterminado es 28800 (8 horas) cuando no se ha configurado [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/es/services/playfab/multiplayer/networking/reference/enums/partyoption.md).   \
\
 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](https://docs.xbox.com/es/services/playfab/multiplayer/networking/reference/enums/partyoption.md) para invalidar o consultar la configuración actual de la biblioteca Party mediante [PartyManager::SetOption()](https://docs.xbox.com/es/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption.md) o [PartyManager::GetOption()](https://docs.xbox.com/es/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption.md), 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](https://docs.xbox.com/es/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md).

## Requisitos

**Encabezado:** Party.h

## Consulte también

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


## Related topics

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