Teste sua integração usando o Amazon GameLift Servers Local

Inicie o Amazon GameLift Servers 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 Servers 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 Servers Local. Isso significa que seu servidor de jogo inicializou com sucesso o SDK do servidor para Amazon GameLift Servers (comInitSDK()). 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 Servers 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 AWS CLI o.

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 . AWS CLI Por padrão, usa o endpoint do serviço Amazon GameLift Servers web. 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 AWS CLI comando, AWS gamelift os comandos resultam em respostas conforme documentado na Referência de AWS CLI Comandos.

Crie uma sessão de jogo.

Com o 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 Servers 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 AWS CLI janela, Amazon GameLift Servers responde com um objeto de sessão de jogo, incluindo um ID de sessão de jogo. O novo status da sessão do jogo é Ativação. O status muda para Ativo quando o servidor do jogo é ActivateGameSession invocado. Se você quiser ver o status alterado, use o AWS CLI para ligarDescribeGameSessions().

{
    "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 Servers 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 Servers 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 Servers Local, é necessário fazer as seguintes alterações na configuração do cliente do jogo, conforme descrito em Configurar Amazon GameLift Servers 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 GameLiftClient e que se comunicou com êxito com o serviço do Amazon GameLift Servers.

O cliente do jogo teste chama o serviço do Amazon GameLift Servers.

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 Servers Local solicita que o servidor de jogos inicie uma sessão do jogo (onStartGameSession retorno de chamada) 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 chamada AWS CLI paraDescribePlayerSessions(), 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 Servers.

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