将 Amazon GameLift 集成到虚幻引擎项目中

将 Unreal Engine 源代码克隆到您的开发环境中

1. 在您选择的分支中将 Unreal Engine 源代码克隆到您的开发环境中。

   git clone https://github.com/EpicGames/UnrealEngine.git

2. 查看您用来开发游戏的版本的标签。例如，以下示例查看了 Unreal Engine 版本5.1.1：

   git checkout tags/5.1.1-release -b 5.1.1-release

3. 导航到本地存储库的根文件夹。当您在根文件夹中时，运行以下文件：Setup.bat。

4. 在根文件夹中，还要运行文件：GenerateProjectFiles.bat。

5. 运行前面步骤中的文件后，将创建 Unreal Engine 解决方案文件。UE5.sln打开 Visual Studio，然后在 Visual Studio 编辑器中打开该UE5.sln文件。

6. 在 Visual Studio 中，打开查看菜单，然后选择解决方案资源管理器选项。这将打开虚幻项目节点的快捷菜单。在解决方案资源管理器窗口中，右键单击 UE5.sln 文件（可以将其列为只列出 UE5），然后选择构建，使用开发编辑器 Win64 目标构建 Unreal 项目。

   注意

   此教程可在 1 个小时内完成。

为插件配置项目

1. 打开Visual Studio后，导航到解决方案资源管理器窗格并选择UE5文件以打开虚幻项目的快捷菜单。在上下文菜单中，选择设置为启动项目选项。

2. 在 Visual Studio 窗口的顶部，选择开始调试（绿色箭头）。

   这个动作会启动您新的源代码构建的虚幻编辑器实例。有关使用虚幻编辑器的更多信息，请参阅 Unreal Engine 文档网站上的虚幻编辑器界面。

3. 关闭您打开的 Visual Studio 窗口，因为虚幻编辑器会打开另一个包含虚幻项目和您的游戏项目的Visual Studio窗口。

4. 在 编辑器中，执行以下操作之一：

   • 选择要与Amazon集成的现有虚幻项目 GameLift。

   • 创建新 项目 要尝试使用适用于虚幻引擎的Amazon GameLift 插件，请尝试使用虚幻引擎的第三人称视角模板。有关此模板的更多信息，请参阅 Unreal Engine 文档网站上的第三人称视角模板。

     或者，使用以下设置配置新项目：

     • C++

     • 包含入门内容

     • Desktop

     • Project Name 在本主题的示例中，我们命名了我们的项目GameLiftUnrealApp。

5. 在Visual Studio的解决方案资源管理器中，导航到您的虚幻项目所在的位置。在虚幻Source文件夹中，找到一个名为的文件Your-application-name.Target.cs。

   例如：GameLiftUnrealApp.Target.cs。

6. 为文件创建一个副本并将该副本命名为 Your-application-nameServer.Target.cs。

7. 打开新文件并进行以下更改：

   • 更改class和constructor以匹配文件名。

   • 将 Type 从 TargetType.Game 更改为 TargetType.Server。

   • 最终文件将类似于以下示例：

        public class GameLiftUnrealAppServerTarget : TargetRules
         {  
             public GameLiftUnrealAppServerTarget(TargetInfo Target) : base(Target)
             {
                 Type = TargetType.Server;
                 DefaultBuildSettings = BuildSettingsVersion.V2;
                 IncludeOrderVersion = EngineIncludeOrderVersion.Unreal5_1;
                 ExtraModuleNames.Add("GameLiftUnrealApp");
             }
         }

构建适用于 Unreal 的 C++ 服务器软件开发工具包库。

1. 下载适用于虚幻引擎的 Amazon GameLift C++ 服务器 SDK 插件。

   注意

   将软件开发工具包 放在默认下载目录可能会导致构建失败，因为路径超过 260 个字符的限制。例如：C:\Users\Administrator\Downloads\GameLift-SDK-Release-06_15_2023\GameLift-Cpp-ServerSDK-5.0.4

   例如，我们建议您将软件开发工具包移到另一个目录C:\GameLift-Cpp-ServerSDK-5.0.4。

2. 下载并安装 Maven。有关下载 OpenSSL 的更多信息，请阅读 Github Op enSSL 构建和安装文档。

   有关更多信息，请阅读适用于 Windows 平台的 OpenSSL 注意事项文档。

   注意

   你用来构建亚马逊 GameLift 服务器软件开发工具包的 OpenSSL 版本应与虚幻引擎用来打包游戏服务器的 OpenSSL 版本相匹配。你可以在虚幻安装目录中找到版本信息...Engine\Source\ThirdParty\OpenSSL。

3. 下载库后，为 Unreal Engine 构建 C++ 服务器软件开发工具包 库。

   在下载的软件开发工具包 的GameLift-Cpp-ServerSDK-<version>目录中，使用-DBUILD_FOR_UNREAL=1参数进行编译并构建服务器软件开发工具包。以下示例演示了如何使用 cmake 命令。

   在计算机终端中运行以下命令。

   mkdir cmake-build
   cmake.exe -G "Visual Studio 17 2022" -DCMAKE_BUILD_TYPE=Release -S . -B ./cmake-build -DBUILD_FOR_UNREAL=1 -A x64
   cmake.exe --build ./cmake-build --target ALL_BUILD --config Release

   Windows 版本将在该out\gamelift-server-sdk\Release文件夹中创建以下二进制文件：

   • cmake-build\prefix\bin\aws-cpp-sdk-gamelift-server.dll

   • cmake-build\prefix\bin\aws-cpp-sdk-gamelift-server.lib

   将这两个库文件复制到亚马逊 GameLift 虚幻引擎插件包中的ThirdParty\GameLiftServerSDK\Win64文件夹。

导入 Amazon GameLift 插件

1. 找到您在前面的过程中从插件中提取GameLiftServerSDK的文件夹。

2. Plugins在您的游戏项目根文件夹中找到。（如果该文件夹不存在，则在那里创建。）

3. 将该GameLiftServerSDK文件夹复制到Plugins。

   这将允许虚幻项目看到该插件。

4. 将 Amazon GameLift 服务器 SDK 插件添加到游戏.uproject文件中。

   在示例中，应用程序被调用GameLiftUnrealApp，因此文件将被调用GameLiftUnrealApp.uproject。

5. 编辑.uproject文件以将插件添加到您的游戏项目中。

   "Plugins": [
       {
           "Name": "GameLiftServerSDK",
           "Enabled": true
       }
   ]

6. 确保游戏依赖 ModuleRules 于插件。打开.Build.cs文件并添加 Amazon GameLiftServer SDK 依赖项。此文件位于 Your-application-name/Source//Your-application-name/。

   例如，教程的文件路径是../GameLiftUnrealApp/Source/GameLiftUnrealApp/GameLiftUnrealApp.Build.cs。

7. "GameLiftServerSDK"添加到列表的末尾PublicDependencyModuleNames.

   using UnrealBuildTool;
   using System.Collections.Generic;
   public class GameLiftUnrealApp : ModuleRules  
     {
       public GameLiftUnrealApp(TargetInfo Target)
       {
         PublicDependencyModuleNames.AddRange(new string[] { "Core", "CoreUObject", "Engine", "InputCore", "GameLiftServerSDK" });
         bEnableExceptions = true;
       }
     }

搭建您的游戏服务器

将服务器 SDK 代码添加到项目后，请按照以下步骤创建游戏服务器版本并将其上传到 Amazon GameLift 进行托管。

1. 为以下两种目标类型构建游戏项目：开发编辑器和开发服务器。

   注意

   您不需要重新构建解决方案。相反，只在与您的应用程序名称相匹配的Games文件夹下构建项目。否则，Visual Studio 会重建整个 UE5 项目，这可能需要长达一个小时的时间。

2. 两个构建都完成后，关闭Visual Studio并打开项目的.uproject文件以在虚幻编辑器中将其打开。

3. 在虚幻编辑器中，打包游戏的服务器版本。要选择目标，请前往 “平台”、“Windows”，然后选择 “Y our-application-name 服务器”。

4. 要开始构建服务器应用程序的过程，请转到平台、Windows，然后选择Package Project。构建完成后，您就有了可执行文件，例如GameLiftUnrealAppServer.exe。

5. 在虚幻编辑器中构建服务器应用程序会生成两个可执行文件。一个位于游戏构建文件夹的根目录中，用作实际服务器可执行文件的封装器。

   使用您的服务器版本创建 Amazon GameLift 队列时，我们建议您传入实际的服务器可执行文件作为运行时配置启动路径。例如，在您的游戏版本文件夹中，您的根目录可能有一个GameLiftFPS.exe文件，另一个位于根目录\GameLiftFPS\Binaries\Win64\GameLiftFPSServer.exe。创建队列时，我们建议您使用C:\GameLiftFPS\Binaries\Win64\GameLiftFPSServer.exe作为运行时配置的启动路径。

6. 确保在 Amazon GameLift 舰队上打开必要的 UDP 端口，以便游戏服务器可以与游戏客户端通信。默认情况下， Unreal Engine 使用端口7777。有关更多信息，请参阅 UpdateFleetPortSettingsAmazon GameLift 服务 API 参考指南。

7. 为您的游戏版本创建install.bat文件。每当游戏版本部署到 Amazon GameLift 舰队时，都会运行此安装脚本。下面给出了一个示例文件：

   VC_redist.x64.exe /q
   UE5PrereqSetup_x64.exe /q

8. 现在，您可以将游戏版本打包并上传到 Amazon GameLift。

   您用于构建的 OpenSSL 版本需要与游戏服务器使用的版本相匹配。确保在游戏服务器版本中打包正确的 OpenSSL 版本。对于 Windows 操作系统，OpenSSL 格式为。.dll

   注意

   Package 将 OpenSSL DLL 打包到您的游戏服务器版本中。请务必使用与构建游戏服务器时相同版本的 DLL。

   • libssl-3-x64.dll

   • libcrypto-3-x64.dll

   Package 将依赖项和游戏服务器可执行文件一起打包到 zip 文件的根目录中。例如，openssl-libdll 应与.exe文件位于同一目录中。