View a markdown version of this page

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

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 server SDK 5.x per Server Amazon GameLift

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

Nota

Se devi continuare a utilizzare il server SDK versione 4.x o precedente, consulta la documentazione e le informazioni Server SDK per Server Amazon GameLift versione 4 e precedenti per il download. Per la versione SDK 4.0.2 in particolare, puoi scaricarla dalle versioni ufficiali. GitHub

  1. Scarica il Amazon GameLift Servers pacchetto SDK per server più recente per il tuo ambiente di sviluppo [Sito di download]. Segui le istruzioni di installazione nel Readme file relativo al pacchetto e alla versione scaricati. Consulta queste istruzioni per utilizzare gli SDK del server 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 base alle esigenze:

      • Se intendi utilizzare la build del server di gioco su una flotta EC2 Amazon GameLift Servers gestita o su una flotta Anywhere con l'Agent: Amazon GameLift Servers

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

      • Se prevedi di distribuire la build del server di gioco su 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 la nuova azione SDK del server GetFleetRoleCredentials() (per i server di gioco) o usa credenziali condivise (per altre applicazioni). Per ulteriori informazioni su come implementare questa modifica, consulta. Collega il tuo GameLift Server Amazon server di gioco ospitato su altro AWS risorse

  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). GetComputeCertificate()

  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 (attualmente il valore predefinito è 4.0.2). Questo parametro deve corrispondere alle effettive librerie SDK del server 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. Consulta Crea un server di gioco costruito per GameLift Server Amazon.

    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. Connettiti alle istanze della flotta