PartyRegionsChangedStateChange
RegionsChanged 상태 변경 유형과 관련된 정보입니다.
구문
struct PartyRegionsChangedStateChange : PartyStateChange {
PartyStateChangeResult result;
PartyError errorDetail;
}
멤버
resultPartyStateChangeResult
지원되는 영역 목록과 각 영역의 대기 시간을 쿼리하는 백그라운드 작업이 성공했는지 여부를 나타내거나 실패한 이유를 제공합니다.
결과가 PartyStateChangeResult::Succeeded이면 PartyManager::GetRegions()에서 제공하는 영역 목록이 작업 결과로 채워집니다. 실패하면 PartyManager::GetRegions()에 의해 제공되는 영역 목록이 비어 있습니다.
결과가 PartyStateChangeResult::FailedToBindToLocalUdpSocket이면 라이브러리가 PartyOption::LocalUdpSocketBindAddress 옵션에 지정된 로컬 UDP 소켓에 바인딩할 수 없습니다. 타이틀은 라이브러리의 인스턴스를 정리하고, PartyOption::LocalUdpSocketBindAddress 옵션을 유효한 사용 가능한 바인딩 주소로 업데이트하고, 라이브러리를 다시 초기화해야 합니다.
errorDetail PartyError
잠재적인 오류 조건에 대한 추가 문제 해결 정보를 제공하는 진단 값입니다.
사용자가 읽을 수 있는 형식의 오류 세부 정보는 PartyManager::GetErrorMessage()를 통해 검색할 수 있습니다.
비고
사용 가능한 영역 목록을 검색하고 연결 품질을 측정하는 작업은 백그라운드에서 자동으로 발생합니다. 이 작업은 PartyOption::RegionUpdateConfiguration 옵션을 사용하여 PartyRegionUpdateMode::Deferred의 업데이트 모드를 구성하지 않는 한 PartyManager::Initialize()가 호출될 때 처음 시작됩니다. 이 경우 영역 업데이트가 전혀 발생하지 않을 수 있습니다. 지연된 영역 업데이트는 애플리케이션이 0 항목 영역 배열을 사용하여 PartyManager::CreateNewNetwork()를 호출하거나 기존 네트워크에 연결되어 있지 않지만 PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState를 포함하는 옵션 플래그를 사용하여 PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles(), PartyLocalChatControl::SetTextToSpeechProfile() 또는 PartyLocalChatControl::SetTranscriptionOptions()를 호출하는 경우에만 발생합니다. PartyOption::RegionUpdateConfiguration 옵션을 사용하여 영역을 새로 고친 후 간격을 구성할 수도 있습니다.
사용 가능한 영역 목록을 검색하고 연결 품질을 측정하는 데 걸리는 시간은 많은 환경 또는 동적 요인에 따라 달라지며, PartyOption::RegionQualityMeasurementConfiguration 옵션이 하위 수준 측정 설정을 수정하는 데 사용되었는지 여부에 따라 달라집니다. PartyRegionQualityMeasurementConfiguration 구조의 totalMeasurementTimeoutInMilliseconds 필드는 모든 측정이 완료된 것을 고려하고 이 상태 변경을 생성하기 전에 최악의 경우 최대 시간 제한을 구성하는 데 사용됩니다.
요구 사항
헤더: Party.h