GS2-Ranking API 레퍼런스

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

랭킹에는 모두가 동일한 데이터를 참조하는 글로벌 랭킹과,
프렌드 간이나 길드 내 랭킹처럼 사용자에 따라 보이는 랭킹 내용이 다른 스코프드 랭킹이 있습니다.

글로벌 랭킹은 15분~24시간 사이에서 지정한 간격으로 랭킹 집계 처리가 이루어지며,
게임 사용자로부터의 요청에는 사전에 집계된 결과로 응답합니다.
이를 통해 대량의 게임 플레이어가 있더라도 응답 시간이 변하지 않도록 설계되어 있습니다.

스코프드 랭킹은 각 게임 플레이어가 스코어 버킷을 가지며, 구독하고 있는 게임 플레이어가 스코어를 등록하면 스코어 버킷에 스코어가 추가됩니다.
각 게임 플레이어는 자신의 스코어 버킷 내의 스코어를 사용하여 랭킹을 처리합니다.

글로벌 랭킹·스코프드 랭킹 모두 사용자 ID별로 보유할 수 있는 스코어를 1개로 할지, 여러 개 보유할 수 있게 할지를 설정할 수 있습니다.
랭킹을 등록했을 때 마지막에 등록한 스코어만을 랭킹 대상으로 할지, 등록한 모든 스코어를 랭킹 대상으로 할지를 설정할 수 있습니다.
모든 스코어를 랭킹 대상으로 하는 경우 데이터양이 급격히 늘어나기 쉽습니다. 그 결과 GS2 이용 요금에도 영향을 미치게 됩니다.
게임 시스템상 큰 이유가 없다면 마지막에 등록된 스코어 1개만이 랭킹 대상이 되도록 설정하는 것을 권장합니다.