Skip to main content
Party 라이브러리가 자동 지역 검색 및 연결 품질 측정 업데이트를 수행하는 방법을 제어하는 데 사용하는 구성입니다.

Syntax

Members

mode   PartyRegionUpdateMode 지역 검색 및 연결 품질 측정 업데이트가 수행되는 시점을 제어하는 모드입니다. PartyOption::RegionUpdateConfiguration이 구성되지 않은 경우 기본값은 PartyRegionUpdateMode::Immediate입니다. refreshIntervalInSeconds   uint32_t 지역 품질 측정이 완료된 후 새로운 지역 검색 및 연결 품질 측정 프로세스가 시작될 수 있기 전에 경과가 허용되는 시간(초)입니다. 이 새로 고침 간격은 mode 필드에 정의된 업데이트 모드에 따라 다음 지역 품질 측정을 시작할 수 있는 시점을 결정하기 위해 PartyRegionsChangedStateChange가 제공될 때마다 사용됩니다.

새로 고침 자격을 얻는다고 해서 정확히 그 시점에 새로 고침이 시작된다는 보장은 없습니다. mode 필드가 PartyRegionUpdateMode::Deferred로 설정된 경우, 지역 업데이트를 트리거하기 위해 해당하는 메서드 중 하나가 호출될 때까지 다음 새로 고침이 발생하지 않습니다. 라이브러리는 또한 로컬 디바이스가 더 이상 Party 네트워크에 있지 않을 때까지 대기하고, 여러 개의 의도치 않게 동기화된 디바이스로 인한 PlayFab 서비스 부하를 방지하기 위해 소량의 임의 지연을 적용합니다.

PartyOption::RegionUpdateConfiguration이 구성되지 않은 경우 기본값은 28800(8시간)입니다.

값이 0이면 Party 라이브러리는 향후 측정을 자동으로 새로 고치지 않습니다. 그렇지 않으면 최소 허용값은 30초입니다.

Remarks

이 구조체는 PartyOption::RegionUpdateConfiguration과 함께 사용하여 Party 라이브러리의 현재 구성을 각각 PartyManager::SetOption() 또는 PartyManager::GetOption()을 통해 재정의하거나 쿼리할 수 있습니다. PartyRegionsChangedStateChange 상태 변경을 생성하는 지역 검색 및 연결 품질 측정 프로세스의 동작을 구성합니다.

Requirements

Header: Party.h

함께 보기

Party members
PartyOption::RegionUpdateConfiguration
PartyRegionUpdateMode
PartyRegionsChangedStateChange
PartyManager::SetOption
PartyManager::GetOption
마지막 수정일 2026년 8월 13일