文档

支持

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 分钟最后更新于 18 天前
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（删除） 以确认删除。