> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 事件型統計資料規則概觀

> 事件型 XBOX Live 使用者統計資料規則的運作方式，包括產生者事件、命名、運算子、參數，以及玩家統計資料的統計資料範本。

本主題說明使用者統計資料規則的運作方式。這些規則用於事件型統計資料，而不是遊戲管理型統計資料。

每個統計資料規則都有四個部分。

* 產生者事件
* 名稱
* 運算子
* 參數

## 事件

每個統計資料規則都會由遊戲記錄的特定事件名稱觸發。請注意，單一事件可以觸發多個統計資料規則。

## 命名需求

* 規則名稱有一個「根」名稱，後面可選擇性地接上一或多個「欄位」。

* *根*是英數字元字串，最多可有 32 個字元。

* 統計資料執行個體名稱的總長度不得超過 128 個字元。

* 名稱必須以字母字元開頭，且只能包含字母、數字與連字號 (-) 字元。不允許使用空格、逗號、句點、底線或任何其他特殊字元。範例名稱包括 "EnemiesDefeated"、"BestScoreUnder2Minutes" 與 "Total-Collectibles-Jewels"。

* 欄位之間以點 (.) 字元分隔。

* 欄位名稱必須與產生者事件中的欄位名稱完全相符。

<Info>當統計資料規則名稱包含一或多個欄位時，此規則就會成為統計資料範本。在執行階段，產生者事件中欄位的實際值會插入至統計資料執行個體名稱中。</Info>

* 有效範本名稱的範例包括 "EnemiesDefeated.WeaponID"、"BestScoreUnder2Minutes.TrackId.DifficultyID" 與 "Total-Collectibles-Jewels.Found"。

* 有效執行個體名稱的範例包括 "EnemiesDefeated.WeaponID.17"、"BestScoreUnder2Minutes.TrackId.40.DifficultyID.Insane" 與 "Total-Collectibles-Jewels.Found.1"。

## 資料類型建議

* 對於屬於統計資料範本名稱一部分的事件欄位，建議您使用整數資料類型。

* 如果事件欄位的資料類型為 Boolean，則 `true` 插入的值為 "1"，`false` 插入的值為 "0"。

* 如果事件欄位的資料類型為 Unicode 字串，您必須確保該欄位的可能值只包含有效字元 (如先前所述)。

## 運算子

統計資料執行個體的值會在處理產生者事件時於執行階段計算。統計資料規則會以指定的*參數*執行*運算*。支援的運算選項如下。

* `SUM`
* `MAX`
* `MIN`
* `REPLACE`

## 參數

參數可以是常數值，或產生事件中的欄位名稱，如下表所示。

| 運算子 | 參數 |
| - | - |
| `SUM` | 常數或欄位 |
| `MIN` | 欄位 |
| `MAX` | 欄位 |
| `REPLACE` | 常數或欄位 |

產生之統計資料執行個體的資料類型由參數的資料類型決定。

所有運算子都支援 Integer、Float 與 Boolean 資料類型。

只有 `REPLACE` 運算子支援 Unicode 字串資料類型。

統計資料與參數的資料類型如下表所示。

\| 統計資料資料類型 | 參數資料類型 | 備註 |
\| --- | --- |
\| Integer | Int32, Int64, UInt32, UInt64, Boolean | 支援的最大整數值為 56 位元。Boolean 會從 `TRUE` 轉換為 1，從 `FALSE` 轉換為 0。 |
\| Float | Float, Double | 64 位元浮點數。 |
\| String | UnicodeString, GUID | 字串長度上限為 50 個字元。 |


## Related topics

- [事件型統計資料概觀](/zh-TW/services/xbox-services/player-data/stats-leaderboards/event-based/live-stats-eb-overview.md)
- [事件型統計資料與排行榜入口網站設定](/zh-TW/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-statslb-eb-config-nav.md)
- [事件型統計資料的入口網站設定](/zh-TW/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-stats-eb-portal.md)
- [事件型統計資料初探](/zh-TW/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-stats-first-glance.md)
- [事件型統計資料與排行榜](/zh-TW/services/xbox-services/player-data/stats-leaderboards/event-based/live-statslb-eb-nav.md)