다음을 통해 공유


PartyRegionUpdateConfiguration

파티 라이브러리에서 자동 영역 검색 및 연결 품질 측정 업데이트를 수행하는 방법을 제어하는 데 사용되는 구성입니다.

구문

struct PartyRegionUpdateConfiguration {  
    PartyRegionUpdateMode mode;  
    uint32_t refreshIntervalInSeconds;  
}  

멤버

modePartyRegionUpdateMode

영역 검색 및 연결 품질 측정 업데이트가 수행되는 시기를 제어하는 모드입니다.

기본값은 PartyOption::RegionUpdateConfiguration이 구성되지 않은 경우 PartyRegionUpdateMode::Immediate입니다.

refreshIntervalInSeconds uint32_t

새 영역 검색 및 연결 품질 측정 프로세스가 시작되기 전에 영역 품질 측정이 완료된 후 경과할 수 있는 시간(초)입니다.

이 새로 고침 간격은 모드 필드에 정의된 업데이트 모드에서 다음 영역 품질 측정을 시작할 수 있는 시기를 결정하기 위해 PartyRegionsChangedStateChange가 제공될 때마다 사용됩니다.

새로 고침을 받을 자격이 있다고 해서 새로 고침이 정확한 시간에 시작된다는 보장은 없습니다. 모드 필드가 PartyRegionUpdateMode::Deferred로 설정된경우 영역 업데이트를 트리거하기 위해 적용 가능한 메서드 중 하나가 호출될 때까지 다음 새로 고침이 수행되지 않습니다. 또한 라이브러리는 로컬 장치가 더 이상 파티 네트워크에 없을 때까지 대기하고, 의도하지 않게 동기화된 여러 디바이스에서 PlayFab 서비스 로드를 방지하기 위해 약간의 임의 지연을 적용합니다.

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

값이 0이면 파티 라이브러리가 나중에 측정값을 자동으로 새로 고치지 않습니다. 그렇지 않으면 허용되는 최소값은 30초입니다.

비고

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

요구 사항

헤더: Party.h

참고 항목

파티 멤버
PartyOption::RegionUpdateConfiguration
PartyRegionUpdateMode
PartyRegionsChangedStateChange
PartyManager::SetOption
PartyManager::GetOption