Skip to main content
이 튜토리얼에서는 리더보드의 버전 관리 개념을 설명합니다. 주어진 리더보드에 여러 버전이 필요한 경우가 여러 가지 있습니다. 예를 들어, 월간 토너먼트 모드가 있는 게임에서는 리더보드의 구조는 동일하게 유지되지만, 특히 매우 경쟁적인 게임에서는 플레이어가 대부분 바뀝니다. 기본 리더보드 만들기의 예시를 계속 사용합니다. 아케이드 게임이 매우 인기를 얻었다고 상상해 보세요. 그래서 “Top of the Mountain”이라는 새 모드가 도입됩니다. 매월 어떤 플레이어든 참여할 수 있는 토너먼트를 개최합니다. 상위 100위 안에 든 사람은 메인 메뉴의 특별 리더보드에 표시되어 모두가 게임의 최고 실력자를 볼 수 있게 됩니다.

버전 관리를 위한 리더보드 정의 만들기

이전 예시에서 리더보드 정의를 만들 때 버전 관리에 있어 VersionConfiguration 매개 변수의 중요성에 대한 힌트가 있었습니다. 여기서는 이를 어떻게 사용하고 어떻게 작동하는지 자세히 설명합니다.
이 예시와 기본 리더보드 간의 주요 차이점은 VersionConfiguration 매개 변수입니다. 이 매개 변수를 통해 동일한 리더보드의 몇 개 버전을 쿼리할 수 있는지 지정하는 MaxQueryableVersions 설정을 정의할 수 있습니다. 이 경우 12개 버전을 쿼리하도록 설정하여, 가장 최근의 12개 리더보드를 쿼리할 수 있습니다. ResetInterval 매개 변수는 재설정 프로세스가 얼마나 자주 발생하는지 정의합니다. 이 작업은 이전과 동일한 구성으로 비어 있는 리더보드를 만드는 것을 포함하며, 버전 매개 변수는 N = N + 1로 변경됩니다. 리더보드 정의 생성 시 N = 0입니다. 예를 들어, 버전 매개 변수가 2이고 리더보드에 100개의 항목이 있는 리더보드가 있다고 합시다. 이제 해당 리더보드의 버전을 증가시키면, 버전 매개 변수가 3이고 비어 있는 새 리더보드가 결과로 생성됩니다. 한편 이전 리더보드는 쿼리할 수 있도록 시스템에 남아 있습니다. ResetInterval은 여러 방식으로 동작할 수 있습니다. 이 예시에서는 매월이지만, 개발자의 필요에 따라 변경할 수 있습니다. 이 경우 리더보드가 구성된 순간부터 매월 자동으로 재설정된다는 의미입니다. 지원되는 재설정 전략은 다음과 같습니다.
  • Day
  • Hour
  • Manual
  • Month
  • Week
사용 가능한 모든 구성에 대한 자세한 내용은 API 설명서를 확인하세요. API Reference Creating a Leaderboard

리더보드 버전 증가시키기

이 새로운 구성을 통해 토너먼트 모드용으로 동일한 리더보드의 여러 버전을 가질 수 있습니다. 그러나 문제가 발생하여 리더보드를 수동으로 재설정해 토너먼트를 다시 시작해야 하는 경우에는 어떻게 해야 할까요? 이러한 경우 API를 사용하여 수동 재설정을 수행할 수 있습니다. 다음은 SDK를 사용한 예시입니다.

이전 버전 쿼리

이제 리더보드의 이전 버전을 쿼리해야 할 경우, 모든 GetLeaderboards API에서 제공되는 version 매개 변수를 사용할 수 있습니다. 다음은 SDK를 사용한 예시입니다.
이제 리더보드의 버전 관리와 관련된 어떤 과제도 다룰 준비가 되었습니다. 여기서 중요한 점은 버전으로 유지하기로 결정한 리더보드 정의의 수는 서비스 내 저장소를 사용하므로 요금이 부과된다는 것입니다. 이에 대한 자세한 내용은 다음을 참조하세요.

결론

이 튜토리얼에서 우리는 다음 작업을 수행하는 방법을 배웠습니다.
  • 올바른 재설정 전략으로 리더보드 만들기.
  • 리더보드의 버전 증가시키기.
  • 리더보드의 이전 버전 쿼리하기.

함께 보기

마지막 수정일 2026년 8월 13일