Unity Dashboard（Unity 后台）#

Unity Dashboard（Unity 后台）提供易于使用的图形界面来全面控制脚本。本节将介绍如何预览、创建、编辑和删除脚本。

预览脚本

您可以从 Unity Dashboard（Unity 后台）访问某个环境的所有 Cloud Code 脚本的列表。访问方式如下：

1. 在 Unity Dashboard（Unity 后台）的 LiveOps 部分中，选择 Cloud Code。
2. 选择 Scripts（脚本）。
3. 从环境列表中选择一个环境。

此时将显示项目所选环境中所有 Cloud Code 脚本的列表。表中包含脚本的名称、类型、上次发布日期和版本。您可以按脚本名称对表进行排序，也可以使用分页来查看全部的脚本。

创建脚本#

在 Unity Dashboard（Unity 后台）中创建您的第一个脚本来开始使用 Cloud Code。

1. 在 LiveOps 部分中，转到 Cloud Code，然后选择 Explore（探索）。

2. 选择 Create a new script（创建新脚本）。

   每个脚本都关联到一个特定的环境。

3. 填写以下信息：

   • Name（名称）：脚本的描述性名称，用于在 Cloud Code 后端标识和执行脚本。脚本名称在整个项目和环境中必须具有唯一性，只能包含字母、数字、下划线和短划线，且不超过 50 个字符。

   • Type（类型）：脚本的类型。

     目前，Cloud Code 仅支持通过 API 调用从游戏客户端触发脚本。

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 Dashboard（Unity 后台）中删除脚本，请执行以下操作：

1. 导航到 Scripts（脚本）列表页面。

2. 选择垃圾桶图标。此时将显示一个对话框，警告您删除此脚本将无法撤消。

   删除实时游戏正在使用的发布脚本会导致游戏客户端出现错误。

3. 选择 **Delete（删除）**以确认删除。