跳轉到主要內容
在本教學課程中,我們將介紹服務所提供的更多進階功能,例如建立多資料行統計資料,以及查詢統計資料的多種方式。透過這些功能,我們的目標是突破統計資料服務應有能力的極限。 我們以一款高度競爭的射擊遊戲為例,說明這些新功能如何協助我們解決一些問題。在這款遊戲中,有多種武器可讓玩家命中遠距離射擊。我們不只想追蹤遠距離射擊的距離,還想追蹤所使用子彈的口徑。

先決條件

完成建立基本統計資料中的步驟。

建立多資料行統計資料定義

為了開始此範例,我們需要建立比先前更複雜的統計資料定義。 我們將定義多個資料行來對應遠距離射擊的關鍵層面:距離和口徑。下列範例示範如何使用 C# SDK 建立統計資料定義。
這裡最重要的元件是 Columns 參數,它允許多個 StatisticColumn 定義,讓統計資料可以有多個值。唯一的例外是當我們使用 Sum 彙總時。此外,允許的資料行數目上限為 5。

將資料新增至統計資料

現在我們已建立統計資料,接著要新增資料。與我們先前關於此主題之教學課程的主要差異在於,現在我們需要新增兩個不同的值。下列範例示範如何使用 C# SDK 將資料新增至統計資料。
這裡的重點在於要新增之統計資料中的 Scores 參數。在程式碼範例中,我們看到兩個不同的值,它們都是字串,但這只是統計資料中的輸入定義。這些值會被當作數字處理。分數清單的長度應一律與統計資料定義的資料行數目相符。

從統計資料擷取資料

現在我們將學習一種查詢多個實體,並取得與每個實體相關之所有統計資料的方式。下列範例示範如何使用 C# SDK 將資料新增至統計資料。

平手判定

當我們有多資料行統計資料定義時,可能會遇到需要平手判定的案例。此機制的運作方式是依照新增資料行的順序。每當有新值進來時,系統會檢查它是否符合第一個資料行的彙總準則。如果值相同,則會檢查第二個資料行的準則。此行為會延續到後續的資料行。 例如,我們可以有一個包含三個資料行的統計資料:
  • 第一個資料行使用 Min 彙總。
  • 第二個資料行使用 Max 彙總。
  • 第三個資料行使用 Last 彙總。
如果有新值進來,它需要低於第一個資料行。然後它需要大於第二個資料行。最後,第三個資料行設定為 Last 彙總,因此如果它通過前兩項驗證,就一律會被更新。

結論

在本教學課程中,我們學到了如何執行下列作業:
  • 建立多資料行統計資料
  • 查詢統計資料
  • 了解平手判定的運作方式。

另請參閱

最後修改於 2026年10月8日