Teste sua integração usando o Amazon GameLift Local

Inicie o Amazon GameLift Local.

Abra uma janela de prompt de comando, navegue até o diretório que contém o arquivo GameLiftLocal.jar e o execute. Por padrão, o Local escuta solicitações de clientes de jogos na porta 8080. Para especificar um número de porta diferente, use o parâmetro -p, conforme mostrado no seguinte exemplo:

java -jar GameLiftLocal.jar -p 9080

Após a inicialização do Local, você vê logs indicando que dois servidores locais foram iniciados, um escutando o servidor de jogos e um escutando o cliente do jogo ou a AWS CLI. Os logs continuam informando a atividade nos dois servidores locais, inclusive a comunicação com e de componentes do jogo.

Inicie o servidor de jogos.

Inicie o servidor de jogos integrado ao Amazon GameLift localmente. Você não precisa alterar o endpoint do servidor de jogos.

Na janela do prompt de comando do Local, as mensagens de log indicam que o servidor de jogos se conectou ao serviço do Amazon GameLift Local. Isso significa que o servidor de jogos inicializou com êxito o Server SDK do Amazon GameLift (com InitSDK()). Ele chamou ProcessReady() com os caminhos de log mostrados e, se for bem-sucedido, estará pronto para hospedar uma sessão de jogo. Embora o servidor de jogos esteja em execução, o Amazon GameLift registra em log o relatório de status da integridade do servidor de jogos. O seguinte exemplo do sistema de mensagens de log mostra um servidor de jogos integrado com êxito:

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

Entre as mensagens de erro e aviso em potencial estão as seguintes:

Inicie a AWS CLI.

Assim que o servidor de jogos chamar ProcessReady() com êxito, você poderá começar a fazer chamadas de cliente. Abra outra janela do prompt de comando e inicie a ferramenta AWS CLI. A AWS CLI, por padrão, usa o endpoint de web service do Amazon GameLift. Você deve substituí-lo pelo endpoint do Local em todas as solicitações usando o parâmetro --endpoint-url, conforme mostrado na solicitação de exemplo a seguir.

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

Na janela do prompt de comando da AWS CLI, os comandos AWS gamelift resultam em respostas conforme documentado em Referência de comando da AWS CLI.

Crie uma sessão de jogo.

Com a AWS CLI, envie uma solicitação CreateGameSession(). A solicitação deve seguir a sintaxe esperada. Para Local, o parâmetro FleetId pode ser definido como qualquer string válida (^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

Na janela do prompt de comando do Local, as mensagens de log indicam que o Amazon GameLift Local enviou para o servidor de jogos uma chamada de retorno onStartGameSession. Se uma sessão de jogo for criada com êxito, o servidor de jogos responderá invocando 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"

Na janela da AWS CLI, o Amazon GameLift responde com um objeto de sessão do jogo, incluindo um ID de sessão do jogo. O novo status da sessão do jogo é Ativação. O status mudará para Ativo assim que o servidor de jogos invocar ActivateGameSession. Se você quiser ver o status alterado, use a AWS CLI para chamar 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
    }
}

Inicie o Amazon GameLift Local.

Abra uma janela de prompt de comando, navegue até o diretório que contém o arquivo GameLiftLocal.jar e o execute. Por padrão, o Local escuta solicitações de clientes de jogos na porta 8080. Para especificar um número de porta diferente, use o parâmetro -p, conforme mostrado no seguinte exemplo.

./gamelift-local -p 9080

Após a inicialização do Local, você vê logs mostrando que dois servidores locais foram iniciados, um escutando o servidor de jogos e um escutando o cliente do jogo ou a AWS CLI.

Inicie o servidor de jogos.

Inicie o servidor de jogos integrado ao Amazon GameLift localmente. Consulte Testar um servidor de jogos para obter mais detalhes sobre logs de mensagens.

Configure o cliente do jogo do Local e o inicie.

Para usar o cliente do jogo com o serviço do Amazon GameLift Local, é necessário fazer as seguintes alterações na configuração do cliente do jogo, conforme descrito em Configure o Amazon GameLift em um serviço de back-end:

​Na janela do prompt de comando do Local, assim que você iniciar o cliente do jogo, as mensagens de log deverão indicar que ele inicializou o GameLiftClient e que se comunicou com êxito com o serviço do Amazon GameLift.

Teste as chamadas do cliente de jogo para o serviço do Amazon GameLift.

Verifique se o cliente do jogo foi bem-sucedido fazendo qualquer uma ou todas as seguintes chamadas à API:

Na janela do prompt de comando do Local, somente chamadas para CreateGameSession() resultam em mensagens de log. Mensagens de log mostram quando o Amazon GameLift Local solicita que o servidor de jogos inicie uma sessão do jogo ( retorno de chamada onStartGameSession) e recebe um ActivateGameSession bem-sucedido quando o servidor de jogos o invoca. Na janela da AWS CLI, todas as chamadas à API resultam em respostas ou mensagens de erro conforme documentado.

Verifique se o servidor de jogos está validando novas conexões de jogador.

Depois de criar uma sessão de jogo e uma sessão de jogador, estabeleça uma conexão direta com a sessão do jogo.

Na janela do prompt de comando do Local, as mensagens de log devem mostrar que o servidor de jogos enviou uma solicitação AcceptPlayerSession() para validar a nova conexão do jogador. Se você usar a AWS CLI para chamar DescribePlayerSessions(), o status da sessão do jogador deverá mudar de Reservado para Ativo.

Verifique se o servidor de jogos está informando o status do jogo e do jogador para o serviço do Amazon GameLift.

Para que o Amazon GameLift gerencie a demanda do jogador e informe corretamente as métricas, o servidor de jogos deve informar diversos status ao Amazon GameLift. Verifique se o Local está registrando em log eventos relacionados às ações a seguir. Também convém usar a AWS CLI para rastrear alterações feitas no status.