建立用於版本設定的排行榜定義
在先前的範例中,建立排行榜定義時,曾提示VersionConfiguration
參數對版本設定的重要性。在這裡,我們將詳細說明如何使用它以及它的運作方式。
VersionConfiguration 參數。此參數可讓我們定義
MaxQueryableVersions 設定,指定我們可以查詢同一個排行榜的多少個版本。在此案例中,我們將其設定為查詢 12 個版本,
這樣就能查詢最近的 12 個排行榜。ResetInterval 參數定義重設流程的發生頻率。此動作包括
建立一個與先前設定相同但為空的排行榜,而版本參數會依下列方式變更:N = N + 1,其中在
建立排行榜定義時 N = 0。
例如,假設我們有一個版本參數等於 2 的排行榜,其中有一百個項目。現在,
當我們遞增該排行榜的版本時,結果會是一個版本參數等於 3 且為空的新排行榜。
同時,先前的排行榜仍保留在系統中以供查詢。
ResetInterval 可以透過多種方式運作。在此範例中是每月一次,但可以根據開發人員的需求變更。在此特定
案例中,這表示排行榜將從設定的那一刻起每月自動重設。我們支援下列重設策略:
- Day
- Hour
- Manual
- Month
- Week
遞增排行榜的版本
有了這個新設定,我們就能為錦標賽模式擁有同一個排行榜的多個版本。 但如果因為發生問題而需要手動重設排行榜並重新開始錦標賽,該怎麼辦? 在這種情況下,我們可以使用 API 執行手動重設。以下是使用 SDK 的範例:查詢舊版本
現在,如果我們需要查詢排行榜的舊版本,可以使用所有 GetLeaderboards API 上都提供的version 參數。
以下是使用 SDK 的範例:
結論
在本教學課程中,我們學到了如何執行下列作業:- 使用正確的重設策略建立排行榜。
- 遞增排行榜的版本。
- 查詢排行榜的舊版本。
