Esegui la migrazione al GameLift server Amazon 5.x SDK - Amazon GameLift
Informazioni su Amazon GameLift server SDK 5Aggiorna il codice del gioco

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

I tuoi server di gioco ospitati utilizzano il GameLift server Amazon SDK per comunicare con il GameLift servizio Amazon per avviare e gestire le sessioni di gioco per i giocatori. L'ultima versione, Amazon GameLift server SDK 5, offre una serie di miglioramenti e supporto per le nuove GameLift funzionalità di Amazon. Se la versione del tuo server di gioco utilizza attualmente Amazon GameLift server SDK 4 o versioni precedenti, segui le indicazioni riportate in questo argomento per aggiornare i tuoi giochi.

Informazioni su Amazon GameLift server SDK 5

SDKLa versione 5.0.0 e successive del GameLift server Amazon include questi aggiornamenti:

  • Linguaggi espansi: le librerie sono disponibili nelle seguenti lingue: C++, C#, Go. Puoi creare le librerie C++ da utilizzare con Unreal Engine.

  • Supporto per i plug-in del motore di gioco: i plug-in GameLift autonomi di Amazon per Unreal Engine e Unity richiedono le librerie Amazon GameLift server SDK 5. Questi plugin offrono flussi di lavoro guidati per l'integrazione, il test e la distribuzione dei tuoi giochi su Amazon per l'hosting. GameLift Vedi e documentazione. Guida al GameLift plug-in Amazon per Unity per server SDK 5.x Integrazione di giochi con il GameLift plug-in Amazon per Unreal Engine

  • GameLift AnywhereSupporto Amazon: con Anywhere le flotte puoi configurare le tue risorse di hosting per utilizzare le GameLift funzionalità di Amazon (incluso matchmaking). Aggiungi Amazon GameLift Agent per automatizzare la gestione del ciclo di vita delle sessioni di gioco. Usa Anywhere le flotte per l'hosting di produzione con hardware locale o configura ambienti di test per uno sviluppo iterativo rapido di giochi. See Hosting Amazon GameLift Anywhere e l' GameLiftagente Amazon.

  • Strumenti di test aggiornati: la GameLift Anywhere funzionalità Amazon ti consente di configurare ambienti di test locali o basati sul cloud per i tuoi giochi. Imposta i test con o senza Amazon GameLift Agent. Questi strumenti sostituiscono Amazon GameLift Local. Per informazioni, consulta Configura test locali con Amazon GameLift Anywhere.

  • Consolidato. NETsoluzione per C#: il server SDK C# 5.1+ supporta. NETFramework 4.6.2 (aggiornato dalla versione 4.6.1) e. NET6.0 in un'unica soluzione. . NETLo standard 2.1 è disponibile con le librerie create da Unity.

  • Nuova Compute risorsa: questa nuova risorsa combina diversi tipi di risorse di hosting. Include risorse di hosting basate sul cloud (flotte gestite EC2 o container) e risorse di hosting controllate dal cliente (flotte). Anywhere Include i seguenti aggiornamenti:

    • APILe nuove chiamate per la Compute risorsa includono: ListCompute(), DescribeCompute() e GetComputeAccess(). Queste azioni restituiscono informazioni sulle risorse di hosting per qualsiasi tipo di GameLift flotta Amazon. In generale, per le flotte con server di gioco che utilizzano il server SDK 5.x, utilizza le azioni specifiche del computer per sostituire le azioni specifiche dell'istanza. Inoltre, queste azioni possono essere utilizzate nelle Anywhere flotte senza l' GameLift agente Amazon: RegisterCompute(), DeregisterCompute() e GetComputeAuthToken().

    • Nuova metrica ActiveCompute con CloudWatch dimensioni FleetIdLocation, e. ComputeType Questa metrica sostituisce la metrica precedente. ActiveInstances

  • Amazon EC2 Systems Manager (SSM) per l'accesso remoto: per una maggiore sicurezza, utilizzalo SSM al posto di SSH quando ti connetti a istanze nelle flotte GameLift gestite da Amazon. Per informazioni, consulta Connessione remota alle istanze GameLift della flotta Amazon.

Aggiorna il codice del gioco

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:

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

  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 Carica una build di server personalizzata su 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