适用于 Unity 的插件：安装和设置插件组件 - Amazon GameLift
开始之前将插件添加到游戏项目。

适用于 Unity 的插件：安装和设置插件组件

本节介绍如何将插件添加到 Unity 项目。安装插件后，在 Unity 编辑器中打开项目时即可使用插件功能。

开始之前

以下是使用适用于 Unity 的 Amazon GameLift 插件所需的内容：

  • 适用于 Windows 2022 LTS 的 Unity 或适用于 MacOS 的 Unity

  • 适用于 Unity 的 Amazon GameLift 插件下载文件。[下载网站] 下载文件包含两个软件包：

    • 适用于 Unity 的 Amazon GameLift 独立插件

    • 适用于 Unity 的 Amazon GameLift C# 服务器 SDK

  • Microsoft Visual Studio 2019 或更高版本。

  • 一个包含 C# 游戏代码的多人游戏项目。

  • 第三方限定了注册表 UnityNuGet。此工具管理第三方 DLL。有关更多信息，请参阅 UnityNuGet Github 存储库。

将插件添加到游戏项目。

请在 Unity 编辑器和游戏项目文件中完成以下任务。

步骤 1：将 UnityNuGet 添加到游戏项目

如果您没有为游戏项目设置 UnityNuGet，请按照以下步骤使用 Unity 包管理器安装该工具。或者，您可以使用 NuGet CLI 手动下载 DLL。有关更多信息，请参阅适用于 Unity README 的 Amazon GameLift C# 服务器软件开发工具包。

  1. 在 Unity 编辑器中打开项目后，进入主菜单并依次选择编辑、项目设置。从选项中选择包管理器部分，然后打开范围界定的注册表组。

  2. 选择 + 按钮，然后为 UnityNuGet 范围内的注册表输入以下值：

    Name: Unity NuGet
URL: https://unitynuget-registry.azurewebsites.net
Scope(s): org.nuget

对于 Unity 2021 版本的用户：

设置 UnityNuGet 后，请检查 Unity 控制台中是否显示 Assembly Version Validation 错误。如果 NuGet 包中强命名程序集的绑定重定向未正确解析到 Unity 项目中的路径，则会发生这些错误。要解决这一问题，请配置 Unity 的程序集版本验证：

  1. 在 Unity 编辑器中，进入主菜单并依次选择编辑、项目设置，然后打开玩家部分。

  2. 取消选择程序集版本验证选项。

步骤 2：添加插件和 C# 服务器 SDK 软件包

  1. 解压缩适用于 Unity 的 Amazon GameLift 插件的下载文件，其中包含两个软件包。

  2. 在 Unity 编辑器中打开项目后，进入主菜单并依次选择窗口、软件包管理器。

  3. 选择 + 按钮添加新软件包。选择从 tarball 添加软件包选项。

  4. 在选择磁盘上的软件包中，找到适用于 Unity 的 Amazon GameLift C# 服务器 SDK 插件的下载文件，然后选择 com.amazonaws.gameliftserver.sdk-<version>.tgz 文件。选择打开以安装插件。

  5. 在选择磁盘上的软件包中，找到适用于 Unity 的 Amazon GameLift 独立插件的下载文件，然后选择文件 com.amazonaws.gamelift-<version>.tgz。选择打开以安装插件。

  6. 验证独立插件是否已添加到您的项目。返回到 Unity 编辑器窗口。检查主菜单中是否有新的 Amazon GameLift 菜单按钮。

步骤 3：导入示例游戏（可选）

适用于 Unity 的插件附带了一组示例游戏资产（包括场景），您可以将其添加到游戏项目。通过导入示例游戏，您可以快速使用 Amazon GameLift 测试、构建和部署一个简单的多人游戏。该示例游戏已与 Amazon GameLift SDK 完全集成，因此您可以跳过集成任务，只需完成剩余的工作流程任务即可。

使用示例游戏时，您可以在几分钟内设置并加入本地托管的 Amazon GameLift Anywhere 实例集。您可以在不到一小时的时间内将游戏部署到 Amazon GameLift 并加入云托管的实时游戏。

要导入示例游戏，请执行以下操作：

  1. 在 Unity 编辑器中打开游戏项目后，进入 Amazon GameLift 菜单并依次选择示例游戏、导入示例游戏。

  2. 导入文件后，再次进入 Amazon GameLift 菜单，然后依次选择示例游戏、初始化设置。此步骤将配置您的项目以构建游戏客户端和服务器。

安装完成后，您将看到游戏项目中添加了两个新场景。您还将看到一些额外的项目资产，包括一个 GameLiftClientSettings 资产。

有关示例 UI 和游戏玩法的更多详细信息，请参阅示例游戏自述文件。