> ## 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 统计信息（Stats 2017）如何让游戏发送键值统计更新，为排行榜、精选统计信息和玩家对比提供支持。

本主题介绍游戏托管统计信息如何跟踪玩家在游戏中的进度以供显示。

游戏托管统计信息以前称为 *Stats 2017*。

使用游戏托管统计信息时，标题会跟踪统计值，并将这些值发送到服务。
你可以为单个玩家配置反映其在游戏中的进度和实力的统计信息。
这些统计信息是一种社交工具，可鼓励玩家与其好友以及更广泛的标题社区之间开展竞争。统计信息还能展示你的标题所提供的部分功能和挑战。

例如，如果你有一款赛车游戏，其精选统计信息包括最长漂移和最长滞空时间，那么这些统计信息有助于传达玩家可期待的赛车游戏类型。

看到自己与好友和整个社区之间的对比，会给玩家更多购买和游玩你的标题的动力。

玩家可在标题的 GameHub 上查看精选统计信息。
精选统计信息还可能会定期出现在用户可以添加到主视图的固定内容块中。

游戏托管统计信息以键值对的形式接受来自你的标题的统计值，并存储这些统计值以供稍后显示。
游戏托管统计信息通过保存单个玩家的统计信息来支持 XBOX 服务排行榜场景，以便进行对比和在排行榜上排名。

> [!NOTE]
>
> 对于游戏托管统计信息，玩家的全局排行榜条目并非其当前存储统计信息的直接投影。排行榜服务**仅保留每位玩家的最高记录值**。将较低的值写入某项统计信息并不会降低该玩家在全局排行榜上的位置；排行榜仍然反映之前记录的最高值。存储的统计信息本身可通过 `XblUserStatisticsGet*` 或 `XblTitleManagedStatsGetForUserAsync` 查询，反映的是最近一次写入的值，这就是为什么它可能与排行榜出现差异。
>
> 如果你的标题需要排行榜位置能够下降，则游戏托管统计信息不适用。示例包括可升可降的评分，或在失败时重置的分数。此时应考虑使用 [基于事件的统计信息](https://devdocs.xbox.com/zh-CN/services/xbox-services/player-data/stats-leaderboards/event-based/live-stats-eb-overview.md)（配合 `Replace` 统计规则），或外部排行榜服务，例如 [PlayFab Leaderboards v2](https://devdocs.xbox.com/zh-CN/services/playfab/community/leaderboards/index.md)。有关更多讨论和示例实现，请参阅 [`XblLeaderboardQuery`](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/leaderboard_c/structs/xblleaderboardquery) 参考文档以及 `LeaderboardsTitleManaged` Microsoft Game Development Kit (GDK) 示例的 [实现说明](https://github.com/microsoft/Xbox-GDK-Samples/blob/main/Samples/Live/LeaderboardsTitleManaged/readme_en-us.md)。

游戏托管统计信息在接收发送给它的统计值时不进行验证。由你的标题负责处理逻辑，以确定统计信息的正确值。
由于你的标题完全控制统计值，因此更容易端到端调试统计值的流转。

## 已配置的统计信息和精选排行榜

统计信息在 [Partner Center 仪表板](https://partner.microsoft.com/dashboard/windows/overview) 上进行配置。
要配置统计信息，你必须已经配置了一个标题。

你在 Partner Center 配置的统计信息将显示在标题的 GameHub 上，如下图所示。
精选统计信息以黄色高亮显示。

![Official Club Page Social Leaderboard](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/gamehub_featuredstats-1000w.png?fit=max\&auto=format\&n=gzrdvT5kpqAXKEQt\&q=85\&s=a51a66b4a01cd9cf7b4a22c24a1ea89c)

在 XBOX 主机上，用户可以将游戏直接固定到其主屏幕，以便快速找到相关信息、社区驱动的内容以及开发者帖子。
你所配置的统计信息也可以作为固定的主界面内容的一部分显示。

统计信息将显示该玩家以及排名略高的好友，鼓励他们在排行榜上不断攀升。
固定内容中的排行榜将如下图所示进行高亮显示。

![Halo 5 Pinned Leaderboard](https://mintcdn.com/microsoft-4404708b/MccwT2UvEEolGlU5/images/gdk/services/Halo_5_Pinned_Leaderboard-1000w.webp?fit=max\&auto=format\&n=MccwT2UvEEolGlU5\&q=85\&s=a44b7a65c71afb9e54cd2a6e8d94e32b)

精选统计信息基于已配置的统计信息，将游戏内进度与同样在游玩该标题的其他好友进行对比。
这鼓励玩家在好友之间争夺高分或仅因共享体验而建立联系时，为你的标题投入更多游玩时间。

精选统计排行榜是每月排行榜，每月首日重置。

## 另请参阅

[在 Partner Center 配置游戏托管的精选统计信息和排行榜](https://devdocs.xbox.com/zh-CN/services/xbox-services/player-data/stats-leaderboards/title-managed/config/live-tm-leaderboards-portal.md)
[基于事件的统计信息与游戏托管统计信息对比](https://devdocs.xbox.com/zh-CN/services/xbox-services/player-data/stats-leaderboards/live-stats-eb-vs-tm.md#update-frequency)。
[写入游戏托管统计信息](https://devdocs.xbox.com/zh-CN/services/xbox-services/player-data/stats-leaderboards/title-managed/how-to/live-writing-tm-stats.md)


## Related topics

- [基于事件的统计信息与游戏管理的统计信息](https://devdocs.xbox.com/zh-CN/services/xbox-services/player-data/stats-leaderboards/live-stats-eb-vs-tm.md)
- [写入游戏管理的统计信息](https://devdocs.xbox.com/zh-CN/services/xbox-services/player-data/stats-leaderboards/title-managed/how-to/live-writing-tm-stats.md)
- [基于事件的统计信息概述](https://devdocs.xbox.com/zh-CN/services/xbox-services/player-data/stats-leaderboards/event-based/live-stats-eb-overview.md)
- [游戏管理的统计信息与排行榜（目录）](https://devdocs.xbox.com/zh-CN/services/xbox-services/player-data/stats-leaderboards/title-managed/live-statslb-tm-nav.md)
- [游戏管理的统计信息和排行榜示例代码（目录）](https://devdocs.xbox.com/zh-CN/services/xbox-services/player-data/stats-leaderboards/title-managed/how-to/live-statslb-tm-howto-nav.md)
