GS2-Ranking2 API 레퍼런스

랭킹 기능

스코어나 클리어 타임의 랭킹 처리를 구현합니다.

GS2-Ranking2는 글로벌 랭킹, 클러스터 랭킹, 구독 랭킹의 세 종류를 제공합니다.

글로벌 랭킹은 점수를 즉시 반영하고 상위 1,000명만 랭킹으로 보관하며, 그보다 낮은 플레이어는 순위권 밖으로 처리합니다.
클러스터 랭킹은 길드 ID와 같은 클러스터 ID마다 별도의 랭킹을 만듭니다. 점수를 등록할 때 플레이어가 대상 클러스터에 소속되어 있는지 검증할 수도 있습니다.
구독 랭킹은 플레이어가 구독한 다른 플레이어의 점수로 개인별 랭킹을 구성하여 친구 랭킹과 같은 비대칭 관계에 이용할 수 있습니다. 점수는 비동기로 반영되며 일반적으로 1초 이내에 갱신됩니다.

랭킹에는 GS2-Schedule 이벤트를 시즌으로 연결할 수 있습니다.
이벤트 반복마다 새 시즌을 시작하고 과거 결과를 보관하며 순위 임계값에 따른 보상을 설정할 수 있습니다.