针对整个玩家分段的批量操作 - XBOX Game Development Documentation

本教程将引导你完成创建任务所需的步骤，以对分段中的每个玩家执行一个或多个操作。任务是任何游戏实时运营的重要组成部分。它们为你提供了一套强大的工具，用于与你的玩家互动。示例可能包括：

向过去 2 周内登录过的所有玩家赠送特殊的新年礼物。
奖励过去一周内消费的玩家（根据消费级别），花的钱越多，礼物越有价值。
修复受最近游戏错误影响的所有玩家的损坏玩家状态。

在本教程中，基于我们的 Unicorn Battle Sample App，我们将向所有 XP 超过 2,725 的玩家授予一份特殊礼物。

先决条件

你需要安装 Unicorn Battle Sample App 才能运行本教程。你可以在我们的博客中阅读有关它的更多信息，或直接前往 GitHub 存储库并按照那里的说明操作。你需要玩几场战斗，以便将你的角色升级到至少 2 级，达到该等级需要 2,725 XP 点。

步骤 1 - 创建分段

第一步是创建定义将受此操作影响的玩家组的分段。在这种情况下，我们需要创建 High XP Segment，定义为所有拥有超过 2,725 XP 的玩家：

从左侧菜单中选择 PlayStream。
选择 Segments 选项卡。
然后选择 New Segment 按钮。
将 Segment Name 设为：High XP Players。
将其定义为 Player，其中名为 Total_XP Gained 的 Statistic Value 大于 2725。

注意： 当前的计划任务系统每个分段每秒可以处理 10-15 个任务。设计分段时，请提前规划它们的大小以及任务执行的运行时间。任务可以运行多长时间没有限制，但如果任务需要在特定时间范围内执行，则需要正确调整分段的大小。

步骤 2 - 为此分段创建任务

选择 Segments 选项卡。
然后选择 RUN TASK …

这将带你进入 Servers->Tasks 选项卡中的 Create Task 视图，并根据你选择的分段预填充各个字段。

步骤 3 - 向任务添加操作

接下来，你可以完成任务的设置。

将名称更改为 Reward High XP Players
添加此描述：Give a gift to Players who are level 2 or higher。
选择 ADD ACTION
- 在提供的字段中键入 Grant virtual currency。
- Virtual Currency 代码：GM（Gems 的缩写）。
- 数量：20
现在将计划保留设置为 Manually。
选择 SAVE AND RUN 按钮以运行任务。

步骤 4 - 监视你的任务

Tasks 视图将向你显示正在运行的任务。最初任务状态为 InProgress，但由于分段很小，它将迅速更改为 Succeeded。现在，让我们查看任务执行详细信息。在先前运行的 Tasks 列表中选择已完成的任务。你将看到重要信息，例如：

处理了多少玩家。
任务开始的时间。
完成所用的时间。
启动时的参数。
谁运行了它。
它是否是手动计划的等等。

如果任务仍在进行中，你可以查看 Task Instance Detail 视图以了解进度，并查看预计的剩余时间。若要验证任务是否成功运行：

导航到 Players 选项卡。
选择你的 Player。
然后选择 Event History 选项卡。
列表中最近的事件应为 player_virtual_currency_balance_changed，它应显示你的 Player 的宝石增加了 20。

你可以展开此事件以查看详细信息。

后续步骤

本教程向你介绍了针对分段中每个玩家执行操作所涉及的步骤，但你可以使用任务做更多事情。以下是你可以尝试的其他一些想法…

计划你的任务

你无需手动运行任务 - 你可以计划任务以定期自动运行。例如，你可以创建一个包含过去 24 小时内玩过游戏的所有玩家的分段，然后每天运行一个计划任务，为这些玩家提供 XP 加成。

为每个玩家运行 CloudScript

批量操作最强大的用途是为每个玩家运行任意 CloudScript 函数。此 CloudScript 可以执行 PlayFab 服务器 API 可以执行的任何操作 - 授予物品、货币、检查和更改玩家数据等。例如，假设你有一个每周重置的事件排行榜，你想遍历所有玩家，根据重置前 最后一次 事件的值给予奖励。下面提供的示例使用 Unicorn Battle。

创建一个新的统计信息 Event_QuestsCompleted，每周重置并使用聚合方法 Last。
创建一个新的 PlayStream 操作，每当 Total_QuestsCompleted 更改时，就递增此 Event_QuestsCompleted 统计信息。
编写一个由批量操作任务调用的 CloudScript 函数，该函数将遍历玩家并根据最后一次值给予奖励。

// this function will be called as a bulk action by a scheduled task for players in a segment
handlers.GiveTieredReward = function (args, context) {
    var profile = context.playerProfile;

    var statVersion = 0;        // set to whatever version you need to use

    var getStatRequest = {};
    getStatRequest.PlayFabId = profile.PlayerId;
    getStatRequest.StatisticNameVersions = [{ "StatisticName": "Event_QuestsCompleted", "Version": statVersion }];

    try {
        getStatRequest.PlayerResult = server.GetPlayerStatistics(getStatRequest);
    } catch (e) {
    };

    if (getStatRequest.PlayerResult && getStatRequest.PlayerResult.Statistics.length > 0) {
        getStatRequest.lastScore = getStatRequest.PlayerResult.Statistics[0].Value
    }

    if (getStatRequest.lastScore && getStatRequest.lastScore > 2) {
        // give gift to all players with more than 2 quests completed in last event
        // in a real event we would want to use a lookup table of gifts
        // but here we are just hard-coding it
        var giftRequest = {};
        giftRequest.PlayFabId = profile.PlayerId;
        giftRequest.ItemIds = ["CrystalKey"];
        giftRequest.grantResult = server.GrantItemsToUser(giftRequest);
        return giftRequest;
    } else {
        return getStatRequest;
    }
}

将新的 CloudScript 版本设置为 Live，并创建一个新任务，为所有玩家调用 GiveTieredReward 函数。别忘了保存并运行任务。
你应该会注意到来自此任务的事件出现在 PlayStream 事件调试器中。
你可以选择任何玩家触发的操作执行的 CloudScript 事件（通过选择时间戳），并查看每个玩家的 CloudScript 执行的详细结果。这包括有用的诊断信息，例如 CloudScript 执行时的玩家配置文件快照。

​先决条件

​步骤 1 - 创建分段

​步骤 2 - 为此分段创建任务

​步骤 3 - 向任务添加操作

​步骤 4 - 监视你的任务

​后续步骤

​计划你的任务

​为每个玩家运行 CloudScript

先决条件

步骤 1 - 创建分段

步骤 2 - 为此分段创建任务

步骤 3 - 向任务添加操作

步骤 4 - 监视你的任务

后续步骤

计划你的任务

为每个玩家运行 CloudScript