使用奖品表 - XBOX Game Development Documentation

本教程将引导你了解如何创建奖品表，该表在可重置排行榜中对一系列排名内的一组玩家触发一组操作。具体来说，这是在排行榜重置时触发电子邮件、发送推送通知、授予库存物品和虚拟货币，或执行 CloudScript 函数的一种方式。在此示例中，我们向你展示如何创建奖品表锦标赛结束奖品，该奖品在执行重置后，根据 5 名玩家在排行榜上的排名向他们授予虚拟货币。

要求

这是一个高级教程。请确保满足下面显示的所有要求，否则你将无法完成本教程。

需要了解如何创建玩家的基本知识，因为在排行榜可以对这些玩家执行任何操作之前，需要有玩家在排行榜中。
如果你不熟悉 Game Manager，也值得阅读 Game Manager 快速入门，因为它是创建奖品表的地方。
为了使用奖品表，你必须对可重置排行榜的工作方式有一般的了解。请阅读我们教程中关于排行榜的内容：使用可重置的统计信息和排行榜。
此外，必须设置虚拟货币。请阅读我们关于货币的教程，并使用以下参数设置两种货币：
- Currency code：GO
- Display name：Gold
- Initial deposit：200
- Currency code：SI
- Display name：Silver
- Initial deposit：1000

步骤 1 - 创建排行榜

在 Game Manager 中：

转到左侧菜单中的 Leaderboards。
选择 New Leaderboard。
在 Statistic name 字段中添加名为 tournamentScore_manual 的 Leaderboard。
使用提供的下拉菜单，将 Reset frequency 字段设置为 Manually。
转到 Aggregation method 字段，从提供的下拉菜单中选择 Maximum (always use the highest value)。

Game Manager - Leaderboards - New Leaderboard

步骤 2 - 为排行榜创建奖品表

现在已经创建了排行榜，可以将奖品表与之关联。转到：

左侧菜单中的 Leaderboards。
选择 Prize Tables 选项卡。
选择 NEW PRIZE TABLE 按钮以进入 New Prize Table 视图。

Game Manager - Leaderboards - Prize Tables

在 New Prize Table 视图中：

转到 INFO 区域，然后输入 New Prize Table 的 Name，命名为 End Tournament Prizes。
从 Leaderboard 下拉菜单中选择 tournamentScore_manual。

为了让此奖品表执行某些操作，需要设置排名。为此：

在 TABLE CONTENTS 部分下选择 + ADD RANK。
将出现 Rank 表单。

Game Manager - Leaderboards - New Prize Table

在 Rank 表单中：

确认 Rank from 字段的值为 1。
确认 To (inclusive) 字段的值为 2。
在 Type 下拉菜单中，选择 Grant virtual currency。
在 virtual currency code 下拉菜单中，选择 GO (Gold)，数量为 10。

Game Manager - Leaderboards - Prize Table - Add Rank

现在，我们将添加第二个排名范围：

在 TABLE CONTENTS 部分下选择 +ADD RANK（底部还有一个第二个，也可以工作）。
在出现的 Rank 表单中，确保 Rank from 字段的值为 3，To (inclusive) 字段的值为 5。
在 Virtual currency code 下拉菜单中，选择 SI（Silver），数量为 10。

Game Manager - Leaderboards - Prize Table - Add Second Rank

步骤 3 - 用玩家填充排行榜

现在已经创建了排行榜以及与之关联的奖品表。下一步是用玩家填充排行榜。要创建玩家，我们将使用 LoginWithCustomID。然后，我们将使用玩家通过 UpdatePlayerStatistics 填充排行榜。在我们可以使用 UpdatePlayerStatistics 之前，必须在 API Features 中启用它。

在左侧菜单中选择 Settings。
选择 API Features 选项卡。
选中 Allow client to post player statistics 的复选框。
然后选择屏幕底部的 SAVE API FEATURES 按钮。

Game Manager - Settings - API Features - Allow client to post player statistics

C# 代码示例

以下 C# 代码示例创建 5 名玩家，并使用 LoginWithCustomID 使他们登录。然后使用 UpdatePlayerStatistics 用 5 名玩家填充你之前创建的排行榜 (tournamentScore_manual)，值分别为：105、104、103、102 和 101。

// Note: This is a recursive function. Invoke it initially with no parameter
public void CreatePlayerAndPopulateLeaderboard(int playerIndex = 5) {
    if (playerIndex <= 0) return;
    const string leaderboardName = "tournamentScore_manual";
    PlayFabClientAPI.LoginWithCustomID(new LoginWithCustomIDRequest {
        CustomId = playerIndex.ToString(),
        CreateAccount = true
    }, result => OnLoggedIn(result,playerIndex,leaderboardName), FailureCallback);
}

private void OnLoggedIn(LoginResult loginResult, int playerIndex, string leaderboardName) {
    Debug.Log("Player has successfully logged in with " + loginResult.PlayFabId);
    PlayFabClientAPI.UpdatePlayerStatistics(new UpdatePlayerStatisticsRequest {
        Statistics = new List<StatisticUpdate> {
            new StatisticUpdate {
                StatisticName = leaderboardName,
                Value = playerIndex + 100
            }
        }
    }, result=> OnStatisticsUpdated(result,playerIndex), FailureCallback);
}

private void OnStatisticsUpdated(UpdatePlayerStatisticsResult updateResult, int playerIndex) {
    Debug.Log("Successfully updated player statistic");
    // Recursively invoke for next player
    CreatePlayerAndPopulateLeaderboard(playerIndex - 1);
}

private void FailureCallback(PlayFabError error){
    Debug.LogWarning("Something went wrong with your API call. Here's some debug information:");
    Debug.LogError(error.GenerateErrorReport());
}

检查 C# 代码示例的结果

要检查排行榜中是否填充了 5 名玩家，其值是否正确：

从左侧菜单中选择 Leaderboards。
在 Leaderboards 选项卡上，返回 Leaderboard 列表视图。
选择 tournamentScore_manual，应该有 5 名 Players，其值分别为 105、104、103、102 和 101。

Game Manager - Leaderboards - View Leaderboard - Check values

步骤 4 - 检查玩家的初始货币

在检查任何内容之前：

返回步骤 2 中左侧菜单中的 Players。
转到 Players 选项卡，找到在步骤 3 中放入 tournamentScore_manual Leaderboard 的玩家。
选择 Player ID，然后选择该玩家的 Virtual Currency 选项卡。
记录该玩家的 GO（Gold）和 SI（Silver）Currencies 的值。

在检查任何内容之前，返回步骤 2 中的测试 Players。

转到 Players，找到在步骤 3 中放入 tournamentScore_manual Leaderboard 的玩家。
选择 Player ID 和该玩家的 Virtual Currency 选项卡。
记录该玩家的 GO（Gold）和 SI（Silver）货币的值。
现在对在步骤 3 中放入 tournamentScore_manual Leaderboard 的 5 名玩家中的其余 4 名执行此操作。
确保记录他们的 GO（Gold）和 SI（Silver）货币的值（这些对于确认重置后奖品表是否有效非常重要）。

Game Manager - Players - Virtual Currency - Check values

步骤 5 - 重置排行榜以授予奖励

现在转到 Leaderboards。

返回 Leaderboards 列表视图。
选择 tournamentScore_manual。
记下 Leaderboard 上 Players 的位置（这些是从零索引的，因此位置 0 是第一名）。
选择 RESET NOW 按钮。
选择 RESET 按钮以确认重置 Leaderboard
这将清空 Players 列表。

Game Manager - Leaderboards - Check player positions

选择屏幕顶部的 RESET NOW 按钮。
当提示 Reset this Leaderboard now? 时，选择 RESET 按钮以确认重置。
这将清空 Players 列表。

步骤 6 - 测试奖品表是否有效

要查看奖品表是否有效，可以检查排行榜中的玩家，看看他们是否被授予了正确数量的货币。这可以在玩家的 PlayStream 调试器中快速查看。要在 PlayStream 调试器中查看此内容：

从左侧菜单中选择 Players。
PlayStream 选项卡将显示 Player 在 Leaderboard 上的排名事件，后跟 Virtual Currency 更新。

Game Manager - Players - PlayStream Debugger - Check Leaderboard Events

现在，让我们手动检查玩家是否收到了正确的货币：

从左侧菜单中选择 Players。
在 Players 选项卡上，转到屏幕的 Virtual Currency 区域。
确认货币是否已正确授予。
这应该比之前记录的数量多一个。
注意，处于排行榜位置 0 或 1 的 Players 获得了 10 gold，没有授予 silver。
同时，处于位置 2、3 和 4 的 Players 被授予了 10 silver，没有 gold。
这与为奖品表设置的操作相匹配。

Game Manager - Player1 - Check Virtual Currency Amount

Game Manager - Player2 - Check Virtual Currency Amount

检查是否正确授予了 Virtual Currency 的另一种方法是：

进入 Players。
查看 Event History。
这将显示一个 player_virtual_currency_balance_changed 事件，其中包含所授予 Virtual Currency 更改金额的具体详细信息。

​要求

​步骤 1 - 创建排行榜

​步骤 2 - 为排行榜创建奖品表

​步骤 3 - 用玩家填充排行榜

​C# 代码示例

​检查 C# 代码示例的结果

​步骤 4 - 检查玩家的初始货币

​步骤 5 - 重置排行榜以授予奖励

​步骤 6 - 测试奖品表是否有效

要求

步骤 1 - 创建排行榜

步骤 2 - 为排行榜创建奖品表

步骤 3 - 用玩家填充排行榜

C# 代码示例

检查 C# 代码示例的结果

步骤 4 - 检查玩家的初始货币

步骤 5 - 重置排行榜以授予奖励

步骤 6 - 测试奖品表是否有效