Migrieren Sie zu Amazon GameLift Server SDK 5.x - Amazon GameLift

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.

Migrieren Sie zu Amazon GameLift Server SDK 5.x

Um ein Spielprojekt auf SDK Serverversion 5.x zu aktualisieren, nimm die folgenden Änderungen vor:

  1. Holen Sie sich das neueste Amazon GameLift SDK Server-Paket für Ihre Entwicklungsumgebung [Download-Seite]. Folgen Sie den Installationsanweisungen in der Readme Datei für Ihr heruntergeladenes Paket und Ihre heruntergeladene Version. In dieser Anleitung erfährst du, wie du den Server SDKs mit deinem Spielprojekt verwendest.

  2. Aktualisieren Sie Ihren Servercode wie folgt:

    • Ändern Sie die Servercode-Callback-Funktion onCreateGameSession() aufonStartGameSession().

    • Aktualisieren Sie die InitSDK() Eingaben nach Bedarf:

      • Wenn du vorhast, den Spieleserver-Build entweder auf einer von Amazon GameLift verwalteten EC2 Flotte oder auf Anywhere Flotte mit dem GameLift Amazon-Agenten:

        Aufruf InitSDK() ohne Parameter (C++) (C#) (Unreal). Dieser Aufruf richtet die Rechenumgebung und eine WebSocket Verbindung zum GameLift Amazon-Service ein.

      • Wenn Sie planen, den Spieleserver-Build auf einem zu implementieren Anywhere Flotte ohne den GameLift Amazon-Agenten:

        Aufruf InitSDK() mit Serverparametern (C++) (C#) (Unreal). Ein Gameserver-Prozess verwendet diese Parameter, um eine Verbindung mit dem GameLift Amazon-Service herzustellen.

  3. Wenn Ihr Gameserver-Build oder andere gehostete Anwendungen während der Ausführung mit anderen AWS Ressourcen kommunizieren, müssen Sie ändern, wie die Anwendung auf diese Ressourcen zugreift. Ersetzen Sie die Verwendung von AssumeRoleCredentials durch die neue GameLift SDK Amazon-Serveraktion GetFleetRoleCredentials() (für Spieleserver) oder verwenden Sie gemeinsame Anmeldeinformationen (für andere Anwendungen). Weitere Informationen zur Implementierung dieser Änderung finden Sie unterKommunizieren Sie mit anderen AWS Ressourcen aus Ihren Flotten.

  4. Wenn Ihr Projekt die SDK Serveraktion GetInstanceCertificate() zum Abrufen eines TLS Zertifikats aufgerufen hat, ändern Sie Ihren Code so, dass er stattdessen das neue GetComputeCertificate() (C++) (C#) (Unreal) verwendet.

  5. Wenn Sie Ihren Spiel-Build auf Amazon hochladen GameLift (z. B. mit upload-build oder CreateBuild()), setzen Sie den ServerSdkVersion Parameter auf die 5.x-Version, die Sie verwenden (dieser Parameter ist derzeit standardmäßig auf 4.0.2 voreingestellt). Dieser Parameter muss mit den tatsächlichen SDK Serverbibliotheken im Spielserver-Build übereinstimmen. Wenn Sie die falsche Version für einen hochgeladenen Spielserver-Build angeben, schlagen alle Flotten fehl, die Sie mit diesem Build erstellen. Siehe Stellen Sie einen benutzerdefinierten Server-Build für GameLift Amazon-Hosting bereit.

    Das folgende Beispiel zeigt, wie die SDK Serverversion angegeben wird: 

    aws gamelift upload-build \
    --operating-system AMAZON_LINUX_2023 \
    --server-sdk-version "5.0.0" \
    --build-root "~/mygame" \
    --name "My Game Nightly Build" \
    --build-version "build 255" \
    --region us-west-2

  6. Wenn Sie Skripts verwenden, um eine Remoteverbindung zu verwalteten Flotten herzustellen, aktualisieren Sie die Skripts so, dass sie den neuen Prozess verwenden, wie unter beschriebenStellen Sie eine Remoteverbindung zu GameLift Amazon-Flotteninstanzen her.