文档

支持

Cloud Code

Open Unity Dashboard

Cloud Code

Unity Cloud Dashboard

Create and manage Cloud Code scripts using the graphical interface of the Unity Dashboard.
阅读时间5 分钟最后更新于 1 个月前
Unity Cloud Dashboard 提供易于使用的图形界面来全面控制脚本。本节将介绍如何预览、创建、编辑和删除脚本。

预览脚本

您可以从 Unity Cloud Dashboard 访问某个环境的所有 Cloud Code 脚本的列表。访问方式如下：
  1. 在 Unity Cloud Dashboard 中，选择 Products（产品）> Cloud Code。
  2. 选择 Scripts（脚本）。
  3. 从环境列表中选择一个环境。
此时将显示项目所选环境中所有 Cloud Code 脚本的列表。表中包含脚本的名称、类型、上次发布日期和版本。您可以按脚本名称对表进行排序，也可以使用分页来查看全部的脚本。

创建脚本

在 Unity Cloud Dashboard 中创建您的第一个脚本来开始使用 Cloud Code。
  1. 在 Unity Cloud Dashboard 中，选择 Products（产品）> Cloud Code，然后选择 Scripts（脚本）。
  2. 选择 Create your first script（创建您的第一个脚本）。
  3. 填写以下信息：
    • Name（名称）：脚本的描述性名称，用于在 Cloud Code 后端标识和执行脚本。脚本名称在整个项目和环境中必须具有唯一性，只能包含字母、数字、下划线和短划线，且不超过 50 个字符。
    • Type（类型）：脚本的类型。
  4. 选择 Next（下一步）。
  5. 在下一个窗口中，填写所选脚本类型的信息。
下一个屏幕是脚本编辑器，您可以在其中测试和编辑代码及其详细信息。

添加参数

  1. 添加脚本后，选择 + Add parameter（+ 添加参数）。指定脚本从游戏中接受的参数。您可以从脚本代码中访问参数作为指定属性。
  2. 填写以下信息：
    1. Parameter name（参数名称）：触发脚本时可供脚本使用的参数名称。参数名称在脚本中必须具有唯一性，只能包含字母、数字、下划线和短划线，且少于 50 个字符。
    2. Type（类型）：此字段决定了 Cloud Code 对每个请求执行的数据类型验证。
    3. 选择以下选项之一：
      • String（字符串）
      • Numeric（数值）
      • Boolean（布尔值）
      • JSON
      • Any（任意）
    4. Required（必需）：启用此字段来验证已在请求中传递此参数。如果通过 Cloud Code API 执行脚本时没有所有必需的参数，则会导致错误。
    Cloud Code 会在执行脚本时验证这些参数。无效的输入参数会导致 Cloud Code API 调用失败。
  3. 重复上述步骤以添加更多参数，最多 10 个。
  4. 选择 Add（添加）。

脚本编辑器

基于浏览器的脚本编辑器会显示代码中的错误，并提供 JavaScript 自动补全功能。 Run Code（运行代码）选项卡中会显示以下内容：
  • Script Code（脚本代码）部分，其中包含您的脚本代码。
  • Parameters（参数）表，其中列出您创建的所有参数及其值，并具有生成测试玩家 ID 的功能。标记为“必需”的参数会显示在可选参数之前。
  • Response/Logs/Request（响应/日志/请求）选项卡，其中显示脚本运行后的相关信息。
  • Beautify（美化） 按钮，用于自动调整代码格式以优化其易读性。
此编辑器具有以下特性：
  • 通过简单的代码自动补全功能提供简单的 JavaScript 特性。
  • 针对常见问题（如语法错误、缺少分号和无法访问的代码）提供批注。
  • 针对测试执行期间发生的错误（例如类型错误、范围错误和其他抛出的错误）提供批注。
每个新脚本都预先填充了一个示例，以便您快速入门。

脚本详细信息

选择 Details（详细信息）选项卡可查看以下信息：
  • 脚本名称
  • 类型
  • 上次发布日期
  • 上次发布版本
此外，还会列出先前创建的脚本参数。您可以编辑这些参数或在此表中创建新参数。

保存和发布

在 Run Code（运行代码）选项卡中，如果在 Script Code（脚本代码）窗口中更改代码，Cloud Code 会激活 Save script（保存脚本） 按钮。选择 Save script（保存脚本），将这些更改保存到工作副本。此时代码已保存但尚未处于活动状态，因此不存在破坏游戏的危险。 当编辑器中没有待处理的代码更改时，Cloud Code 会激活 Publish version（发布版本） 按钮。选择此按钮并在对话框中确认脚本的发布后，脚本将变为活动状态。当游戏客户端调用 Cloud Code API 时，脚本会在 Cloud Code 后端执行。 脚本的工作副本保持可编辑状态，对玩家的游戏体验没有影响。尽管代码的发布版本是只读的，但您可以再次发布它们。如果已发布的脚本发生意外情况，您想要回滚到以前版本的脚本，则可以使用此工作副本。 发布旧版本时会将副本创建为新版本。发布脚本时会更新游戏实时版本，因此请在发布前确保脚本能按预期工作。 无法重新发布脚本的当前活动版本。这意味着，如果所选的脚本版本（工作副本或先前版本）与游戏实时版本中的脚本相同，则 Cloud Code 会禁用发布功能，直到两者之间存在差异。 每次发布脚本时，版本号都会递增，但 Cloud Code 仅保留最新的 10 个版本。

删除脚本

要从 Unity Cloud Dashboard 中删除脚本，请执行以下操作：
  1. 导航到 Scripts（脚本）列表页面。
  2. 选择垃圾桶图标。此时将显示一个对话框，警告您删除此脚本将无法撤消。
  3. 选择 Delete（删除） 以确认删除。