버전 관리를 위한 리더보드 정의 만들기
이전 예시에서 리더보드 정의를 만들 때 버전 관리에 있어VersionConfiguration 매개 변수의 중요성에 대한 힌트가 있었습니다. 여기서는 이를 어떻게 사용하고 어떻게 작동하는지 자세히 설명합니다.
VersionConfiguration 매개 변수입니다. 이 매개 변수를 통해 동일한 리더보드의 몇 개 버전을 쿼리할 수 있는지 지정하는 MaxQueryableVersions 설정을 정의할 수 있습니다. 이 경우 12개 버전을 쿼리하도록 설정하여, 가장 최근의 12개 리더보드를 쿼리할 수 있습니다. ResetInterval 매개 변수는 재설정 프로세스가 얼마나 자주 발생하는지 정의합니다. 이 작업은 이전과 동일한 구성으로 비어 있는 리더보드를 만드는 것을 포함하며, 버전 매개 변수는 N = N + 1로 변경됩니다. 리더보드 정의 생성 시 N = 0입니다.
예를 들어, 버전 매개 변수가 2이고 리더보드에 100개의 항목이 있는 리더보드가 있다고 합시다. 이제 해당 리더보드의 버전을 증가시키면, 버전 매개 변수가 3이고 비어 있는 새 리더보드가 결과로 생성됩니다. 한편 이전 리더보드는 쿼리할 수 있도록 시스템에 남아 있습니다.
ResetInterval은 여러 방식으로 동작할 수 있습니다. 이 예시에서는 매월이지만, 개발자의 필요에 따라 변경할 수 있습니다. 이 경우 리더보드가 구성된 순간부터 매월 자동으로 재설정된다는 의미입니다. 지원되는 재설정 전략은 다음과 같습니다.
- Day
- Hour
- Manual
- Month
- Week
리더보드 버전 증가시키기
이 새로운 구성을 통해 토너먼트 모드용으로 동일한 리더보드의 여러 버전을 가질 수 있습니다. 그러나 문제가 발생하여 리더보드를 수동으로 재설정해 토너먼트를 다시 시작해야 하는 경우에는 어떻게 해야 할까요? 이러한 경우 API를 사용하여 수동 재설정을 수행할 수 있습니다. 다음은 SDK를 사용한 예시입니다.이전 버전 쿼리
이제 리더보드의 이전 버전을 쿼리해야 할 경우, 모든 GetLeaderboards API에서 제공되는version 매개 변수를 사용할 수 있습니다. 다음은 SDK를 사용한 예시입니다.
결론
이 튜토리얼에서 우리는 다음 작업을 수행하는 방법을 배웠습니다.- 올바른 재설정 전략으로 리더보드 만들기.
- 리더보드의 버전 증가시키기.
- 리더보드의 이전 버전 쿼리하기.
