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

# PartyRegionUpdateMode

> Party 라이브러리가 자동 지역 검색 및 연결 품질 측정을 수행하는 방식을 나타내는 구성 모드입니다.

Party 라이브러리가 [PartyRegionUpdateConfiguration](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration.md) 구조체의 일부로 자동 지역 검색 및 연결 품질 측정을 수행하는 방식을 나타내는 구성 모드입니다.

## Syntax

```cpp theme={null}
enum class PartyRegionUpdateMode    
{  
    Immediate = 0,  
    Deferred = 1,  
}  
```

## Constants

| Constant | Description |
| - | - |
| Immediate | 사용 가능한 지역 목록을 검색하고 지역에 대한 연결 품질을 측정하는 작업을 가능한 한 빨리 자동으로 시작합니다.  Party 라이브러리는 PartyManager::Initialize()가 처음 호출될 때 사용 가능한 지역을 자동으로 검색하고 지역에 대한 연결 품질을 측정합니다.   Party 라이브러리는 또한 PartyManager::Cleanup()이 호출될 때까지 목록과 품질 측정을 주기적으로 새로 고칩니다. 이미 기존 Party 네트워크에 연결되어 있거나 연결 중인 경우, 모든 Party 네트워크에서 연결이 끊길 때까지 새로 고침이 지연됩니다. 주기적인 새로 고침 간격은 포함된 [PartyRegionUpdateConfiguration](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration.md) 구조체의 *refreshIntervalInSeconds* 필드를 사용하여 구성할 수 있습니다.     애플리케이션에는 측정 작업이 완료될 때마다 사용 가능한 지역 또는 실패 [PartyStateChangeResult](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult.md)을 나타내는 [PartyRegionsChangedStateChange](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)가 자동으로 제공됩니다.     이 모드는 [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/enums/partyoption.md)이 구성되지 않은 경우의 기본값입니다. |
| Deferred | 새 Party 네트워크를 생성하거나 특정 텍스트 음성 변환 또는 음성 텍스트 변환 기능을 사용할 때까지 사용 가능한 지역 목록을 검색하고 지역에 대한 연결 품질을 측정하는 작업을 지연합니다.  Party 라이브러리는 애플리케이션이 항목이 없는 지역 목록 배열로 [PartyManager::CreateNewNetwork()](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork.md)를 호출하거나, 기존 네트워크에 연결되지 않은 상태에서 [PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles()](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles.md), [PartyLocalChatControl::SetTextToSpeechProfile()](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settexttospeechprofile.md) 또는 [PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions.md)를 포함하는 옵션 플래그로 [PartyLocalChatControl::SetTranscriptionOptions()](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md)를 호출하지 않는 한 사용 가능한 지역을 자동으로 검색하거나 지역에 대한 연결 품질을 측정하지 않습니다. 지연된 지역 검색 및 품질 측정이 시작되면, 트리거링 작업의 [PartyCreateNewNetworkCompletedStateChange](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/structs/partycreatenewnetworkcompletedstatechange.md), [PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/structs/partypopulateavailabletexttospeechprofilescompletedstatechange.md), [PartySetTextToSpeechProfileCompletedStateChange](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/structs/partysettexttospeechprofilecompletedstatechange.md), 또는 [PartySetTranscriptionOptionsCompletedStateChange](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/structs/partysettranscriptionoptionscompletedstatechange.md) 완료 상태 변경 이전에, 사용 가능한 지역 또는 실패 [PartyStateChangeResult](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult.md)를 나타내는 [PartyRegionsChangedStateChange](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)가 제공됩니다.   설명된 매개 변수로 위 함수를 후속 호출할 때, 마지막 측정이 성공적으로 수행된 이후 새로 고침 간격이 경과했다면 지역 목록이 다시 검색되고 측정됩니다. 이미 기존 Party 네트워크에 연결되어 있거나 연결 중인 경우, 모든 Party 네트워크에서 연결이 끊길 때까지 새로 고침이 지연됩니다. 새로 고침 간격은 포함된 [PartyRegionUpdateConfiguration](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration.md) 구조체의 *refreshIntervalInSeconds* 필드를 사용하여 구성할 수 있습니다.     채팅 컨트롤은 텍스트 음성 변환 합성, 음성 텍스트 변환 전사 및 번역에 대한 서비스 사용을 최적화하기 위해 로컬 디바이스 지역 대기 시간 추정값을 내부적으로 사용합니다. PartyRegionUpdateMode::Deferred를 사용하면 이러한 기능에 대한 대기 시간이 더 길어질 수 있습니다. |

## Requirements

**Header:** Party.h

## See also

[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)\
[PartyRegionUpdateConfiguration](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration.md)\
[PartyRegionsChangedStateChange](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)\
[PartyCreateNewNetworkCompletedStateChange](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/structs/partycreatenewnetworkcompletedstatechange.md)\
[PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/structs/partypopulateavailabletexttospeechprofilescompletedstatechange.md)\
[PartySetTextToSpeechProfileCompletedStateChange](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/structs/partysettexttospeechprofilecompletedstatechange.md)\
[PartySetTranscriptionOptionsCompletedStateChange](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/structs/partysettranscriptionoptionscompletedstatechange.md)\
[PartyManager::Initialize](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize.md)\
[PartyManager::CreateNewNetwork](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork.md)\
[PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles.md)\
[PartyLocalChatControl::SetTextToSpeechProfile](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settexttospeechprofile.md)\
[PartyLocalChatControl::SetTranscriptionOptions](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md)


## Related topics

- [PartyRegionUpdateConfiguration](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration.md)
- [PartyRegionsChangedStateChange](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)
- [PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles.md)
- [PartyManager::GetRegions](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getregions.md)
- [PartyLocalChatControl::SetTranscriptionOptions](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md)