다음을 통해 공유

PartyManager::GetRegions

  • 아티클

왕복 대기 시간 정보와 함께 타이틀이 구성된 지역 집합을 포함하는 배열을 가져옵니다.

구문

PartyError GetRegions(  
    uint32_t* regionCount,  
    const PartyRegion** regions  
)

매개 변수

regionCount uint32_t*
출력

regions에서 제공된 지역의 출력 번호입니다.

regionsPartyRegion**
라이브러리 할당 출력 배열의 크기*regionCount

지역 세트를 포함하는 라이브러리 할당 출력 배열입니다.

반환 값

PartyError

호출이 성공한 경우 c_partyErrorSuccess이고 그렇지 않은 경우 오류 코드입니다. 사용자가 읽을 수 있는 형식의 오류 코드는 GetErrorMessage()를 통해 검색할 수 있습니다.

비고

이 메서드에서 제공하는 배열은 첫 번째 PartyRegionsChangedStateChange가 제공될 때까지 채워지지 않습니다. 각 후속 PartyRegionsChangedStateChange는 이 지역 세트에 대한 업데이트를 나타냅니다. PartyRegionUpdateMode::Deferred의 업데이트 모드를 구성하는 데 PartyOption::RegionUpdateConfiguration 옵션을 사용하지 않는 한 이 집합을 채우는 백그라운드 작업은 Initialize()가 호출될 때시작됩니다. 지연 모드는 애플리케이션이 0 항목 영역 배열을 사용하여 CreateNewNetwork()를 호출하거나 네트워크에 연결되지 않고 PartyLocalChatControl:::PopulateAvailableTextToSpeechProfiles(), PartyLocalChatControl::SetTextToSpeechProfile() 또는 PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState를 포함하는 옵션 플래그가 있는 PartyLocalChatControl::SetTranscriptionOptions()를 호출할 때까지 영역 검색 및 연결 품질 측정이 시작되지 않음을 의미합니다. PartyOption::RegionUpdateConfiguration 옵션을 사용하여 영역 배열을 새로 고칠 간격을 구성할 수도 있습니다.

반환된 배열은 대기 시간이 증가하는 순서대로 정렬됩니다. 영역의 대기 시간은 UDP 데이터그램을 해당 영역의 PlayFab 서비스 품질 신호로 보내고 응답을 받는 데 걸리는 엔드 투 엔드 시간으로 정의됩니다. 라이브러리에서는 고화질 결과를 계산하기 위해 각 영역의 대기 시간을 여러 번 측정합니다. 애플리케이션은 PartyOption::RegionQualityMeasurementConfiguration 옵션을 사용하여 이 연결 품질 측정 절차의 하위 수준 측면을 변경할 수 있습니다.

UINT32_MAX에 해당하는 대기 시간은 해당 영역이 지원되지만, 라이브러리 내부 오류가 발생하거나 신호로부터 응답을 받지 않고 시간 제한에 도달하여 대기 시간 정보를 확인할 수 없다는 것을 나타냅니다. 이 대기 시간은 진단 목적으로 사용되거나(모든 지역에 대한 UINT32_MAX 대기 시간은 로컬 구성 문제를 나타낼 수 있음) 지역을 선택하는 동안 실행할 수 없는 지역을 필터링하는 데 사용될 수 있습니다.

PartyRegion 구조로 반환되는 이름은 현재 사용자의 언어로 영역화되지 않았으며 문제 해결 외에는 UI에 문자열을 직접 표시하는 것이 좋습니다.

반환된 영역 세트가 타이틀 수명 동안 동일하게 유지되는 것으로 가정해서는 안 됩니다. PlayFab 파티 라이브러리는 시간이 지남에 따라 사용 가능한 지역에 대한 추가 사항과 변경 내용을 자동으로 활용하여 최종 사용자 환경을 지속적으로 개선합니다.

요구 사항

헤더: Party.h

참고 항목

PartyManager
PartyRegionsChangedStateChange
PartyManager::CreateNewNetwork