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

> A configuração usada pela biblioteca do Party para controlar como ela realiza a descoberta automática de regiões e as atualizações de medição da qualidade da conexão.

A configuração usada pela biblioteca do Party para controlar como ela realiza a descoberta automática de regiões e as atualizações de medição da qualidade da conexão.

## Sintaxe

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

### Membros

**`mode`**   [PartyRegionUpdateMode](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)

O modo que controla quando a descoberta de regiões e as atualizações de medição da qualidade da conexão são realizadas.

O valor padrão é [PartyRegionUpdateMode::Immediate](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md) quando [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyoption.md) não foi configurada.

**`refreshIntervalInSeconds`**   uint32\_t

O número de segundos que deve decorrer após a conclusão das medições de qualidade das regiões antes que um novo processo de descoberta de regiões e de medição da qualidade da conexão possa começar.

Esse intervalo de atualização é usado sempre que uma [PartyRegionsChangedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md) é fornecida, para determinar quando a próxima medição de qualidade das regiões estará qualificada para começar no modo de atualização definido pelo campo *mode*. \
\
 Tornar-se qualificado para uma atualização não garante que ela comece exatamente nesse momento. Se o campo *mode* estiver definido como [PartyRegionUpdateMode::Deferred](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md), a próxima atualização só acontecerá quando um dos métodos aplicáveis for chamado para disparar uma atualização de região. A biblioteca também aguarda até que o dispositivo local não esteja mais em nenhuma rede do Party e aplica um pequeno atraso aleatório para tentar evitar carga no serviço PlayFab causada por vários dispositivos sincronizados involuntariamente.   \
\
 O valor padrão é 28800 (8 horas) quando [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyoption.md) não foi configurada.   \
\
 Um valor zero faz com que a biblioteca do Party nunca atualize automaticamente as medições no futuro. Caso contrário, o valor mínimo permitido é 30 segundos.

## Comentários

Esta estrutura pode ser usada junto com [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyoption.md) para substituir ou consultar a configuração atual da biblioteca do Party por meio de [PartyManager::SetOption()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption.md) ou [PartyManager::GetOption()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption.md), respectivamente. Ela configura o comportamento do processo de descoberta de regiões e de medição da qualidade da conexão que produz alterações de estado [PartyRegionsChangedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md).

## Requisitos

**Cabeçalho:** Party.h

## Confira também

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


## Related topics

- [PartyRegionUpdateMode](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)
- [PartyOption](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyoption.md)
- [Visão geral da API C/C++ do Party](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/party_members.md)
- [PartyRegionQualityMeasurementConfiguration](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionqualitymeasurementconfiguration.md)
- [PartyRegionsChangedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)