PartyRegionUpdateMode

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

구문

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

상수

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

요구 사항

헤더: Party.h

참고 항목

파티 멤버
PartyOption::RegionUpdateConfiguration
PartyRegionUpdateConfiguration
PartyRegionsChangedStateChange
PartyCreateNewNetworkCompletedStateChange
PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange
PartySetTextToSpeechProfileCompletedStateChange
PartySetTranscriptionOptionsCompletedStateChange
PartyManager::Initialize
PartyManager::CreateNewNetwork
PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles
PartyLocalChatControl::SetTextToSpeechProfile
PartyLocalChatControl::SetTranscriptionOptions