Syntax
Parameters
regionCount uint32_t*출력
regions에 제공된 지역의 출력 개수입니다.
regions PartyRegion**크기가
*regionCount인 라이브러리에서 할당된 출력 배열
지역 집합을 포함하는 라이브러리에서 할당된 출력 배열입니다.
Return value
PartyError 호출이 성공한 경우c_partyErrorSuccess, 그렇지 않으면 오류 코드입니다. 오류 코드의 사람이 읽을 수 있는 형식은 GetErrorMessage()를 통해 검색할 수 있습니다.
Remarks
이 메서드가 제공하는 배열은 첫 번째 PartyRegionsChangedStateChange가 제공될 때까지 채워지지 않습니다. 이후의 각 PartyRegionsChangedStateChange는 이 지역 집합에 대한 업데이트를 나타냅니다. PartyOption::RegionUpdateConfiguration 옵션이 PartyRegionUpdateMode::Deferred 업데이트 모드를 구성하기 위해 사용된 경우가 아니라면, 이 집합을 채우는 백그라운드 작업은 Initialize()가 호출될 때 시작됩니다. 지연 모드는 애플리케이션이 항목이 없는 지역 배열로 CreateNewNetwork()를 호출하거나, 어떤 네트워크에도 연결되어 있지 않은 상태에서 PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles(), PartyLocalChatControl::SetTextToSpeechProfile() 또는 PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState를 포함하는 옵션 플래그와 함께 PartyLocalChatControl::SetTranscriptionOptions()를 호출할 때까지 지역 검색 및 연결 품질 측정이 시작되지 않는다는 것을 의미합니다. PartyOption::RegionUpdateConfiguration 옵션을 사용하여 지역 배열을 새로 고칠 간격을 구성할 수도 있습니다.반환된 배열은 대기 시간이 증가하는 순서로 정렬됩니다. 지역의 대기 시간은 UDP 데이터그램을 지역의 PlayFab Quality of Service 비콘으로 보내고 응답을 받는 데 걸리는 종단 간 시간으로 정의됩니다. 라이브러리는 높은 정확도의 결과를 계산하기 위해 각 지역의 대기 시간을 여러 번 측정합니다. 애플리케이션은 PartyOption::RegionQualityMeasurementConfiguration 옵션을 사용하여 이 연결 품질 측정 절차의 하위 수준 측면을 변경할 수 있습니다.
UINT32_MAX와 동등한 대기 시간은 지역이 지원되지만 라이브러리 내부의 실패로 인해 또는 비콘의 응답을 받지 못하고 타임아웃에 도달하여 대기 시간 정보를 결정할 수 없음을 나타냅니다. 이는 진단 목적으로 사용하거나(모든 지역에 대한 UINT32_MAX 대기 시간은 로컬 구성 문제를 나타낼 가능성이 높음) 지역 선택 중에 실행 가능성이 낮은 지역을 필터링하는 데 사용할 수 있습니다.
PartyRegion 구조체에 반환되는 이름은 현재 사용자의 언어로 지역화되지 않으며, 문자열을 UI에 직접 표시하는 것은 문제 해결 외에는 권장되지 않습니다.
반환되는 지역 집합이 타이틀의 수명 동안 동일하게 유지된다고 가정하지 마세요. PlayFab Party 라이브러리는 시간이 지남에 따라 사용 가능한 지역의 추가 및 변경 사항을 자동으로 활용하여 최종 사용자를 위한 경험을 지속적으로 개선합니다.
Requirements
Header: Party.hSee also
PartyManagerPartyRegionsChangedStateChange
PartyManager::CreateNewNetwork