バージョン管理のためのリーダーボード定義を作成する
前の例では、リーダーボード定義を作成する際に、バージョン管理におけるVersionConfiguration パラメーターの重要性について触れました。ここでは、その使い方と仕組みを詳しく説明します。
VersionConfiguration パラメーターです。このパラメーターにより、同じリーダーボードのバージョンをいくつクエリできるかを指定する MaxQueryableVersions 設定を定義できます。この例では 12 バージョンをクエリできるように設定しており、直近 12 個のリーダーボードをクエリできるようにします。ResetInterval パラメーターは、リセット プロセスの頻度を定義します。この処理では、以前と同じ構成で空のリーダーボードが作成され、version パラメーターは N = N + 1 のように変更されます (リーダーボード定義の作成時は N = 0)。
たとえば、version パラメーターが 2 で、リーダーボードに 100 個のエントリがあるとします。ここでこのリーダーボードのバージョンをインクリメントすると、その結果、version パラメーターが 3 の空のリーダーボードが新しく作成されます。一方で、以前のリーダーボードはクエリ可能な状態でシステムに残ります。
ResetInterval はさまざまな方法で機能します。この例では月次ですが、開発者のニーズに応じて変更できます。この場合、リーダーボードは構成された時点から毎月自動的にリセットされることを意味します。次のリセット戦略をサポートしています:
- Day
- Hour
- Manual
- Month
- Week
リーダーボードのバージョンをインクリメントする
この新しい構成により、トーナメント モードのために同じリーダーボードの複数のバージョンを持てるようになりました。しかし、問題が発生したためにリーダーボードを手動でリセットしてトーナメントを最初からやり直したい場合はどうでしょうか。そのような場合には、API を使って手動でリセットを行うことができます。SDK を使用した例を次に示します:過去のバージョンをクエリする
リーダーボードの過去のバージョンをクエリする必要がある場合は、すべての GetLeaderboards API で利用可能なversion パラメーターを使用できます。SDK を使用した例を次に示します:
まとめ
このチュートリアルでは、次の操作の方法を学びました:- 適切なリセット戦略を持つリーダーボードの作成。
- リーダーボードのバージョンのインクリメント。
- リーダーボードの過去のバージョンのクエリ。
