> ## 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 用户统计信息。

本主题描述了用户统计信息是如何由开发人员定义的数据点，由 XBOX 服务计算并按每个用户存储为名称-值对。

用户统计信息的一些示例包括以下内容：

* 在困难难度下用霰弹枪击杀的僵尸总数
* 完成第 3 关的最快时间
* 在多人比赛中获得的最高分数
* 最近驾驶的汽车名称

基于事件的统计信息以前称为 *Stats 2013*。

使用基于事件的统计信息时，统计信息将根据游戏记录的事件和开发人员通过合作伙伴中心服务配置工具定义的统计规则在 XBOX 服务中进行计算。

游戏将事件发送到 XBOX 统计信息处理器服务。处理器使用你在合作伙伴中心中的 XBOX 服务配置中定义的统计规则来处理这些事件并更新统计信息。然后，游戏可以从 XBOX 统计信息服务检索更新的统计信息。

可以将统计规则配置为生成以下任一项：

* 单个统计信息实例
* 基于统计信息模板的多个统计信息实例

## 定义统计信息实例

*统计信息实例* 使用单个名称-值对。
这是使用统计信息的基本方式。

配置统计规则以控制 XBOX 服务应如何根据游戏发送的事件生成统计信息实例（图 1）。
有关详细信息，请参阅[基于事件的统计规则概述](/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-user-stat-rules)。

**图 1. 事件、统计规则和用户统计信息。**

<img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/events-and-user-stats2.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=a68b9ef9547237627994e0e3b22aeae7" alt="显示事件、统计规则和用户统计信息的图示。第一个块显示事件和敌人被击败。第二个块显示统计规则和击杀数。第三个块显示统计信息实例和击杀数。" width="600" height="159" data-path="images/gdk/services/events-and-user-stats2.png" />

统计信息实例名称指的是特定的名称-值对。例如：

* EnemiesDefeated
* HighScoreMP
* CurrentCarName

## 定义统计信息模板

一种更高级的统计信息类型是 *统计信息模板*。
统计信息模板在其名称中包含一定数量的事件字段以生成多个统计信息实例。

*统计信息模板* 使用带有事件字段名称的统计规则生成多个统计信息实例（图 2）。

**图 2. 事件和统计信息模板。**

<img src="https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/stat-templates.png?fit=max&auto=format&n=ktEik-YaZoen6Rhy&q=85&s=d13831ceb3f1d66aa639e91abcd91460" alt="显示事件和统计信息模板的图示。第一个块显示事件和 EnemyDefeated，包含 WeaponID、DifficultyLevel。第二个块显示统计规则 Kills.WeaponID。第三个块显示统计信息实例 Kills.WeaponID.Pistol 和 KillsWeaponID.Rifle。" width="600" height="246" data-path="images/gdk/services/stat-templates.png" />

统计信息模板由包含一个或多个事件字段作为其名称的一部分的统计规则生成，以便它可以生成多个统计信息实例。
例如：

* 统计信息模板：BestTime.LevelId
* 统计信息实例：BestTime.LevelId.3
* 统计信息实例：BestTime.LevelId.55
* 统计信息模板：EnemiesDefeated.EnemyTypeId.WeaponId.DifficultyLevelId
* 统计信息实例：EnemiesDefeated.EnemyTypeId.6.WeaponId.17.DifficultyLevelId.4
* 统计信息实例：EnemiesDefeated.EnemyTypeId.9.WeaponId.33.DifficultyLevelId.1

每个事件都有事件名称和一组字段。
当 XBOX 服务收到特定名称的事件时，统计规则将被触发。
统计规则生成统计信息实例（图 3）。

**图 3. 事件、统计规则和用户统计信息以及处理位置。**

<img src="https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/stats2013diagram.jpg?fit=max&auto=format&n=ktEik-YaZoen6Rhy&q=85&s=f08cb70c4b5ee76234ff75414b4008bd" alt="显示事件、统计规则和用户统计信息以及处理位置的图示。" width="600" height="562" data-path="images/gdk/services/stats2013diagram.jpg" />

## 另请参阅

[基于事件的与游戏管理的统计信息](/services/xbox-services/player-data/stats-leaderboards/live-stats-eb-vs-tm#update-frequency)


## Related topics

- [基于事件的统计信息与标题管理的统计信息](/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/live-statslb-eb-nav.md)
- [基于事件的统计信息规则概述](/zh-CN/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-user-stat-rules.md)
- [基于事件的统计信息和排行榜门户配置](/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/how-to/live-getting-eb-stat.md)