PartyRegionUpdateMode - XBOX Game Development Documentation

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

Syntax

enum class PartyRegionUpdateMode    
{  
    Immediate = 0,  
    Deferred = 1,  
}  

Constants

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

Requirements

Header: Party.h

See also

Party members
PartyOption::RegionUpdateConfiguration
PartyRegionUpdateConfiguration
PartyRegionsChangedStateChange
PartyCreateNewNetworkCompletedStateChange
PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange
PartySetTextToSpeechProfileCompletedStateChange
PartySetTranscriptionOptionsCompletedStateChange
PartyManager::Initialize
PartyManager::CreateNewNetwork
PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles
PartyLocalChatControl::SetTextToSpeechProfile
PartyLocalChatControl::SetTranscriptionOptions

마지막 수정일 2026년 8월 13일

관련 항목

PartyRegionUpdateConfiguration PartyRegionsChangedStateChange PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles PartyManager::GetRegions PartyLocalChatControl::SetTranscriptionOptions

⌘I