Testen Sie Ihre Integration mit Amazon GameLift Local

Starten Sie Amazon GameLift Local.

Öffnen Sie ein Befehlszeilenfenster, navigieren Sie zu dem Verzeichnis mit der Datei GameLiftLocal.jar und führen Sie sie aus. Standardmäßig horcht Local auf Port 8080 auf Anforderungen von Spielclients. Wenn Sie eine andere Portnummer angeben möchten, verwenden Sie den Parameter -p. Beispiel:

java -jar GameLiftLocal.jar -p 9080

Wenn Local startet, sehen Sie Protokolle, die angeben, dass zwei lokale Server gestartet wurden, einer, der auf Ihren Spiel-Server horcht und ein zweiter, der auf Aufrufe seitens des Spielclients oder über die AWS CLI wartet. Die beiden Protokolle berichten fortlaufend weiter über die Aktivitäten auf den beiden lokalen Servern, einschließlich der Kommunikation mit Ihren Spielkomponenten.

Starten Sie Ihren Spiel-Server.

Starte deinen in Amazon GameLift integrierten Gameserver lokal. Sie brauchen dabei nicht den Endpunkts für den Spiel-Server zu ändern.

Im lokalen Befehlszeilenfenster geben Protokollmeldungen an, dass Ihr Spieleserver eine Verbindung zum Amazon GameLift Local-Service hergestellt hat. Das bedeutet, dass Ihr Gameserver das Amazon GameLift Server SDK (mitInitSDK()) erfolgreich initialisiert hat. Das SDK hat ProcessReady() mit den angezeigten Protokollpfaden aufgerufen und ist nun im Erfolgsfall bereit, eine Spielsitzung zu hosten. Während der Spieleserver läuft, GameLift protokolliert Amazon jeden Gesundheitsstatusbericht vom Spieleserver. Das folgende Beispiel zu Protokollierungsmeldungen zeigt einen erfolgreich integrierten Spiel-Server:

16:50:53,217  INFO || - [SDKListenerImpl] nioEventLoopGroup-3-1 - SDK connected: /127.0.0.1:64247 
16:50:53,217  INFO || - [SDKListenerImpl] nioEventLoopGroup-3-1 - SDK pid is 17040, sdkVersion is 3.1.5 and sdkLanguage is CSharp
16:50:53,217  INFO || - [SDKListenerImpl] nioEventLoopGroup-3-1 - NOTE: Only SDK versions 3.1.5 and above are supported in GameLiftLocal!
16:50:53,451  INFO || - [SDKListenerImpl] nioEventLoopGroup-3-1 - onProcessReady received from: /127.0.0.1:64247 and ackRequest requested? true
16:50:53,543  INFO || - [SDKListenerImpl] nioEventLoopGroup-3-1 - onProcessReady data: logPathsToUpload: "C:\\game\\logs"
logPathsToUpload: "C:\\game\\error"
port: 1935
        
16:50:53,544  INFO || - [HostProcessManager] nioEventLoopGroup-3-1 - Registered new process true, true,
16:50:53,558  INFO || - [SDKListenerImpl] nioEventLoopGroup-3-1 - onReportHealth received from /127.0.0.1:64247 with health status: healthy

Es können u. a. die Fehler- und Warnmeldungen angezeigt werden:

Starten Sie die AWS CLI.

Sobald Ihr Spiel-Server erfolgreich ProcessReady() ruft, können Sie die Clientaufrufe absetzen. Öffnen Sie ein Befehlszeilenfenster und starten Sie das AWS CLI-Tool. Der verwendet AWS CLI standardmäßig den Amazon GameLift Web Service-Endpunkt. Sie müssen diesen Endpunkt in allen Anfragen mit dem Parameter --endpoint-url mit dem lokalen Endpunkt überschreiben, wie im folgenden Beispiel dargestellt.

AWS gamelift describe-game-sessions --endpoint-url http://localhost:9080  --fleet-id fleet-123

Im AWS CLI Befehlszeilenfenster führen AWS gamelift Befehle zu Antworten, wie in der AWS CLIBefehlsreferenz dokumentiert.

Erstellen Sie eine Spielsitzung.

Reichen Sie mit dem AWS CLI eine CreateGameSession() Anfrage ein. Die Anforderung sollte der erwarteten Syntax entsprechen. Bei Local kann der FleetId-Parameter auf eine beliebige Zeichenfolge eingestellt sein (^fleet-\S+).

AWS gamelift create-game-session --endpoint-url http://localhost:9080 --maximum-player-session-count 2 --fleet-id
    fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d

Im lokalen Befehlszeilenfenster geben Protokollmeldungen an, dass Amazon GameLift Local Ihrem Gameserver einen onStartGameSession Rückruf gesendet hat. Wenn eine Spielsitzung erfolgreich erstellt wurde, antwortet Ihr Spiel-Server durch einen Aufruf von ActivateGameSession.

13:57:36,129  INFO || - [SDKInvokerImpl]
        Thread-2 - Finished sending event to game server to start a game session:
        arn:aws:gamelift:local::gamesession/fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d/gsess-ab423a4b-b827-4765-aea2-54b3fa0818b6.
        Waiting for ack response.13:57:36,143  INFO || - [SDKInvokerImpl]
        Thread-2 - Received ack response: true13:57:36,144  INFO || -
        [CreateGameSessionDispatcher] Thread-2 - GameSession with id:
        arn:aws:gamelift:local::gamesession/fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d/gsess-ab423a4b-b827-4765-aea2-54b3fa0818b6
        created13:57:36,227  INFO || - [SDKListenerImpl]
        nioEventLoopGroup-3-1 - onGameSessionActivate received from: /127.0.0.1:60020 and ackRequest
        requested? true13:57:36,230  INFO || - [SDKListenerImpl]
        nioEventLoopGroup-3-1 - onGameSessionActivate data: gameSessionId:
        "arn:aws:gamelift:local::gamesession/fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d/gsess-abcdef12-3456-7890-abcd-ef1234567890"

In dem AWS CLI Fenster GameLift antwortet Amazon mit einem Spielsitzungsobjekt, das eine Spielsitzungs-ID enthält. Beachten Sie, dass der Status der neuen Spielsitzung „Activating“ lautet. Der Status ändert sich zu Aktiv, sobald dein Gameserver aufgerufen wird. ActivateGameSession Wenn Sie sich bezüglich der Statusänderung vergewissern möchten, starten Sie über die AWS CLI den Aufruf DescribeGameSessions().

{
    "GameSession": {
      "Status": "ACTIVATING",
      "MaximumPlayerSessionCount": 2,
      "FleetId": "fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      "GameSessionId": "arn:aws:gamelift:local::gamesession/fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d/gsess-abcdef12-3456-7890-abcd-ef1234567890",
      "IpAddress": "127.0.0.1",
      "Port": 1935
    }
}

Starten Sie Amazon GameLift Local.

Öffnen Sie ein Befehlszeilenfenster, navigieren Sie zu dem Verzeichnis mit der Datei GameLiftLocal.jar und führen Sie sie aus. Standardmäßig horcht Local auf Port 8080 auf Anforderungen von Spielclients. Wenn Sie eine andere Portnummer angeben möchten, verwenden Sie den Parameter -p. Beispiel:

./gamelift-local -p 9080

Wenn Local startet, sehen Sie Protokolle, die angeben, dass zwei lokale Server gestartet wurden, einer, der auf Ihren Spiel-Server horcht und ein zweiter, der auf Aufrufe seitens des Spielclients oder über die AWS CLI wartet.

Starten Sie Ihren Spiel-Server.

Starte deinen in Amazon GameLift integrierten Gameserver lokal. Weitere Informationen zu Meldungsprotokollen finden Sie unter Teste einen Gameserver.

Konfigurieren Sie Ihren Spieleclient für Local und starten Sie ihn.

Um deinen Spielclient mit dem Amazon GameLift Local Service zu verwenden, musst du die folgenden Änderungen an der Einrichtung deines Spielclients vornehmen, wie unter beschriebenAmazon GameLift auf einem Backend-Service einrichten:

Sobald du den Spielclient startest, sollten im lokalen Befehlszeilenfenster Logmeldungen darauf hinweisen, dass der Spielclient initialisiert wurde GameLiftClient und erfolgreich mit dem GameLift Amazon-Dienst kommuniziert wurde.

Test-Game-Client-Aufrufe an den GameLift Amazon-Dienst.

Überprüfen Sie, ob Ihr Spieleclient erfolgreich einige oder alle der folgenden API-Aufrufe ausführen kann:

In dem Local-Befehlszeilenfenster werden nur Aufrufe an CreateGameSession() mit entsprechenden Meldungen protokolliert. Logmeldungen zeigen, wenn Amazon GameLift Local Ihren Gameserver auffordert, eine Spielesitzung zu starten (onStartGameSessionCallback), und ActivateGameSession wenn Ihr Gameserver sie aufruft, eine erfolgreiche Meldung erhält. In dem AWS CLI-Fenster führen alle API-Aufrufe entweder zu Antworten oder zu Fehlermeldungen, wie dokumentiert.

Überprüfen Sie, ob Ihr Spiel-Server die Verbindungen neuer Spieler validiert.

Stellen Sie nach dem Erstellen einer Spielsitzung und einer Spielersitzung eine direkte Verbindung zu der Spielsitzung her.

In dem Befehlszeilenfenster von Local sollten Meldungen darauf hinweisen, dass der Spiel-Server eine AcceptPlayerSession()-Anfrage gesendet hat, um die neue Spielerverbindung zu überprüfen. Wenn Sie über die AWS CLI DescribePlayerSessions() aufrufen, sollte sich der Status der Spielersitzung von „Reserved“ in „Active“ ändern.

Stellen Sie sicher, dass Ihr Gameserver den Spiel- und Spielerstatus an den GameLift Amazon-Dienst meldet.

Damit Amazon GameLift die Spielernachfrage verwalten und Messwerte korrekt melden kann, muss Ihr Gameserver verschiedene Statusmeldungen an Amazon GameLift zurückmelden. Überprüfen Sie, ob Local Ereignisse zu den folgenden Aktionen protokolliert. Sie können die Statusänderungen auch über die AWS CLI nachverfolgen.