Migrazione al server SDK 5.x per Amazon GameLift Servers - Amazon GameLift Servers

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Migrazione al server SDK 5.x per Amazon GameLift Servers

Per aggiornare un progetto di gioco per utilizzare la versione 5.x del server SDK, apporta le seguenti modifiche:

  1. Scarica l'SDK del server più recente per il Amazon GameLift Servers pacchetto per il tuo ambiente di sviluppo [Scarica il sito]. Segui le istruzioni di installazione contenute nel Readme file per il pacchetto e la versione scaricati. Consulta queste istruzioni per utilizzare il server SDKs con il tuo progetto di gioco.

  2. Aggiorna il codice del server come segue:

    • Cambia la funzione di callback del codice server onCreateGameSession() inonStartGameSession().

    • Aggiorna gli InitSDK() input in modo appropriato:

      • Se hai intenzione di distribuire il server di gioco, costruisci una EC2 flotta Amazon GameLift Servers gestita o una flotta Anywhere con l'Amazon GameLift Serversagente:

        Chiama InitSDK() senza parametri (C++) (C#) (Unreal). Questa chiamata configura l'ambiente di calcolo e una WebSocket connessione al servizio. Amazon GameLift Servers

      • Se hai intenzione di utilizzare il server di gioco, crea una flotta Anywhere senza l'Amazon GameLift Serversagente:

        Chiama InitSDK() con i parametri del server (C++) (C#) (Unreal). Un processo del server di gioco utilizza questi parametri per stabilire una connessione con il servizio. Amazon GameLift Servers

  3. Se la build del server di gioco o altre applicazioni ospitate comunicano con altre AWS risorse durante l'esecuzione, dovrai modificare il modo in cui l'applicazione accede a tali risorse. Sostituisci l'uso di AssumeRoleCredentials con il nuovo server SDK action GetFleetRoleCredentials() (per i server di gioco) o usa credenziali condivise (per altre applicazioni). Per ulteriori informazioni su come implementare questa modifica, consulta. Comunica con altre AWS risorse delle tue flotte

  4. Se il progetto ha chiamato l'azione SDK del server GetInstanceCertificate() per recuperare un certificato TLS, modifica il codice per utilizzare invece il nuovo GetComputeCertificate() (C++) (C#) (Unreal).

  5. Quando carichi la build del gioco su Amazon GameLift Servers (ad esempio con upload-build o CreateBuild()), imposta il ServerSdkVersion parametro sulla versione 5.x che stai utilizzando (questo parametro attualmente è predefinito su 4.0.2). Questo parametro deve corrispondere alle librerie SDK del server effettive nella build del server di gioco. Se specifichi la versione sbagliata per una build del server di gioco caricata, tutte le flotte create con quella build falliranno. Consultare Implementa una build di server personalizzata per Amazon GameLift Servers hosting.

    L'esempio seguente illustra come specificare la versione SDK del server: 

    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. Se utilizzi script per connetterti in remoto a flotte gestite, aggiorna gli script per utilizzare il nuovo processo, come descritto in. Connessione remota a Amazon GameLift Servers flotte di istanze