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

> 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](/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode)

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](/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode) quando [PartyOption::RegionUpdateConfiguration](/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyoption) 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](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange) é 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*. <br /><br /> 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](/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode), 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.   <br /><br /> O valor padrão é 28800 (8 horas) quando [PartyOption::RegionUpdateConfiguration](/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyoption) não foi configurada.   <br /><br /> 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](/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyoption) para substituir ou consultar a configuração atual da biblioteca do Party por meio de [PartyManager::SetOption()](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption) ou [PartyManager::GetOption()](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption), 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](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange).

## Requisitos

**Cabeçalho:** Party.h

## Confira também

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


## Related topics

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