GameLift 將 Amazon 集成到虛幻引擎項目中

將虛幻引擎原始碼複製到您選擇的分支中的開發環境。

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

查看您用來開發遊戲的版本標籤。例如，下列範例會檢出虛幻引擎版本 5.1.1：

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

導覽至本機存放庫的根資料夾。當您位於根資料夾時，請執行下列檔案：Setup.bat。

在根文件夾中，同時運行文件：GenerateProjectFiles.bat。

執行上述步驟中的檔案之後，會建立虛幻引擎解決方案檔案。UE5.sln打開視覺工作室，並在視覺工作室編輯器中打開該UE5.sln文件。

在 Visual Studio 中，開啟 [檢視] 功能表，然後選擇 [方案總管] 選項。這會開啟虛幻專案節點的右鍵功能表。在 [方案總管] 視窗中，以滑鼠右鍵按一下UE5.sln檔案 (可以只列出UE5)，然後選擇 [建置] 以使用開發編輯器 Win64 目標建置虛幻專案。

開啟 Visual Studio 時，瀏覽至 [方案總管] 窗格，然後選擇要開啟虛幻專UE5案的內容功能表的檔案。在內容功能表中，選擇「設定為啟動專案」選項。

在您的 Visual Studio 視窗的頂端，選擇開始偵錯 (綠色箭頭)。

此動作會啟動虛幻編輯器的新原始碼建置執行個體。如需使用虛幻編輯器的詳細資訊，請參閱虛幻引擎文件網站上的虛幻編輯器介面。

關閉您開啟的 Visual Studio 視窗，因為虛幻編輯器會開啟另一個 Visual Studio 視窗，其中包含虛幻專案和您的遊戲專案。

在「虛幻」編輯器中，執行下列任一項作業：

• 選擇您想要與 Amazon GameLift 整合的現有虛幻專案。

• 建立新專案。要嘗試使用虛幻的 Amazon GameLift 插件，請嘗試使用虛幻引擎的第三人稱模板。如需此範本的詳細資訊，請參閱虛幻引擎文件網站上的第三人稱視角範本。

  或者，使用下列設定來設定新專案：

  • C++

  • 隨著入門內容

  • 桌面

  • 專案名稱。在本主題的範例中，我們將專案命名為GameLiftUnrealApp。

在 Visual Studio 的解決方案總管中，瀏覽至虛幻專案的位置。在「虛幻」Source 資料夾中，找到名為Your-application-name.Target.cs的檔案。

例如：GameLiftUnrealApp.Target.cs。

複製此檔案並命名副本：Your-application-nameServer.Target.cs。

開啟新檔案並進行下列變更：

下載虛幻的 Amazon GameLift C ++ 服務器 SDK 插件。

下載 OpenSSL 裝 如需下載 OpenSSL 的詳細資訊，請參閱建置與安裝說明文件。

如需詳細資訊，請參閱 Windows 平台適用的 OpenSSL 注意事項說明文件。

下載庫後，為虛幻引擎構建 C ++ 服務器 SDK 庫。

在下載 SDK 的GameLift-Cpp-ServerSDK-<version>目錄中，使用-DBUILD_FOR_UNREAL=1參數進行編譯並構建服務器 SDK。下面的例子演示了如何使用編譯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資料夾中建立下列二進位檔案：

將這兩個程式庫檔案複製到 Amazon GameLift 虛幻引擎外掛程式套件中的ThirdParty\GameLiftServerSDK\Win64資料夾。

在先前的程序中，找出您從外掛程式解壓縮的GameLiftServerSDK資料夾。

Plugins在您的遊戲項目根文件夾中找到。（如果該文件夾不存在，則在那裡創建它。）

將GameLiftServerSDK資料夾複製到Plugins.

這將允許虛幻項目看到插件。

將 Amazon GameLift 服務器 SDK 插件添加到遊戲的.uproject文件中。

在這個例子中，應用程序被調用GameLiftUnrealApp，所以該文件將是GameLiftUnrealApp.uproject。

編輯.uproject檔案以將外掛程式新增至您的遊戲專案。

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

確保遊戲依賴於插件。 ModuleRules 開啟.Build.cs檔案並新增 Amazon GameLiftServer SDK 相依性。此檔案位於下Your-application-name/Source//Your-application-name/。

例如，教學課程檔案路徑為../GameLiftUnrealApp/Source/GameLiftUnrealApp/GameLiftUnrealApp.Build.cs。

添加"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;
    }
  }

在您的應用程式中開啟.sln檔案。在我們的例子中，該文件GameLiftUnrealApp.sln位於根文件夾中。

開啟解決方案後，找出應用程式的Your-application-nameGameMode.h檔案。範例：GameLiftUnrealAppGameMode.h。

將標頭檔案變更為與下列範例程式碼對齊。請務必將 "GameLiftUnrealApp" 取代為您自己的應用程式名稱。

#pragma once

#include "CoreMinimal.h"
#include "GameFramework/GameModeBase.h"
#include "GameLiftServerSDK.h"
#include "GameLiftUnrealAppGameMode.generated.h"

DECLARE_LOG_CATEGORY_EXTERN(GameServerLog, Log, All);

UCLASS(minimalapi)
class AGameLiftUnrealAppGameMode : public AGameModeBase
{
    GENERATED_BODY()

public:
    AGameLiftUnrealAppGameMode();

protected:
    virtual void BeginPlay() override;

private:
    // Process Parameters needs to remain in scope for the lifetime of the app
    FProcessParameters m_params;

    void InitGameLift();
};

開啟相關的來源Your-application-nameGameMode.cpp檔案。在我們的 Example:GameLiftUnrealAppGameMode.cpp. 中，並將代碼更改為與以下示例代碼對齊。請務必將 "GameLiftUnrealApp" 取代為您自己的應用程式名稱。

此範例說明如何新增與 Amazon 整合的所有必要元素 GameLift，如將 Amazon 新增 GameLift至遊戲伺服器中所述。其中包含：

#include "GameLiftUnrealAppGameMode.h"
#include "GameLiftUnrealAppCharacter.h"

#include "UObject/ConstructorHelpers.h"

DEFINE_LOG_CATEGORY(GameServerLog);

AGameLiftUnrealAppGameMode::AGameLiftUnrealAppGameMode()
{
    // set default pawn class to our Blueprinted character
    static ConstructorHelpers::FClassFinder<APawn> PlayerPawnBPClass(TEXT("/Game/ThirdPerson/Blueprints/BP_ThirdPersonCharacter"));
    if (PlayerPawnBPClass.Class != NULL)
    {
        DefaultPawnClass = PlayerPawnBPClass.Class;
    }
}

void AGameLiftUnrealAppGameMode::BeginPlay()
{
#if WITH_GAMELIFT
    InitGameLift();
#endif
}

void AGameLiftUnrealAppGameMode::InitGameLift()
{
    UE_LOG(GameServerLog, Log, TEXT("Initializing the GameLift Server"));

    //Getting the module first.
    FGameLiftServerSDKModule* gameLiftSdkModule = &FModuleManager::LoadModuleChecked<FGameLiftServerSDKModule>(FName("GameLiftServerSDK"));

    //Define the server parameters for a GameLift Anywhere fleet. These are not needed for a GameLift managed EC2 fleet.
    FServerParameters serverParameters;

    //AuthToken returned from the "aws gamelift get-compute-auth-token" API. Note this will expire and require a new call to the API after 15 minutes.
    if (FParse::Value(FCommandLine::Get(), TEXT("-authtoken="), serverParameters.m_authToken))
    {
        UE_LOG(GameServerLog, Log, TEXT("AUTH_TOKEN: %s"), *serverParameters.m_authToken)
    }

    //The Host/compute-name of the GameLift Anywhere instance.
    if (FParse::Value(FCommandLine::Get(), TEXT("-hostid="), serverParameters.m_hostId))
    {
        UE_LOG(GameServerLog, Log, TEXT("HOST_ID: %s"), *serverParameters.m_hostId)
    }

    //The Anywhere Fleet ID.
    if (FParse::Value(FCommandLine::Get(), TEXT("-fleetid="), serverParameters.m_fleetId))
    {
        UE_LOG(GameServerLog, Log, TEXT("FLEET_ID: %s"), *serverParameters.m_fleetId)
    }

    //The WebSocket URL (GameLiftServiceSdkEndpoint).
    if (FParse::Value(FCommandLine::Get(), TEXT("-websocketurl="), serverParameters.m_webSocketUrl))
    {
        UE_LOG(GameServerLog, Log, TEXT("WEBSOCKET_URL: %s"), *serverParameters.m_webSocketUrl)
    }

    //The PID of the running process
    serverParameters.m_processId = FString::Printf(TEXT("%d"), GetCurrentProcessId());
    UE_LOG(GameServerLog, Log, TEXT("PID: %s"), *serverParameters.m_processId);

    //InitSDK establishes a local connection with GameLift's agent to enable further communication.
    //Use InitSDK(serverParameters) for a GameLift Anywhere fleet. 
    //Use InitSDK() for a GameLift managed EC2 fleet.
    gameLiftSdkModule->InitSDK(serverParameters);

    //Implement callback function onStartGameSession
    //GameLift sends a game session activation request to the game server
    //and passes a game session object with game properties and other settings.
    //Here is where a game server takes action based on the game session object.
    //When the game server is ready to receive incoming player connections, 
    //it invokes the server SDK call ActivateGameSession().
    auto onGameSession = [=](Aws::GameLift::Server::Model::GameSession gameSession)
    {
        FString gameSessionId = FString(gameSession.GetGameSessionId());
        UE_LOG(GameServerLog, Log, TEXT("GameSession Initializing: %s"), *gameSessionId);
        gameLiftSdkModule->ActivateGameSession();
    };

    m_params.OnStartGameSession.BindLambda(onGameSession);

    //Implement callback function OnProcessTerminate
    //GameLift invokes this callback before shutting down the instance hosting this game server.
    //It gives the game server a chance to save its state, communicate with services, etc., 
    //and initiate shut down. When the game server is ready to shut down, it invokes the 
    //server SDK call ProcessEnding() to tell GameLift it is shutting down.
    auto onProcessTerminate = [=]() 
    {
        UE_LOG(GameServerLog, Log, TEXT("Game Server Process is terminating"));
        gameLiftSdkModule->ProcessEnding();
    };

    m_params.OnTerminate.BindLambda(onProcessTerminate);

    //Implement callback function OnHealthCheck
    //GameLift invokes this callback approximately every 60 seconds.
    //A game server might want to check the health of dependencies, etc.
    //Then it returns health status true if healthy, false otherwise.
    //The game server must respond within 60 seconds, or GameLift records 'false'.
    //In this example, the game server always reports healthy.
    auto onHealthCheck = []() 
    {
        UE_LOG(GameServerLog, Log, TEXT("Performing Health Check"));
        return true;
    };

    m_params.OnHealthCheck.BindLambda(onHealthCheck);

    //The game server gets ready to report that it is ready to host game sessions
    //and that it will listen on port 7777 for incoming player connections.
    m_params.port = 7777;

    //Here, the game server tells GameLift where to find game session log files.
    //At the end of a game session, GameLift uploads everything in the specified 
    //location and stores it in the cloud for access later.
    TArray<FString> logfiles;
    logfiles.Add(TEXT("GameLift426Test/Saved/Logs/GameLift426Test.log"));
    m_params.logParameters = logfiles;

    //The game server calls ProcessReady() to tell GameLift it's ready to host game sessions.
    UE_LOG(GameServerLog, Log, TEXT("Calling Process Ready"));
    gameLiftSdkModule->ProcessReady(m_params);
}

為下列兩種目標類型建置遊戲專案：開發編輯器和開發伺服器。

兩個組建都完成後，請關閉 Visual Studio 並開啟專.uproject案的檔案，以便在虛幻編輯器中開啟。

在虛幻編輯器中，封裝遊戲的伺服器組建。若要選擇目標，請移至「平台」、「視窗」，然後選取「Y our-application-name 伺服器」。

要開始構建服務器應用程序的過程，請轉到平台，Windows，然後選擇 P ackage 項目。當構建完成時，您應該有一個可執行文件。在我們的例子中，文件名是GameLiftUnrealAppServer.exe。

在虛幻編輯器中構建服務器應用程序會產生兩個可執行文件。其中一個位於遊戲組建資料夾的根目錄中，並做為實際伺服器可執行檔的包裝函式。

使用伺服器組建建建立 Amazon GameLift 叢集時，建議您傳入實際的伺服器可執行檔做為執行階段組態啟動路徑。例如，在您的遊戲構建文件夾中，您可能在根目錄中有一個GameLiftFPS.exe文件，另一個文件位於\GameLiftFPS\Binaries\Win64\GameLiftFPSServer.exe。建立叢集時，建議您使用C:\GameLiftFPS\Binaries\Win64\GameLiftFPSServer.exe做為執行階段設定的啟動路徑。

請務必在 Amazon GameLift 叢集上開啟必要的 UDP 連接埠，以便遊戲伺服器可以與遊戲用戶端進行通訊。默認情況下，虛幻引擎使用端口7777。如需詳細資訊，請參閱 Amazon GameLift 服務 API 參考指南UpdateFleetPortSettings中的。

為您的遊戲構建創建一個install.bat文件。只要將遊戲組建部署到 Amazon GameLift 叢集，就會執行此安裝指令碼。這是一個示例install.bat文件：

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

對於某些版本的虛幻引擎，install.bat應該是

VC_redist.x64.exe /q
UEPrereqSetup_x64.exe /q

現在，您可以打包並上傳您的遊戲構建到 Amazon GameLift。

您在遊戲組建中封裝的 OpenSSL 版本必須符合遊戲引擎在建置遊戲伺服器時所使用的版本。請務必將正確的 OpenSSL 版本與您的遊戲伺服器組建一起封裝。對於視窗作業系統，OpenSSL 格式為.dll.