> ## 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"。

## 数据类型建议

* 我们建议将整数数据类型用于作为统计信息模板名称一部分的事件字段。

* 如果事件字段数据类型为布尔值，则对于 `true`，插入的值为 "1"；对于 `false`，插入的值为 "0"。

* 如果事件字段数据类型为 Unicode 字符串，则必须确保该字段的潜在值仅包含有效字符（如前所述）。

## 运算符

统计信息实例的值在处理生产者事件时于运行时计算。统计信息规则使用指定的*参数*执行*操作*。支持的操作选项如下。

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

## 参数

参数可以是常量值，也可以是来自生产事件的字段名称，如下表所示。

| 运算符       | 参数    |
| --------- | ----- |
| `SUM`     | 常量或字段 |
| `MIN`     | 字段    |
| `MAX`     | 字段    |
| `REPLACE` | 常量或字段 |

生成的统计信息实例的数据类型由参数的数据类型决定。

所有运算符都支持整数、浮点数和布尔数据类型。

只有 `REPLACE` 运算符支持 Unicode 字符串数据类型。

统计信息和参数数据类型如下表所示。

\| 统计信息数据类型 | 参数数据类型 | 备注 |
\| --- | --- |
\| 整数 | Int32、Int64、UInt32、UInt64、Boolean | 支持的最大整数值为 56 位。布尔值从 `TRUE` 转换为 1，`FALSE` 转换为 0。 |
\| 浮点数 | Float、Double | 64 位浮点数。 |
\| 字符串 | UnicodeString、GUID | 最大字符串长度为 50 个字符。 |


## Related topics

- [基于事件的统计信息和排行榜门户配置](/zh-CN/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-statslb-eb-config-nav.md)
- [基于事件的统计信息概述](/zh-CN/services/xbox-services/player-data/stats-leaderboards/event-based/live-stats-eb-overview.md)
- [基于事件的统计信息和排行榜](/zh-CN/services/xbox-services/player-data/stats-leaderboards/event-based/live-statslb-eb-nav.md)
- [基于事件的统计信息与标题管理的统计信息](/zh-CN/services/xbox-services/player-data/stats-leaderboards/live-stats-eb-vs-tm.md)
- [编写事件以驱动基于事件的统计信息](/zh-CN/services/xbox-services/player-data/stats-leaderboards/event-based/how-to/live-sending-eb-stat.md)