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