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

# PartyRegionUpdateMode

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

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

## Syntax

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

## Constants

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

## Requirements

**Header:** Party.h

## See also

[Party members](/services/playfab/multiplayer/networking/reference/party_members)\
[PartyOption::RegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption)\
[PartyRegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration)\
[PartyRegionsChangedStateChange](/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange)\
[PartyCreateNewNetworkCompletedStateChange](/services/playfab/multiplayer/networking/reference/structs/partycreatenewnetworkcompletedstatechange)\
[PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange](/services/playfab/multiplayer/networking/reference/structs/partypopulateavailabletexttospeechprofilescompletedstatechange)\
[PartySetTextToSpeechProfileCompletedStateChange](/services/playfab/multiplayer/networking/reference/structs/partysettexttospeechprofilecompletedstatechange)\
[PartySetTranscriptionOptionsCompletedStateChange](/services/playfab/multiplayer/networking/reference/structs/partysettranscriptionoptionscompletedstatechange)\
[PartyManager::Initialize](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize)\
[PartyManager::CreateNewNetwork](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork)\
[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)


## Related topics

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