本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

將 Amazon GameLift 整合至 Unity 專案

本主題說明如何設定 GameLift Unity 的 Amazon C# 伺服器SDK外掛程式，並將其整合到您的遊戲專案中。

其他資源：

必要條件

若要使用 Unity 的 Amazon GameLift C# 伺服器SDK外掛程式，您需要下列元件：

設定 UnityNuGet

如果您尚未 UnityNuGet 設定遊戲專案，請使用下列步驟，使用 Unity 套件管理員安裝工具。或者，您可以使用 NuGet CLI手動下載 DLLs。如需詳細資訊，請參閱 Unity SDK的 Amazon GameLift C# 伺服器README。

安裝外掛程式。

使用下列程序安裝 Unity 的 Amazon GameLift C# 伺服器SDK外掛程式，並設定 log4net 記錄。

Amazon GameLift 伺服器SDK使用 log4net 架構輸出日誌訊息。依預設，其設定為將訊息輸出至伺服器建置的終端，但 Unity 需要組態才能新增檔案記錄支援。您可以在 Amazon GameLift Server SDK套件內匯入提供的範例，將此支援新增至專案。使用下列程序新增範例並設定 log4net：

如需更詳細的說明和測試指南，請參閱README位於外掛程式下載中的 。

設定 Amazon GameLift Anywhere 用於測試的機群

您可以將開發工作站設定為 Amazon GameLift Anywhere 託管機群以反覆測試您的 Amazon GameLift 整合。透過此設定，您可以在工作站上啟動遊戲伺服器程序、將玩家聯結或配對請求傳送至 Amazon GameLift 以啟動遊戲工作階段，並將用戶端連接至新的遊戲工作階段。透過將自己的工作站設定為託管伺服器，您可以監控與 Amazon 的遊戲整合的各個層面 GameLift。

如需設定工作站的指示，請參閱 使用 Amazon 設定本機測試 GameLift Anywhere 以完成下列步驟：

將 Amazon GameLift 伺服器程式碼新增至 Unity 專案

您的遊戲伺服器會與 Amazon GameLift 服務通訊，以接收指示並報告持續狀態。若要完成此操作，請新增使用 Amazon GameLift 伺服器 的遊戲伺服器程式碼SDK。

提供的程式碼範例說明基本必要的整合元素。它使用 MonoBehavior來說明使用 Amazon 進行簡易遊戲伺服器初始化 GameLift。此範例假設遊戲伺服器在 Amazon 上執行 GameLift Anywhere 用於測試的機群。它包含程式碼以：

本主題中顯示的程式碼會建立與 Amazon GameLift 服務和 的通訊。它也會實作一組回呼函數，以回應來自 的請求。如需每個函數和程式碼功能的詳細資訊，請參閱初始化伺服器程序 。如需此程式碼中使用的SDK動作和資料類型的詳細資訊，請參閱 Amazon GameLift Server SDK 5.x for C# 和 Unity： 動作。

此範例說明如何將所有必要的元素 新增至 GameLift 您的遊戲伺服器 ，如新增 Amazon 所述。它包括：

如需新增 Amazon GameLift 功能的詳細資訊，請參閱下列主題：

using System.Collections.Generic;
using Aws.GameLift.Server;
using UnityEngine;

public class ServerSDKManualTest : MonoBehaviour
{    
    //This example is a simple integration that initializes a game server process 
    //that is running on an Amazon GameLift Anywhere fleet.
    void Start()
    {        
        //Identify port number (hard coded here for simplicity) the game server is listening on for player connections
        var listeningPort = 7777;

        //WebSocketUrl from RegisterHost call
        var webSocketUrl = "wss://us-west-2.api.amazongamelift.com";

        //Unique identifier for this process
        var processId = "myProcess";

        //Unique identifier for your host that this process belongs to
        var hostId = "myHost";

        //Unique identifier for your fleet that this host belongs to
        var fleetId = "myFleet";

        //Authorization token for this host process
        var authToken = "myAuthToken";

        //Server parameters are required for a GameLift Anywhere fleet.
        //They are not required for a GameLift managed EC2 fleet.
        ServerParameters serverParameters = new ServerParameters(
            webSocketUrl,
            processId,
            hostId,
            fleetId,
            authToken);

        //InitSDK establishes a local connection with an Amazon GameLift agent 
        //to enable further communication.
        var initSDKOutcome = GameLiftServerAPI.InitSDK(serverParameters);        
        if (initSDKOutcome.Success)
        {
            //Implement callback functions
            ProcessParameters processParameters = new ProcessParameters(
            //Implement OnStartGameSession callback
                (gameSession) => {
                    //GameLift sends a game session activation request to the game server 
                    //with game session object containing 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().
                    GameLiftServerAPI.ActivateGameSession();
                },
                (updateGameSession) => {
                    //GameLift sends a request when a game session is updated (such as for 
                    //FlexMatch backfill) with an updated game session object. 
                    //The game server can examine matchmakerData and handle new incoming players.
                    //updateReason explains the purpose of the update.
                },
                () => {
                    //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.
                    GameLiftServerAPI.ProcessEnding();
                }, 
                () => {
                    //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.
                    return true;
                },
                //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.
                listeningPort, 
                new LogParameters(new List<string>()
                {
                    //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.
                    "/local/game/logs/myserver.log"
                }));

            //The game server calls ProcessReady() to tell GameLift it's ready to host game sessions.
            var processReadyOutcome = GameLiftServerAPI.ProcessReady(processParameters);
            if (processReadyOutcome.Success)
            {
                print("ProcessReady success.");
            }
            else
            {
                print("ProcessReady failure : " + processReadyOutcome.Error.ToString());
            }
        }
        else
        {
            print("InitSDK failure : " + initSDKOutcome.Error.ToString());
        }
    }  

    void OnApplicationQuit()
    {
        //Make sure to call GameLiftServerAPI.ProcessEnding() and GameLiftServerAPI.Destroy() before terminating the server process.
        //These actions notify Amazon GameLift that the process is terminating and frees the API client from memory. 
        GenericOutcome processEndingOutcome = GameLiftServerAPI.ProcessEnding();
        GameLiftServerAPI.Destroy();
        if (processEndingOutcome.Success)
        {
            Environment.Exit(0);
        }
        else
        {
            Console.WriteLine("ProcessEnding() failed. Error: " + processEndingOutcome.Error.ToString());
            Environment.Exit(-1);  
        }
    }
}

其他資源

使用下列資源來測試您的遊戲伺服器並展開功能：