Esegui la migrazione al GameLift server Amazon 5.x SDK - Amazon GameLift

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à.

Esegui la migrazione al GameLift server Amazon 5.x SDK

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

  1. Ottieni il SDK pacchetto Amazon GameLift Server più recente 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 prevedi di distribuire il server di gioco, installalo su una EC2 flotta GameLift gestita da Amazon o su un Anywhere flotta con Amazon GameLift Agent:

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

      • Se prevedi di distribuire il server di gioco, crea un Anywhere flotta senza l' GameLift agente Amazon:

        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 GameLift servizio Amazon.

  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 Amazon GameLift server SDK action GetFleetRoleCredentials() (per server di gioco) o usa credenziali condivise (per altre applicazioni). Per ulteriori informazioni su come implementare questa modifica, consultaComunica con altre AWS risorse delle tue flotte.

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

  5. Quando carichi la build del tuo gioco su Amazon GameLift (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 di server effettive nella build del server SDK di gioco. Se specifichi la versione sbagliata per una build del server di gioco caricata, tutte le flotte create con quella build falliranno. Per informazioni, consulta Implementa una build di server personalizzata per l'hosting Amazon GameLift.

    L'esempio seguente illustra come specificare la versione del serverSDK: 

    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 alle istanze GameLift della flotta Amazon