Unity 编辑器#

您可以使用 Unity 编辑器来创建和部署 Cloud Code 模块。Cloud Code 包中包含的 Cloud Code Authoring 模块允许使用 Deployment 包来处理模块。

先决条件

要在 Unity 编辑器中使用 Cloud Code，请按照以下步骤操作。

关联项目#

将 Unity Gaming Services（Unity 游戏服务）项目与 Unity 编辑器关联。您可以在 Unity Dashboard（Unity 后台）中找到您的 UGS Project ID。

1. 在 Unity 编辑器中，选择 Edit（编辑）> Project Settings（项目设置）> Services（服务）。

2. 关联您的项目。

   • 如果项目没有 Unity Project ID：

     1. 选择 Create a Unity Project ID（创建 Unity Project ID）> Organizations（组织），然后从下拉菜单中选择一个组织。
     2. 选择 Create project ID（创建 Project ID）。

   • 如果已有 Unity Project ID：

     1. 选择 Use an existing Unity project ID（使用现有 Unity Project ID）。
     2. 从下拉菜单中选择组织和项目。
     3. 选择 Link project ID（关联 Project ID）。

此时将显示您的 Unity Project ID，并且该项目现在已关联到 Unity 服务。

此外，还可以使用 UnityEditor.CloudProjectSettings.projectId 参数在 Unity 编辑器脚本中访问您的 Project ID。

安装 .NET#

要在编辑器中部署 Cloud Code 模块，必须先安装 .NET。

按照以下步骤在编辑器中设置默认的 .NET 路径：

1. 在 Unity 编辑器中，选择 Edit（编辑）> Preferences...（偏好设置...）> Cloud Code。
2. 在 **.NET development environment（.NET 开发环境）**部分中，将 **.NET path（.NET 路径）**修改为实际安装路径。
3. 选择 Apply（应用）。

安装所需的包#

要在编辑器中创建 Cloud Code 模块，必须安装以下包：

• Deployment
• Cloud Code（2.5.0 或更高版本）

请安装这些包，并将它们添加到可用包的列表中：

1. 在 Unity 编辑器的 Package Manager（包管理器）窗口中，选择 +（添加）> Add package by name...（按名称添加包...）。
2. 输入 com.unity.services.deployment。
3. 选择 Add（添加）。
4. 对 com.unity.services.cloudcode 重复以上步骤。

预览 Deployment（部署）窗口#

在 Deployment（部署）窗口中可以将 Cloud Code 模块部署到远程环境。如果安装了 Deployment 包，则可以从 Unity 编辑器访问该包。

• 在 Unity 编辑器版本 2021.3+ 中：选择 Window（窗口）> Deployment（部署）。
• 在 Unity 编辑器版本 2022+ 中：选择 Services（服务）> Deployment（部署）。

在使用 Deployment（部署）窗口之前，必须选择要部署到的环境。

请参阅 Deployment（部署）窗口以了解更多信息。

在 Unity 编辑器中创作#

安装的 Cloud Code 包中包含 Cloud Code Authoring 模块。借助该模块可以直接从 Unity 编辑器创建和部署 Cloud Code 模块。

为此，请在编辑器中创建一个模块引用文件，并将此文件关联到模块项目。配置完成后，在 Deployment（部署）窗口中可以将模块部署到远程环境。

创建 C# 模块引用文件#

首先，创建一个 Cloud Code C# 模块引用文件。此文件是对模块项目的引用，其中包含要部署的 C# 解决方案的路径。

1. 在 Unity 编辑器的 Project（项目）窗口中右键单击，然后选择 Create（创建）> Cloud Code C# Module Reference（Cloud Code C# 模块引用）。
2. 将模块引用命名为与模块相同的名称。在编辑器中，Cloud Code 模块使用其引用文件名来生成和/或部署模块。
3. 按 Enter。

现在，新的模块引用会显示在 Project（项目）窗口和 Deployment（部署）窗口中。要访问模块引用，请选择 Window（窗口）> Deployment（部署）。

关联模块#

C# 模块引用需要关联到模块。您可以关联现有模块，也可以从 Unity 编辑器生成新模块。

关联现有模块

如果要使用其他创作方法来创建新模块，请参阅编写模块。模块引用附带默认解决方案路径。应更改此路径以指向现有模块解决方案。

1. 在 Unity 编辑器的 Project（项目）窗口中选择模块引用文件。
2. 在 Inspector（检视面板）窗口中，修改 **Solution Path（解决方案路径）**字段以指向现有模块解决方案。

生成新模块

还可以从 Unity 编辑器生成新模块。

1. 在 Unity 编辑器的 Project（项目）窗口中选择模块引用文件。
2. 在 Inspector（检视面板）窗口中，单击 Generate Solution（生成解决方案）。

要直接从 Deployment（部署）窗口生成新模块，请右键单击模块引用文件，然后选择 Generate Solution（生成解决方案）。

此时将在与模块引用文件相同的目录中生成一个新的模板模块解决方案。

部署模块#

您可以通过 Deployment（部署）窗口部署模块，还可以在 Unity 编辑器中进入运行模式时自动部署。

请查看 Deployment 包手册以了解更多信息。

您可以通过调用模块终端来验证部署是否成功。模板模块包含一个名为 SayHello 的默认终端。

请参阅运行模块以获取更多信息。