- 產生者事件
- 名稱
- 運算子
- 參數
事件
每個統計資料規則都會由遊戲記錄的特定事件名稱觸發。請注意，單一事件可以觸發多個統計資料規則。命名需求
- 規則名稱有一個「根」名稱，後面可選擇性地接上一或多個「欄位」。
- 根是英數字元字串，最多可有 32 個字元。
- 統計資料執行個體名稱的總長度不得超過 128 個字元。
- 名稱必須以字母字元開頭，且只能包含字母、數字與連字號 (-) 字元。不允許使用空格、逗號、句點、底線或任何其他特殊字元。範例名稱包括 “EnemiesDefeated”、“BestScoreUnder2Minutes” 與 “Total-Collectibles-Jewels”。
- 欄位之間以點 (.) 字元分隔。
- 欄位名稱必須與產生者事件中的欄位名稱完全相符。
當統計資料規則名稱包含一或多個欄位時，此規則就會成為統計資料範本。在執行階段，產生者事件中欄位的實際值會插入至統計資料執行個體名稱中。
- 有效範本名稱的範例包括 “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 字串，您必須確保該欄位的可能值只包含有效字元 (如先前所述)。
運算子
統計資料執行個體的值會在處理產生者事件時於執行階段計算。統計資料規則會以指定的參數執行運算。支援的運算選項如下。SUMMAXMINREPLACE
參數
參數可以是常數值，或產生事件中的欄位名稱，如下表所示。
產生之統計資料執行個體的資料類型由參數的資料類型決定。
所有運算子都支援 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 個字元。 |