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

> Party 라이브러리가 자동 지역 검색 및 연결 품질 측정 업데이트를 수행하는 방법을 제어하는 데 사용하는 구성입니다.

Party 라이브러리가 자동 지역 검색 및 연결 품질 측정 업데이트를 수행하는 방법을 제어하는 데 사용하는 구성입니다.

## Syntax

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

### Members

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

지역 검색 및 연결 품질 측정 업데이트가 수행되는 시점을 제어하는 모드입니다.

[PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/enums/partyoption.md)이 구성되지 않은 경우 기본값은 [PartyRegionUpdateMode::Immediate](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)입니다.

**`refreshIntervalInSeconds`**   uint32\_t

지역 품질 측정이 완료된 후 새로운 지역 검색 및 연결 품질 측정 프로세스가 시작될 수 있기 전에 경과가 허용되는 시간(초)입니다.

이 새로 고침 간격은 *mode* 필드에 정의된 업데이트 모드에 따라 다음 지역 품질 측정을 시작할 수 있는 시점을 결정하기 위해 [PartyRegionsChangedStateChange](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)가 제공될 때마다 사용됩니다. \
\
 새로 고침 자격을 얻는다고 해서 정확히 그 시점에 새로 고침이 시작된다는 보장은 없습니다. *mode* 필드가 [PartyRegionUpdateMode::Deferred](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)로 설정된 경우, 지역 업데이트를 트리거하기 위해 해당하는 메서드 중 하나가 호출될 때까지 다음 새로 고침이 발생하지 않습니다. 라이브러리는 또한 로컬 디바이스가 더 이상 Party 네트워크에 있지 않을 때까지 대기하고, 여러 개의 의도치 않게 동기화된 디바이스로 인한 PlayFab 서비스 부하를 방지하기 위해 소량의 임의 지연을 적용합니다.   \
\
 [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/enums/partyoption.md)이 구성되지 않은 경우 기본값은 28800(8시간)입니다.   \
\
 값이 0이면 Party 라이브러리는 향후 측정을 자동으로 새로 고치지 않습니다. 그렇지 않으면 최소 허용값은 30초입니다.

## Remarks

이 구조체는 [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/enums/partyoption.md)과 함께 사용하여 Party 라이브러리의 현재 구성을 각각 [PartyManager::SetOption()](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption.md) 또는 [PartyManager::GetOption()](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption.md)을 통해 재정의하거나 쿼리할 수 있습니다. [PartyRegionsChangedStateChange](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md) 상태 변경을 생성하는 지역 검색 및 연결 품질 측정 프로세스의 동작을 구성합니다.

## Requirements

**Header:** Party.h

## 함께 보기

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


## Related topics

- [PartyRegionUpdateMode](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)
- [PartyOption](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/enums/partyoption.md)
- [Party C/C++ API 개요](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/party_members.md)
- [PartyRegionQualityMeasurementConfiguration](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/structs/partyregionqualitymeasurementconfiguration.md)
- [PartyRegionsChangedStateChange](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)