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

# PartyRegionsChangedStateChange

> *RegionsChanged* 유형의 상태 변경에 관한 정보입니다.

*RegionsChanged* 유형의 상태 변경에 관한 정보입니다.

## Syntax

```cpp theme={null}
struct PartyRegionsChangedStateChange : PartyStateChange {  
    PartyStateChangeResult result;  
    PartyError errorDetail;  
}  
```

### Members

**`result`**   [PartyStateChangeResult](/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult)

지원되는 지역 목록과 각 지역에 대한 지연 시간을 쿼리하는 백그라운드 작업이 성공했는지 여부를 나타내거나 실패한 이유를 제공합니다.

결과가 [PartyStateChangeResult::Succeeded](/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult)인 경우, [PartyManager::GetRegions()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getregions)에서 제공하는 지역 목록에 작업 결과가 채워집니다. 실패 시, PartyManager::GetRegions()에서 제공하는 지역 목록은 비어 있습니다. <br /><br /> 결과가 [PartyStateChangeResult::FailedToBindToLocalUdpSocket](/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult)인 경우, 라이브러리가 [PartyOption::LocalUdpSocketBindAddress](/services/playfab/multiplayer/networking/reference/enums/partyoption) 옵션에 지정된 로컬 UDP 소켓에 바인딩할 수 없었습니다. 타이틀은 라이브러리 인스턴스를 정리하고, [PartyOption::LocalUdpSocketBindAddress](/services/playfab/multiplayer/networking/reference/enums/partyoption) 옵션을 유효하고 사용 가능한 바인드 주소로 업데이트한 다음 라이브러리를 다시 초기화해야 합니다.

**`errorDetail`**   PartyError

잠재적 오류 상황에 대한 추가 문제 해결 정보를 제공하는 진단 값입니다.

이 오류 세부 정보의 사람이 읽을 수 있는 형태는 [PartyManager::GetErrorMessage()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage)를 통해 가져올 수 있습니다.

## Remarks

사용 가능한 지역 목록 검색 및 이들에 대한 연결 품질 측정은 백그라운드에서 자동으로 수행됩니다. 이 작업은 [PartyOption::RegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption) 옵션을 사용하여 업데이트 모드가 [PartyRegionUpdateMode::Deferred](/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode)로 구성되지 않은 이상 [PartyManager::Initialize()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize)가 호출될 때 처음 시작됩니다. 이 경우에는 지역 업데이트가 전혀 발생하지 않을 수 있습니다. 지연된 지역 업데이트는 애플리케이션이 지역 항목이 없는 배열로 [PartyManager::CreateNewNetwork()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork)를 호출하거나, 기존 네트워크에 연결되어 있지 않은 상태에서 [PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState](/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions)를 포함하는 옵션 플래그로 [PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles), [PartyLocalChatControl::SetTextToSpeechProfile()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settexttospeechprofile) 또는 [PartyLocalChatControl::SetTranscriptionOptions()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions)를 호출할 때만 발생합니다. [PartyOption::RegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption) 옵션은 지역이 새로 고쳐지는 간격을 구성하는 데도 사용할 수 있습니다. <br /><br /> 사용 가능한 지역 목록을 검색하고 이들에 대한 연결 품질을 측정하는 데 걸리는 시간은 많은 환경적 또는 동적 요인과 [PartyOption::RegionQualityMeasurementConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption) 옵션이 저수준 측정 설정을 수정하는 데 사용되었는지에 따라 달라집니다. [PartyRegionQualityMeasurementConfiguration](/services/playfab/multiplayer/networking/reference/structs/partyregionqualitymeasurementconfiguration) 구조체의 *totalMeasurementTimeoutInMilliseconds* 필드는 모든 측정을 완료된 것으로 간주하고 이 상태 변경을 생성하기 전의 최악의 경우 최대 시간 제한을 구성하는 데 사용됩니다.

## Requirements

**Header:** Party.h

## 함께 보기

[Party members](/services/playfab/multiplayer/networking/reference/party_members)\
[PartyManager::GetRegions](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getregions)


## Related topics

- [PartyManager::GetRegions](/ko/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getregions.md)
- [PartyRegionUpdateConfiguration](/ko/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration.md)
- [PartyRegionQualityMeasurementConfiguration](/ko/services/playfab/multiplayer/networking/reference/structs/partyregionqualitymeasurementconfiguration.md)
- [PartyRegionUpdateMode](/ko/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)
- [PlayFab Party QoS measurements](/ko/services/playfab/multiplayer/networking/concepts-regions.md)