Skip to main content
本快速入门向你展示如何创建按计划运行的任务。有许多游戏操作例程可以使用计划任务自动完成,例如:
  • 根据一天中的时间修改商店中的价格。
  • 更新 title data 以反映当前事件的更改。
  • 每天向游戏经济中注入虚拟货币等。
在本快速入门中使用的示例中,我们将向你展示如何在 UTC 12:00 且仅在周末修改 title data 中一个名为 rareDropRate 的游戏变量。

步骤 1 - 准备 CloudScript

Game Manager 中:
  • 在左侧菜单中选择 Automation
  • CloudScript Revisions 选项卡上,添加一个名为 adjustRareDropRate 的新 CloudScript 函数,其中包含对 SetTitleData API 的简单调用,如下面的代码片段和图像所示。
眼尖的人别担心 - 那里故意有一个错误。确保你部署新版本,以便它在你的游戏中处于活动状态。
你可以在我们的 CloudScript 快速入门ExecuteCloudScript 方法的文档中了解有关使用 CloudScript 的更多信息。

步骤 2 - 创建计划任务

现在从左侧菜单中选择 Servers
  • 前往 Scheduled Tasks 选项卡。
  • 在屏幕右上角选择 New Scheduled Task
  • 这将弹出 Create Task 视图。
  • Type of task 字段中,选择 Run a CloudScript function
  • 在其下方,你将能够从 CloudScript 的当前部署版本中选择一个函数,并指定要传入的参数。
  • 选择你在上一步中编写的 adjustRareDropRate Handler
要设置此任务的计划:
  • SCHEDULE 标题下选择 On a schedule (UTC)
  • 一个简单的计划构建器让你选择 Task 应何时运行(每小时、每天、每周等)。
  • 对于此示例,我们想要一个高级计划,我们可以指定一周中运行任务的天数。
  • 因此选择 CRON EXPRESSION
高度可自定义的 Cron 表达式允许你构建非常复杂的计划,但需要注意的是,我们目前 允许其发生时间在 5 分钟标记上的计划。 例如,你可以指定一个任务在小时的第 5、10、25 或 50 分钟运行,但你 不能 指定一个任务在小时的第 3、11 或 46 分钟运行。 如果你想了解有关 Cron 表达式的更多信息,crontab.guru 提供了丰富的信息和一个交互式表达式构建器。 在这种情况下,我们希望任务在 UTC 12:00 的星期六和星期日运行,即 00 12 * * 0,6(十二点整过零分钟,每个星期日和星期六)。 最后,在继续下一步之前,请确保保存新任务。

步骤 3 - 测试任务

Tasks 视图 (Servers -> Tasks) 上,我们可以看到新创建任务的下一次运行是在接下来的 星期六 - 正如预期。 因此,如果当前是 星期二,那么下一次计划的运行时间将是 4 天后。要 现在 测试任务,请选择 Adjust rare drop rate 任务并选择 RUN TASKS

步骤 4 - 检查测试运行的结果

不幸的是,任务运行失败了。选择任务实例以查看出了什么问题。 Task Instance Details 视图提供有关任务失败原因的诊断信息。 在这种情况下,它指出对 serverAPI.SetTitleData 的调用不正确。它实际上应该是 server.SetTitleData(有关解释,请参阅 编写自定义 CloudScript 教程的 中级:调用服务器 API 部分)。 Task Instance Details 视图上还有其他重要信息 - 例如开始和结束时间、调用的函数、传入的任何参数、完整的 CloudScript 执行结果等等。

步骤 5 - 再次测试(成功)

继续修复我们在步骤 4 中发现的错误。正确的代码片段如下所示。
现在,重复步骤 3,你的最终测试运行成功。 要确认成功:
  • 在左侧菜单中选择 Content
  • 前往 Title Data 选项卡。
  • 验证 Title Data 条目实际上已设置。
最后修改于 2026年8月13日