跳轉到主要內容
在本教學課程中,我們將說明統計資料的版本控制概念。在許多情況下,我們會想要擁有特定統計資料的不同版本。例如,如果遊戲有賽季,很可能會在新賽季開始時重設統計資料。 我們將繼續使用建立基本統計資料中的範例。假設我們的射擊遊戲變得非常受歡迎。因此,引進了賽季的概念。每個月,遊戲都會為所有玩家群推出新的主題賽季。所以我們想要為每個賽季保留獨立的統計資料。

建立用於版本控制的統計資料定義

在上一個範例中,建立統計資料定義時,有提示到 VersionConfiguration 參數對版本控制的重要性。在這裡,我們將詳細說明如何使用它以及它的運作方式。
與基本統計資料相比,此範例的主要差異在於 VersionConfiguration 參數。此參數可讓我們定義 MaxQueryableVersions 設定,指定我們可以查詢同一統計資料的多少個版本。在此案例中,我們將其設定為可查詢 12 個版本。ResetInterval 參數定義重設程序的發生頻率。此程序涉及建立一個與先前設定相同但沒有任何值的統計資料,且版本參數會依下列方式變更:N = N + 1,在建立統計資料定義時 N = 0。 例如,假設我們有一個版本參數等於二且具有特定值的統計資料。現在我們遞增該統計資料的版本,結果將是一個版本參數等於三且沒有任何值的新統計資料。同時,先前的統計資料仍保留在系統中以供查詢。 ResetInterval 可以多種方式運作。在此範例中是每月一次,但可以根據開發人員的需求進行變更。在此特定案例中,這表示排行榜將從設定的那一刻起每月自動重設。我們支援下列重設策略:
  • Day
  • Hour
  • Manual
  • Month
  • Week
建立統計資料的 API 參考

遞增統計資料的版本

透過這個新設定,我們可以為不同的賽季擁有同一統計資料的多個版本。但如果因為某個問題而需要手動重設排行榜並重新開始賽季,該怎麼辦?在這種情況下,我們可以使用 API 執行手動重設。以下是使用 SDK 的範例:
現在我們已準備好處理統計資料版本控制的任何挑戰。這裡的一個重要層面是,我們決定保留為版本的統計資料定義數目將會被計量,因為它們會使用服務中的儲存空間。請在此查看更多資訊:

結論

在本教學課程中,我們學到了如何執行下列作業:
  • 使用正確的重設策略建立統計資料
  • 遞增統計資料的版本

另請參閱

最後修改於 2026年10月8日