Testa la tua integrazione usando Amazon GameLift Servers Local

Avviare Amazon GameLift Servers Local.

Aprire una finestra del prompt dei comandi, accedere alla directory contente il file GameLiftLocal.jar ed eseguire il file. Per impostazione predefinita, Local riceve le richieste provenienti dai client di gioco sulla porta 8080. Per specificare un numero di porta diverso, utilizzare il parametro -p, come indicato nell'esempio seguente:

java -jar GameLiftLocal.jar -p 9080

Una volta avviato Local, è possibile visualizzare i log che indicano che sono stati avviati due server locali, di cui uno rileva il server di gioco e l'altro il client di gioco o la AWS CLI. I log continuano a fornire rapporti sull'attività dei due server locali, comprese le comunicazioni da e verso i componenti di gioco.

Avviare il server di gioco.

Avviare il server di gioco integrato con Amazon GameLift Servers a livello locale. Non è necessario modificare l'endpoint per il server di gioco.

Nella finestra del prompt dei comandi di Local, i messaggi di log indicano che il server di gioco è connesso al servizio Amazon GameLift Servers Local. Ciò significa che il server di gioco ha inizializzato con successo l'SDK del server per (con). Amazon GameLift Servers InitSDK() Ha chiamato ProcessReady() con i percorsi di log mostrati e, in caso di esito positivo, è pronto per l'hosting di una sessione di gioco. Mentre il server di gioco è in esecuzione, Amazon GameLift Servers registra ogni rapporto sullo stato di integrità del server di gioco. Il seguente esempio di messaggistica di log mostra un server di gioco integrato:

16:50:53,217  INFO || - [SDKListenerImpl] nioEventLoopGroup-3-1 - SDK connected: /127.0.0.1:64247 
16:50:53,217  INFO || - [SDKListenerImpl] nioEventLoopGroup-3-1 - SDK pid is 17040, sdkVersion is 3.1.5 and sdkLanguage is CSharp
16:50:53,217  INFO || - [SDKListenerImpl] nioEventLoopGroup-3-1 - NOTE: Only SDK versions 3.1.5 and above are supported in GameLiftLocal!
16:50:53,451  INFO || - [SDKListenerImpl] nioEventLoopGroup-3-1 - onProcessReady received from: /127.0.0.1:64247 and ackRequest requested? true
16:50:53,543  INFO || - [SDKListenerImpl] nioEventLoopGroup-3-1 - onProcessReady data: logPathsToUpload: "C:\\game\\logs"
logPathsToUpload: "C:\\game\\error"
port: 1935
        
16:50:53,544  INFO || - [HostProcessManager] nioEventLoopGroup-3-1 - Registered new process true, true,
16:50:53,558  INFO || - [SDKListenerImpl] nioEventLoopGroup-3-1 - onReportHealth received from /127.0.0.1:64247 with health status: healthy

Potenziali messaggi di errore e avviso sono i seguenti:

Avvia il. AWS CLI

Una volta che il server di gioco ha completato la chiamata a ProcessReady(), è possibile iniziare a effettuare chiamate client. Aprire un'altra finestra del prompt dei comandi e avviare lo strumento AWS CLI . Per impostazione AWS CLI predefinita, utilizza l'endpoint del servizio Amazon GameLift Servers Web. È necessario sostituirlo con l'endpoint di Local in ogni richiesta con il parametro --endpoint-url, come illustrato nella seguente richiesta di esempio.

AWS gamelift describe-game-sessions --endpoint-url http://localhost:9080  --fleet-id fleet-123

Nella finestra del AWS CLI prompt dei AWS gamelift comandi, i comandi generano risposte come documentato nel Command Reference.AWS CLI

Creare una sessione di gioco.

Con AWS CLI, invia una richiesta CreateGameSession(). La richiesta deve seguire la sintassi prevista. Per Local, il parametro FleetId può essere impostato su qualsiasi stringa valida (^fleet-\S+).

AWS gamelift create-game-session --endpoint-url http://localhost:9080 --maximum-player-session-count 2 --fleet-id
    fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d

Nella finestra del prompt dei comandi di Local, i messaggi di log indicano che Amazon GameLift Servers Local ha inviato al server di gioco un callback onStartGameSession. Se una sessione di gioco è creata, il server di gioco risponde richiamando ActivateGameSession.

13:57:36,129  INFO || - [SDKInvokerImpl]
        Thread-2 - Finished sending event to game server to start a game session:
        arn:aws:gamelift:local::gamesession/fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d/gsess-ab423a4b-b827-4765-aea2-54b3fa0818b6.
        Waiting for ack response.13:57:36,143  INFO || - [SDKInvokerImpl]
        Thread-2 - Received ack response: true13:57:36,144  INFO || -
        [CreateGameSessionDispatcher] Thread-2 - GameSession with id:
        arn:aws:gamelift:local::gamesession/fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d/gsess-ab423a4b-b827-4765-aea2-54b3fa0818b6
        created13:57:36,227  INFO || - [SDKListenerImpl]
        nioEventLoopGroup-3-1 - onGameSessionActivate received from: /127.0.0.1:60020 and ackRequest
        requested? true13:57:36,230  INFO || - [SDKListenerImpl]
        nioEventLoopGroup-3-1 - onGameSessionActivate data: gameSessionId:
        "arn:aws:gamelift:local::gamesession/fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d/gsess-abcdef12-3456-7890-abcd-ef1234567890"

Nella AWS CLI finestra, Amazon GameLift Servers risponde con un oggetto della sessione di gioco che include un ID della sessione di gioco. Si noti che lo stato della nuova sessione di gioco è Activating (In fase di attivazione). Lo stato diventa Attivo una volta ActivateGameSession richiamato il server di gioco. Se vuoi vedere lo stato modificato, usa il comando AWS CLI per chiamare. DescribeGameSessions()

{
    "GameSession": {
      "Status": "ACTIVATING",
      "MaximumPlayerSessionCount": 2,
      "FleetId": "fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      "GameSessionId": "arn:aws:gamelift:local::gamesession/fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d/gsess-abcdef12-3456-7890-abcd-ef1234567890",
      "IpAddress": "127.0.0.1",
      "Port": 1935
    }
}

Avviare Amazon GameLift Servers Local.

Aprire una finestra del prompt dei comandi, accedere alla directory contente il file GameLiftLocal.jar ed eseguire il file. Per impostazione predefinita, Local riceve le richieste provenienti dai client di gioco sulla porta 8080. Per specificare un numero di porta diverso, utilizzare il parametro -p, come indicato nell'esempio seguente.

./gamelift-local -p 9080

Una volta avviato Local, è possibile visualizzare i log che indicano che sono stati avviati due server locali, di cui uno rileva il server di gioco e l'altro il client di gioco o la AWS CLI.

Avviare il server di gioco.

Avviare il server di gioco integrato con Amazon GameLift Servers a livello locale. Per ulteriori informazioni sui log dei messaggi, consultare Prova un server di gioco.

Configurare il client di gioco per Local e avviarlo.

Per utilizzare il client di gioco con il servizio Amazon GameLift Servers Local, occorre apportare le seguenti modifiche alla configurazione del client di gioco, come descritto nella sezione Configura Amazon GameLift Servers su un servizio di backend:

Nella finestra del prompt dei comandi di Local, una volta avviato il client di gioco, i messaggi di log dovrebbero indicare che ha inizializzato GameLiftClient e ha comunicato con il servizio Amazon GameLift Servers.

Eseguire il test delle chiamate del client di gioco al servizio Amazon GameLift Servers.

Verificare che il client di gioco esegua una o tutte le seguenti chiamate API:

Nella finestra del prompt dei comandi di Local, solo le chiamate a CreateGameSession() determinano messaggi di log. I messaggi di log mostrano quando Amazon GameLift Servers Local richiede al server di gioco di avviare una sessione di gioco (callback onStartGameSession) e ottiene una ActivateGameSession riuscita quando il server di gioco la richiama. Nella finestra della AWS CLI , tutte le chiamate API determinano risposte o messaggi di errore come documentato.

Verificare che il server di gioco convalidi le nuove connessioni dei giocatori.

Dopo aver creato una sessione di gioco e una sessione giocatore, stabilire una connessione diretta alla sessione di gioco.

Nella finestra del prompt dei comandi di Local, i messaggi di log devono mostrare che il server di gioco ha inviato una richiesta AcceptPlayerSession() per convalidare la nuova connessione dei giocatori. Se usi il comando AWS CLI to callDescribePlayerSessions(), lo stato della sessione del giocatore dovrebbe cambiare da Riservato ad Attivo.

Verificare che il server di gioco riporti lo stato del gioco e dei giocatori al servizio Amazon GameLift Servers.

Perché Amazon GameLift Servers gestisca la richiesta dei giocatori e riporti correttamente i parametri, il server di gioco deve segnalare diversi stati ad Amazon GameLift Servers. Verificare che Local registri gli eventi correlati alle operazioni seguenti. Potresti anche voler utilizzare il per AWS CLI tenere traccia delle modifiche allo stato.