View a markdown version of this page

Migrieren Sie zum Server-SDK 5.x für Amazon-Server GameLift - GameLift Amazon-Server

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 zum Server-SDK 5.x für Amazon-Server GameLift

Um ein Spielprojekt für die Verwendung der Server-SDK-Version 5.x zu aktualisieren, nehmen Sie die folgenden Änderungen vor:

Anmerkung

Wenn Sie das Server-SDK Version 4.x oder früher weiterhin verwenden müssen, finden Sie unter Dokumentation und Informationen Server-SDK für GameLift Amazon-Server Version 4 und früher zum Herunterladen. Speziell für die SDK-Version 4.0.2 können Sie sie aus den offiziellen GitHub Versionen herunterladen.

  1. Holen Sie sich das neueste Server-SDK für Amazon GameLift Servers das Paket für Ihre Entwicklungsumgebung [Download-Seite]. Folgen Sie den Installationsanweisungen in der Readme Datei für Ihr heruntergeladenes Paket und Ihre Version. Lesen Sie diese Anweisungen zur Verwendung der Server-SDKs mit Ihrem Spielprojekt.

  2. Aktualisieren Sie Ihren Servercode wie folgt:

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

    • Aktualisieren Sie die InitSDK() Eingaben nach Bedarf:

      • Wenn Sie planen, den Spieleserver-Build entweder auf einer Amazon GameLift Servers verwalteten EC2-Flotte oder einer Anywhere-Flotte mit dem Amazon GameLift Servers Agenten bereitzustellen:

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

      • Wenn Sie vorhaben, den Spieleserver-Build ohne den Amazon GameLift Servers Agenten auf einer Anywhere-Flotte bereitzustellen, gehen Sie wie folgt vor:

        Aufruf InitSDK() mit Serverparametern (C++) (C#) (Unreal). Ein Gameserverprozess verwendet diese Parameter, um eine Verbindung mit dem Amazon GameLift Servers Dienst herzustellen.

  3. Wenn Ihr Spieleserver-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 Server-SDK-Aktion GetFleetRoleCredentials() (für Spieleserver) oder verwenden Sie gemeinsam genutzte Anmeldeinformationen (für andere Anwendungen). Weitere Informationen zur Implementierung dieser Änderung finden Sie unterVerbinde deine GameLift Amazon-Server gehosteter Spieleserver auf anderen AWS Ressourcen.

  4. Wenn Ihr Projekt die Server-SDK-Aktion 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 du deinen Spiel-Build hochlädst Amazon GameLift Servers (z. B. mit upload-build oder CreateBuild ()), setze den ServerSdkVersion Parameter auf die 5.x-Version, die du verwendest (dieser Parameter ist derzeit standardmäßig 4.0.2). Dieser Parameter muss mit den tatsächlichen Server-SDK-Bibliotheken im Spieleserver-Build übereinstimmen. Wenn du die falsche Version für einen hochgeladenen Spieleserver-Build angibst, schlagen alle Flotten, die du mit diesem Build erstellst, fehl. Siehe Erstelle einen Gameserver-Build für GameLift Amazon-Server.

    Das folgende Beispiel veranschaulicht, wie die Server-SDK-Version 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 beschriebenMit Flotteninstanzen verbinden.