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 seu servidor GameLift de jogos integrado à Amazon localmente. Você não precisa alterar o endpoint do servidor de jogos.

Na janela do prompt de comando local, as mensagens de registro indicam que seu servidor de jogo está conectado ao serviço Amazon GameLift Local. Isso significa que seu servidor de jogo inicializou com sucesso o Amazon GameLift Server SDK (comInitSDK()). Ele chamou ProcessReady() com os caminhos de log mostrados e, se for bem-sucedido, estará pronto para hospedar uma sessão de jogo. Enquanto o servidor do jogo está em execução, a Amazon GameLift registra cada relatório de status de saúde do servidor do jogo. 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 Amazon GameLift web service. 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 Local, as mensagens de registro indicam que o Amazon GameLift Local enviou um onStartGameSession retorno de chamada ao seu servidor de jogo. 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, a Amazon GameLift 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 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 seu servidor GameLift de jogos integrado à Amazon 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 seu cliente de jogo com o serviço Amazon GameLift Local, você deve fazer as seguintes alterações na configuração do seu cliente de jogo, conforme descrito emConfigure a Amazon GameLift em um serviço de back-end:

Na janela do prompt de comando local, depois de iniciar o cliente do jogo, as mensagens de registro devem indicar que ele inicializou o GameLiftClient e se comunicou com sucesso com o serviço da Amazon GameLift .

Teste chamadas de clientes de jogos para o GameLift serviço Amazon.

Verifique se o cliente do jogo está fazendo com sucesso uma ou todas as seguintes API chamadas:

Na janela do prompt de comando do Local, somente chamadas para CreateGameSession() resultam em mensagens de log. As mensagens de registro mostram quando o Amazon GameLift Local solicita que seu servidor de jogo inicie uma sessão de jogo (onStartGameSessionretorno de chamada) e obtém sucesso ActivateGameSession quando seu servidor de jogo a invoca. Na AWS CLI janela, todas as API chamadas 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 do jogo está reportando o status do jogo e do jogador ao GameLift serviço da Amazon.

Para GameLift que a Amazon gerencie a demanda dos jogadores e reporte corretamente as métricas, seu servidor de jogo deve reportar vários status à Amazon GameLift. 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.