# Unity Dashboard

> Create and manage Cloud Code scripts using the graphical interface of the Unity Dashboard.

[Unity Dashboard](https://cloud.unity.com) 提供易于使用的图形界面来全面控制脚本。本节将介绍如何预览、创建、编辑和删除脚本。

## 预览脚本##preview-scripts

您可以从 Unity Dashboard 访问某个[环境](/services/service-environments.md)的所有 Cloud Code 脚本的列表。访问方式如下：

1. 在 [Unity Dashboard](https://cloud.unity.com) 中，选择 **Products（产品）**> **Cloud Code**。
2. 选择 **Scripts（脚本）**。
3. 从环境列表中选择一个环境。

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

## 创建脚本##create-a-script

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

1. 在 Unity Dashboard 中，选择 **Products（产品）**> **Cloud Code**，然后选择 **Scripts（脚本）**。

2. 选择 **Create your first script（创建您的第一个脚本）**。

   > **Note:**
   >
   > 每个脚本都关联到一个特定的[环境](/cloud/projects.md)。

3. 填写以下信息：

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

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

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

4. 选择 **Next（下一步）**。

5. 在下一个窗口中，填写所选脚本类型的信息。

下一个屏幕是[脚本编辑器](#script-editor)，您可以在其中测试和编辑代码及其详细信息。

## 添加参数##script-editor

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（添加）**。

## 脚本编辑器##script-details

基于浏览器的脚本编辑器会显示代码中的错误，并提供 JavaScript 自动补全功能。

Run Code（运行代码）选项卡中会显示以下内容：

* Script Code（脚本代码）部分，其中包含您的脚本代码。
* Parameters（参数）表，其中列出您创建的所有参数及其值，并具有[生成测试玩家 ID](../test-run#generate-a-test-player-id) 的功能。标记为“必需”的参数会显示在可选参数之前。
* [Response/Logs/Request（响应/日志/请求）选项卡](../test-run#test-run-response)，其中显示脚本运行后的相关信息。
* **Beautify（美化）** 按钮，用于自动调整代码格式以优化其易读性。

此编辑器具有以下特性：

* 通过简单的代码自动补全功能提供简单的 JavaScript 特性。
* 针对常见问题（如语法错误、缺少分号和无法访问的代码）提供批注。
* 针对测试执行期间发生的错误（例如类型错误、范围错误和其他抛出的错误）提供批注。

每个新脚本都预先填充了一个示例，以便您快速入门。

## 脚本详细信息##saving-and-publishing

选择 Details（详细信息）选项卡可查看以下信息：

* 脚本名称
* 类型
* 上次发布日期
* 上次发布版本

此外，还会列出先前创建的脚本参数。您可以编辑这些参数或在此表中创建新参数。

## 保存和发布##delete-a-script

在 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](https://cloud.unity.com) 中删除脚本，请执行以下操作：

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

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

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

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