跳轉到主要內容
在本教學課程中,我們將說明排行榜的版本設定概念。在許多情況下,我們會想要讓特定排行榜擁有 不同的版本。例如,在具有每月錦標賽模式的遊戲中,排行榜的結構 維持不變,但玩家很可能會變動,在高度競技的遊戲中尤其如此。 我們延續建立基本排行榜中的範例。假設我們的大型電玩遊戲現在非常受歡迎。因此,遊戲推出了名為「Top of the Mountain」的新模式。每個月,遊戲都會舉辦 任何玩家都能參加的錦標賽。排名前 100 名的玩家將會顯示在主功能表的特殊排行榜中, 讓所有人都能看到誰是遊戲中的佼佼者。

建立用於版本設定的排行榜定義

在先前的範例中,建立排行榜定義時,曾提示 VersionConfiguration 參數對版本設定的重要性。在這裡,我們將詳細說明如何使用它以及它的運作方式。
此範例與基本排行榜相比的主要差異在於 VersionConfiguration 參數。此參數可讓我們定義 MaxQueryableVersions 設定,指定我們可以查詢同一個排行榜的多少個版本。在此案例中,我們將其設定為查詢 12 個版本, 這樣就能查詢最近的 12 個排行榜。ResetInterval 參數定義重設流程的發生頻率。此動作包括 建立一個與先前設定相同但為空的排行榜,而版本參數會依下列方式變更:N = N + 1,其中在 建立排行榜定義時 N = 0。 例如,假設我們有一個版本參數等於 2 的排行榜,其中有一百個項目。現在, 當我們遞增該排行榜的版本時,結果會是一個版本參數等於 3 且為空的新排行榜。 同時,先前的排行榜仍保留在系統中以供查詢。 ResetInterval 可以透過多種方式運作。在此範例中是每月一次,但可以根據開發人員的需求變更。在此特定 案例中,這表示排行榜將從設定的那一刻起每月自動重設。我們支援下列重設策略:
  • Day
  • Hour
  • Manual
  • Month
  • Week
如需所有可用設定的詳細資訊,請在此參閱 API 文件: API 參考:建立排行榜

遞增排行榜的版本

有了這個新設定,我們就能為錦標賽模式擁有同一個排行榜的多個版本。 但如果因為發生問題而需要手動重設排行榜並重新開始錦標賽,該怎麼辦? 在這種情況下,我們可以使用 API 執行手動重設。以下是使用 SDK 的範例:

查詢舊版本

現在,如果我們需要查詢排行榜的舊版本,可以使用所有 GetLeaderboards API 上都提供的 version 參數。 以下是使用 SDK 的範例:
現在我們已準備好處理排行榜版本設定的任何挑戰。這裡有一個重要的面向:我們決定保留為版本的 排行榜定義數目將會被計量,因為它們會使用服務中的儲存空間。在此深入了解:

結論

在本教學課程中,我們學到了如何執行下列作業:
  • 使用正確的重設策略建立排行榜。
  • 遞增排行榜的版本。
  • 查詢排行榜的舊版本。

另請參閱

最後修改於 2026年10月20日