Teste sua integração usando o Amazon GameLift Local - Amazon GameLift
Configurar a Amazon GameLift localmenteTestar um servidor de jogosTestar um servidor e um cliente de jogoVariações com o local

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Teste sua integração usando o Amazon GameLift Local

nota

Este tópico aborda os testes de jogos que estão integrados somente com o GameLift servidor Amazon SDK versão 4.x ou anterior. Seu SDK pacote de servidor inclui uma versão compatível do Amazon GameLift Local. Se você estiver usando a SDK versão 5.x do servidor, consulte Configure testes locais com a Amazon GameLift Anywhere os testes locais com um Amazon GameLift Anywhere frota.

Use o Amazon GameLift Local para executar uma versão limitada do GameLift serviço gerenciado da Amazon em um dispositivo local e testar sua integração de jogos com ele. Esta ferramenta é útil ao fazer o desenvolvimento iterativo na integração do jogo. A alternativa — enviar cada nova versão para a Amazon GameLift e configurar uma frota para hospedar seu jogo — pode levar várias ou mais de cada vez.

Com o Amazon GameLift Local, você pode verificar o seguinte:

  • Seu servidor de jogo está corretamente integrado ao servidor SDK e está se comunicando adequadamente com o GameLift serviço da Amazon para iniciar novas sessões de jogo, aceitar novos jogadores e relatar saúde e status.

  • Seu cliente de jogo está corretamente integrado ao AWS SDK for Amazon GameLift e é capaz de recuperar informações sobre sessões de jogo existentes, iniciar novas sessões de jogo, juntar jogadores aos jogos e conectar-se à sessão do jogo.

O Amazon GameLift Local é uma ferramenta de linha de comando que inicia uma versão independente do serviço gerenciado da Amazon. GameLift O Amazon GameLift Local também fornece um registro de eventos em execução da inicialização do processo do servidor, verificações de saúde, API chamadas e respostas. O Amazon GameLift Local reconhece um subconjunto das AWS SDK ações da Amazon. GameLift Você pode fazer chamadas do AWS CLI ou do seu cliente de jogo. Todas as API ações são executadas localmente da mesma forma que no serviço GameLift web da Amazon.

Cada processo do servidor deve hospedar apenas uma única sessão de jogo. A sessão do jogo é o executável que você usa para se conectar ao Amazon GameLift Local. Quando a sessão do jogo estiver concluída, você deverá chamar GameLiftServerSDK::ProcessEnding e sair do processo. Ao testar localmente com o Amazon GameLift Local, você pode iniciar vários processos de servidor. Cada processo se conectará ao Amazon GameLift Local. Em seguida, você pode criar uma sessão de jogo para cada processo do servidor. Quando sua sessão de jogo terminar, o processo do servidor de jogos deverá sair. Em seguida, você deve iniciar manualmente outro processo do servidor.

A Amazon GameLift local oferece suporte ao seguinteAPIs:

  • CreateGameSession

  • CreatePlayerSession

  • CreatePlayerSessions

  • DescribeGameSessions

  • DescribePlayerSessions

Configurar a Amazon GameLift localmente

O Amazon GameLift Local é fornecido como um .jar arquivo executável empacotado com o servidor. SDK Ele pode ser executado no Windows ou Linux e usado com qualquer linguagem GameLift compatível com a Amazon.

Para executar o Local, você também deve ter instalado os itens a seguir.

  • Uma compilação do Amazon GameLift Server SDK versão 3.1.5 a 4.x.

  • Java 8

Testar um servidor de jogos

Se quiser testar somente seu servidor de jogos, você pode usar o AWS CLI para simular chamadas de clientes de jogos para o serviço Amazon GameLift Local. Isso verifica se o servidor de jogos está funcionando conforme esperado com o seguinte:

  • O servidor do jogo é iniciado corretamente e inicializa o Amazon GameLift ServerSDK.

  • Como parte do processo de lançamento, o servidor do jogo notifica a Amazon de GameLift que o servidor está pronto para hospedar sessões de jogo.

  • O servidor do jogo envia o status de saúde para a Amazon a GameLift cada minuto durante a execução.

  • O servidor de jogos responde a solicitações para iniciar uma nova sessão de jogo.

  1. 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.

  2. 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:

    • Erro: "ProcessReady não encontrou um processo com PiD: <process ID>! O Init SDK () foi invocado?”

    • Aviso: “O estado do processo já existe para o processo com PiD: <process ID>! É ProcessReady (...) invocado mais de uma vez?”

  3. 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.

  4. 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
    }
}

Testar um servidor e um cliente de jogo

Para verificar a integração completa do jogo, inclusive a conexão de jogadores com jogos, você pode executar o servidor de jogos e o cliente localmente. Isso permite que você teste chamadas programáticas do seu cliente de jogo para o Amazon GameLift Local. Você pode verificar as seguintes ações:

  • O cliente do jogo está fazendo AWS SDK solicitações com sucesso ao serviço Amazon GameLift Local, inclusive para criar sessões de jogo, recuperar informações sobre sessões de jogo existentes e criar sessões de jogadores.

  • O servidor de jogos está validando corretamente jogadores quando eles tentam participar de uma sessão do jogo. Para jogadores validados, o servidor de jogos pode recuperar dados do jogador (se implementado).

  • O servidor de jogos informa uma conexão perdida quando um jogador deixa o jogo.

  • O servidor de jogos informa o encerramento de uma sessão do jogo.

  1. 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.

  2. 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.

  3. 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:

    • Altere o objeto ClientConfiguration a fim de apontar para o endpoint do Local, como http://localhost:9080.

    • Defina um valor de ID da frota de destino. Para Local, você não precisa de um ID de frota real; defina a frota de destino como qualquer string válida (^fleet-\S+), como fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d.

    • Defina AWS as credenciais. Para Local, você não precisa de credenciais da AWS reais; você pode definir a chave de acesso e a chave secreta como qualquer string.

    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 .

  4. 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.

  5. 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.

  6. 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.

    • O jogador se desconecta de uma sessão de jogo — As mensagens de registro GameLift local da Amazon devem mostrar que seu servidor de jogo está RemovePlayerSession() ligando. Uma chamada à AWS CLI para DescribePlayerSessions() deve refletir uma alteração feita no status de Active para Completed. Também convém chamar DescribeGameSessions() para verificar se a contagem de jogadores atual da sessão do jogo diminui em um.

    • A sessão do jogo termina — As mensagens de log do Amazon GameLift Local devem mostrar que seu servidor de jogo está ligandoTerminateGameSession().

      nota

      A orientação anterior era chamar TerminateGameSession() ao encerrar uma sessão de jogo. Esse método está obsoleto com o Amazon GameLift Server v4.0.1. SDK Consulte Encerrar uma sessão de jogo.

    • O processo do servidor foi encerrado — as mensagens de log do Amazon GameLift Local devem mostrar que o servidor do jogo está ProcessEnding() ligando. Uma AWS CLI chamada para DescribeGameSessions() deve refletir uma mudança de status de Active para Terminated (ouTerminating).

Variações com o local

Ao usar o Amazon GameLift Local, lembre-se do seguinte:

  • Ao contrário do serviço GameLift web da Amazon, o Local não rastreia o status de saúde do servidor e inicia o onProcessTerminate retorno de chamada. O Local simplesmente deixa de registrar em log relatórios de integridade do servidor de jogos.

  • Para chamadas para o AWS SDK, a frota não IDs é validada e pode ser qualquer valor de string que atenda aos requisitos do parâmetro (^fleet-\S+).

  • As sessões de jogo IDs criadas com o Local têm uma estrutura diferente. Eles incluem a string local, conforme mostrado aqui:

    arn:aws:gamelift:local::gamesession/fleet-123/gsess-56961f8e-db9c-4173-97e7-270b82f0daa6