Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Integrieren Sie Amazon GameLift in ein Unity-Projekt

In diesem Thema wird erklärt, wie Sie das Amazon GameLift C# Server SDK-Plugin für Unity einrichten und in Ihre Spielprojekte integrieren.

Zusätzliche Ressourcen:

Voraussetzungen

Um das Amazon GameLift C#-Server-SDK-Plugin für Unity zu verwenden, benötigen Sie die folgenden Komponenten:

Einrichten von UnityNuGet

Wenn Sie Ihr Spieleprojekt noch nicht UnityNuGet eingerichtet haben, führen Sie die folgenden Schritte aus, um das Tool mithilfe des Unity-Paketmanagers zu installieren. Alternativ können Sie die NuGet CLI verwenden, um die DLLs manuell herunterzuladen. Weitere Informationen finden Sie im Amazon GameLift C#-Server-SDK SDK for UnityREADME.

Installieren Sie das Plug-in

Gehen Sie wie folgt vor, um das Amazon GameLift C#-Server-SDK-Plugin für Unity zu installieren und die Log4net-Protokollierung zu konfigurieren.

Das GameLift Amazon-Server-SDK verwendet das Log4net-Framework zur Ausgabe von Protokollnachrichten. Es ist standardmäßig so konfiguriert, dass Nachrichten an das Terminal eines Server-Builds ausgegeben werden. Unity benötigt jedoch eine Konfiguration, um Unterstützung für die Dateiprotokollierung hinzuzufügen. Sie können diese Unterstützung zu Ihrem Projekt hinzufügen, indem Sie das bereitgestellte Beispiel in das Amazon GameLift Server SDK-Paket importieren. Gehen Sie wie folgt vor, um das Beispiel hinzuzufügen und log4net zu konfigurieren:

Ausführlichere Anweisungen und Anleitungen zum Testen finden Sie im Download, der README sich im Plugin befindet.

Richten Sie eine GameLift Anywhere Amazon-Flotte zum Testen ein

Sie können Ihre Entwicklungs-Workstation als GameLift Anywhere Amazon-Hosting-Flotte einrichten, um Ihre GameLift Amazon-Integration iterativ zu testen. Mit dieser Konfiguration können Sie Spieleserverprozesse auf Ihrer Workstation starten, Spielerbeitritts- oder Matchmaking-Anfragen an Amazon senden, um Spielsitzungen GameLift zu starten, und Clients mit den neuen Spielsitzungen verbinden. Wenn Sie Ihre eigene Workstation als Hosting-Server einrichten, können Sie alle Aspekte Ihrer Spieleintegration mit Amazon GameLift überwachen.

Anweisungen zur Einrichtung Ihrer Workstation finden Sie unter Richten Sie lokale Tests mit Amazon ein GameLift Anywhere So führen Sie die folgenden Schritte durch:

Fügen Sie Ihrem Unity-Projekt GameLift Amazon-Servercode hinzu

Ihr Spieleserver kommuniziert mit dem GameLift Amazon-Service, um Anweisungen zu erhalten und den aktuellen Status zu melden. Um dies zu erreichen, fügen Sie Spieleservercode hinzu, der das GameLift Amazon-Server-SDK verwendet.

Das bereitgestellte Codebeispiel veranschaulicht die grundlegenden erforderlichen Integrationselemente. Es verwendet aMonoBehavior, um eine einfache Gameserver-Initialisierung mit Amazon GameLift zu veranschaulichen. Das Beispiel geht davon aus, dass der Spieleserver zum Testen auf einer GameLift Anywhere Amazon-Flotte läuft. Es beinhaltet Code für:

Der in diesem Thema vorgestellte Code stellt die Kommunikation mit dem GameLift Amazon-Service her und. Es implementiert auch eine Reihe von Rückruffunktionen, die auf Anfragen von antworten. Weitere Informationen zu den einzelnen Funktionen und zur Funktionsweise des Codes finden Sie unter Initialisieren des Serverprozesses. Weitere Informationen zu den in diesem Code verwendeten SDK-Aktionen und Datentypen finden Amazon GameLift Server-SDK-Referenz für C# Sie unter.

Dieses Beispiel zeigt, wie Sie alle erforderlichen Elemente hinzufügen, wie unter Amazon GameLift zu Ihrem Spieleserver hinzufügen beschrieben. Es beinhaltet:

Weitere Informationen zum Hinzufügen von GameLift Amazon-Funktionen finden Sie in den folgenden Themen:

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);  
        }
    }
}

Weitere Ressourcen

Verwenden Sie die folgenden Ressourcen, um Ihren Spieleserver zu testen und die Funktionalität zu erweitern: