使用玩家统计信息 - XBOX Game Development Documentation

本教程介绍如何创建和使用玩家统计信息。玩家统计信息以键值对（KVP）形式存储，其中键是字符串，值是 32 位整数（为了与不支持 64 位的语言兼容）。排行榜也使用玩家统计信息，但本指南仅涵盖玩家统计信息。如果你希望阅读玩家统计信息和排行榜如何一起工作，请阅读我们的教程使用可重置的统计信息和排行榜。

在某些文档和 API 调用中，你可能会看到术语 UserStatistics。就本次讨论而言，术语 user 和 player 是相同并可互换的。在 Game Manager 页面中，Players 选项卡提供对标题的 Users/Players 及其统计信息的访问。玩家统计信息具体是指绑定到玩家的信息，而不是有关玩家的分析信息。

客户端 API

客户端有权限读取玩家统计信息，但为了防止作弊，客户端默认无法更新统计信息。要启用此功能：

登录到 PlayFab
选择你的 Title。
从左侧菜单中选择 Settings。
选择 API Features 选项卡。
找到并激活 Allow client to post player statistics。

这样做会禁用你标题的一层安全，允许玩家将任意分数发布到他们所有的统计信息。如果你的游戏具有任何竞技性方面，我们建议你绝不从客户端发布统计信息。

统计信息是公共信息

不存在私有或仅服务器的统计信息。玩家始终可以通过 GetPlayerStatistics 读取他们自己的所有统计信息，并可以通过排行榜 API 调用读取所有其他玩家的统计信息。即使你不在游戏中显示某个统计信息或不使用排行榜，情况也是如此。唯一的例外是你通过我们的 API 访问策略禁用客户端功能。有关如何为标题使用策略设置的更多信息，请参阅该链接，因为这是一个高级主题，本教程不涵盖。

设置统计信息

以下 Unity/C# 代码为玩家创建（如果已存在则更新）strength statistic 值。

PlayFabClientAPI.UpdatePlayerStatistics( new UpdatePlayerStatisticsRequest {
    // request.Statistics is a list, so multiple StatisticUpdate objects can be defined if required.
    Statistics = new List<StatisticUpdate> {
        new StatisticUpdate { StatisticName = "strength", Value = 18 },
    }
},
result => { Debug.Log("User statistics updated"); },
error => { Debug.LogError(error.GenerateErrorReport()); });

获取统计信息

以下 Unity/C# 代码检索玩家所有当前的统计信息值。

void GetStatistics()
{
    PlayFabClientAPI.GetPlayerStatistics(
        new GetPlayerStatisticsRequest(),
        OnGetStatistics,
        error => Debug.LogError(error.GenerateErrorReport())
    );
}

void OnGetStatistics(GetPlayerStatisticsResult result)
{
    Debug.Log("Received the following Statistics:");
    foreach (var eachStat in result.Statistics)
        Debug.Log("Statistic (" + eachStat.StatisticName + "): " + eachStat.Value);
}

聚合方法

PlayFab 支持一些统计信息聚合的便利选项。四种选项包括：

Last
Min
Max
Sum

你可以通过 CreatePlayerStatisticDefinition API 调用创建统计信息定义，尽管这不是必需的。对标题的任何更新玩家统计信息的调用将自动创建默认统计信息定义，使用 Last 聚合方法。要更改统计信息聚合方法，你可以使用 Game Manager 或 UpdatePlayerStatisticDefinition API 调用。在 Game Manager 中编辑统计信息定义：

登录到 PlayFab
选择你的 Title。
从左侧菜单中选择 Leaderboards（Statistics 和 Leaderboards 密切相关）。
选择要修改的现有统计信息，或者 -
选择 New Leaderboard 按钮。
- 对于现有的统计信息，你将有另一个页面，其中包含 Edit Leaderboard 按钮。
此时你应该看到下面所示的页面。

如何使用统计信息聚合的一些示例：

Max 和 Min 可用于保存最佳/最差分数，如爆头数或准确性：
- 简言之，它们应用规则：如果这高于（或低于）现有分数，则更新分数。
- 在会话结束时发布统计信息，Min/Max 聚合会决定是否更新。
- 这些对于可重置排行榜以及授予成就的 PlayStream 规则可能非常有用。
Sum 可用于保存经验值：
- 你发布此次战斗获得的经验，将其添加到玩家的现有统计信息值中。
Last 允许你自己管理统计信息：
- 每次你发布统计信息时，都会使用最新的值。

排行榜

排行榜是为 PlayFab 中保存的所有统计信息生成的。访问特定统计信息的排行榜是可选的。重置频率和聚合方法在你的游戏中排行榜的动态程度方面起着重要作用。Tournaments 功能着重于具有自动重置频率的排行榜，并在教程使用可重置的统计信息和排行榜中进行了描述。我们鼓励你以与游戏相关的每种方式使用统计信息。你可以使用可重置的统计信息运行每日锦标赛，同时并行使用长期统计信息，如经验值。

​客户端 API

​统计信息是公共信息

​设置统计信息

​获取统计信息

​聚合方法

​排行榜

客户端 API

统计信息是公共信息

设置统计信息

获取统计信息

聚合方法

排行榜