开始之前构建 Amazon GameLift C++ 服务器 SDK 将插件添加到游戏项目。

虚幻引擎插件：安装和设置插件组件

本节介绍将插件添加到 Unreal Engine 项目的初始安装任务。当在 Unreal 编辑器中打开项目时，插件功能就可用。

注意

您可以将 Amazon GameLift 插件与标准版本的 UE 编辑器一起使用，但是在打包游戏服务器版本时，需要使用源代码构建的版本。

开始之前

以下是使用适用于虚幻引擎的Amazon GameLift 插件所需的内容：

适用于虚幻引擎的Amazon GameLift 插件发布包。[下载网站]。
Microsoft Visual Studio 2019 或更高版本。
Unreal Engine 编辑器的源代码构建版本。需要一个源代码构建版本来打包多人游戏的服务器组件。如需更多详细信息，包括其他先决条件，请参阅 Unreal Engine 文档：
- 在 You need GitHub 和 Epic Games 账号@@ 上 GitHub 访问虚幻引擎源代码。
- 基于源代码构建 Unreal Engine 教程。
一个包含 C++ 游戏代码的多人游戏项目。如果你正在使用蓝图项目，请参阅虚幻文档，了解如何为项目生成 C++ 源代码。

构建 Amazon GameLift C++ 服务器 SDK

虚幻引擎的Amazon GameLift 插件发布包包含虚幻引擎C++服务器SDK的源代码。在将其与插件一起使用之前，您需要提取源代码并针对您的开发环境进行构建。

注意

如果您正在构建游戏服务器以在 Amazon Linux 2023 运行时环境中运行，则可以利用辅助脚本，该脚本作为 Amazon GameLift Toolkit 存储库的一部分提供。使用此辅助脚本生成插件使用的SDK二进制文件和SSL库。当你在Windows或Linux上使用虚幻引擎5进行开发时，你可以使用这个脚本。该脚本是一个基于 Docker 的解决方案。你可以在安装了 git 和 docker 的情况下在本地运行它，也可以使用 AWS CloudShell 中的运行脚本。 AWS Management Console

详细了解适用于虚幻引擎 5 的 Amazon GameLift 编译脚本。

为虚幻引擎手动构建 C++ 服务器 SDK

解压适用于虚幻引擎的Amazon GameLift 插件发布包，以提取两个压缩文件：
- amazon-gamelift-plugin-unreal-<>-sdk-<>.zip
- GameLift-Cpp-ServerSDK-<>.zip.
解压缩这些文件。
打开该GameLift-Cpp-ServerSDK-<>文件夹，然后根据您的平台完成以下说明：Linux 或 Microsoft Windows。

Linux

运行以下命令：
```
mkdir out 
cd out
cmake -DBUILD_FOR_UNREAL=1 ..
make
```
这些命令会生成/lib/aws-cpp-sdk-gamelift-server.so文件。
复制/lib/aws-cpp-sdk-gamelift-server.so到该amazon-gamelift-plugin-unreal/GameLiftPlugin/Source/GameliftServer/ThirdParty/GameLiftServerSDK/Linux/x86_64-unknown-linux-gnu/目录。

Microsoft Windows

运行以下命令：
```
mkdir out 
cd out 
cmake -G "Visual Studio 17 2022" -DBUILD_FOR_UNREAL=1 .. 
msbuild ALL_BUILD.vcxproj /p:Configuration=Release
```
这些命令生成以下二进制文件。
- prefix\bin\aws-cpp-sdk-gamelift-server.dll
- prefix\lib\aws-cpp-sdk-gamelift-server.lib
将文件复制到amazon-gamelift-plugin-unreal\GameLiftPlugin\Source\GameliftServer\ThirdParty\GameLiftServerSDK\Win64\目录中。

将插件添加到游戏项目。

在虚幻编辑器中打开游戏项目，完成以下任务。

将插件添加到项目中

安装插件文件。
1. 找到您的游戏项目根文件夹，例如 ... > Unreal Projects/[project-name]/。锁定Plugins文件夹。如果该文件夹不存在，则创建该文件夹。
2. 解压缩插件发布包 (amazon-gamelift-plugin-unreal-<>-sdk-<>.zip)。打开该amazon-gamelift-plugin-unreal文件夹并找到该GameLiftPlugin文件夹。将此文件夹复制到步骤 1 Plugins 中的文件夹。

将插件添加到 .uproject 文件。

在您的游戏项目根文件夹中，打开 .uproject 文件。
更新文件以将 “GameLiftPlugin” 和 “WebBrowserWidget” 添加到该Plugins部分并启用它们。以下代码显示了名为 “MyGame” 的游戏的更新.uproject文件。


UnrealProjects > MyGame > MyGame.uproject
{ 
  ...
  "Plugins": [
    {
      "Name": "ModelingToolsEditorMode",
      "Enabled": true,
      "TargetAllowList": [ "Editor" ]
    },
    {
      "Name": "GameLiftPlugin",
      "Enabled": true
    },
    {
      "Name": "WebBrowserWidget",
      "Enabled": true
    }
  ]
}

更改项目的 UE 编辑器版本。

如果您为一个编辑器版本创建了项目，但现在想要更改为另一个版本（例如源代码构建版本），则需要更新该项目。

在游戏项目根文件夹中，选择 .uproject 文件并选择切换 Unreal Engine 版本。选择新的编辑器版本。
使用您的更新重新构建项目解决方案。
1. 在项目根文件夹中，查找解决方案（*.sln）文件。如果不存在任何文件，请选择 .uproject 文件并选择生成 Visual Studio 项目文件选项。
2. 打开解决方案文件并构建或重建项目。
确认该插件已在 UE 编辑器中启用。

注意
如果已经打开了编辑器，则可能需要在编辑器识别新插件之前重新启动编辑器。
1. 在选择的 UE 编辑器中打开项目。
2. 在主编辑器工具栏中查看新的Amazon GameLift 菜单按钮 [需要图片]。
3. 在内容浏览器中查找 Amazon GameLift 插件资产。确保在您的查看选项设置中，已选中显示插件内容选项。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

虚幻引擎插件

设置 AWS 用户个人资料