Amazon GameLift Serversplugin para Unity (servidor SDK 4.x)

Para fazer download e instalar o plug-in para Unity

1. Baixe o Amazon GameLift Servers plug-in para Unity. Você pode encontrar a versão mais recente na página do Amazon GameLift Serversplug-in para o repositório Unity. Na versão mais recente, escolha Ativos e, em seguida, baixe o arquivo com.amazonaws.gamelift-version.tgz.

2. Inicie o Unity e escolha um projeto.

3. Na barra de navegação superior, em Window, escolha Gerenciador de pacotes:

   

4. No guia Gerenciador de pacotes, escolha + e, em seguida, escolha Adicionar pacote do tarball...:

   

5. Na janela Selecionar pacotes no disco, navegue até a pasta com.amazonaws.gamelift, escolha o arquivo com.amazonaws.gamelift-version.tgz e escolha Abrir:

   

6. Depois que o Unity carrega o plug-in, Amazon GameLift Serversaparece como um novo item no menu Unity. Pode demorar alguns minutos para instalar e recompilar scripts. A guia Configurações do Amazon GameLift Servers plug-in é aberta automaticamente.

   

7. No painel SDK, escolha Usar o .NET 4.x.

   Quando configurado, o status muda de Não configurado para Configurado.

1. Na janela do plug-in para Unity, escolha o guia Teste.

2. No painel Teste, escolha Baixar Amazon GameLift Servers local. O plug-in para Unity abre uma janela do navegador e baixa o arquivo GameLift_06_03_2021.zip para sua pasta de downloads.

   O download inclui o SDK do servidor C#, arquivos de origem do .NET e um componente do .NET compatível com o Unity.

3. Não descompacte o arquivo GameLift_06_03_2021.zip obtido por download.

4. Na janela Configurações do Amazon GameLift Servers plug-in, escolha Amazon GameLift ServersLocal Path, navegue até a pasta descompactada, escolha o arquivo GameLiftLocal.jar e escolha Abrir.

   Quando configurado, o status do teste local muda de Não configurado para Configurado.

5. Verifique o status do JRE. Se o status for Não configurado, escolha Baixar o JRE e instale a versão recomendada do Java.

   Depois de instalar e configurar o ambiente Java, o status muda para Configurado.

1. No guia Plug-in para Unity, escolha o guia Teste.

2. No painel Teste, escolha Abrir interface de teste local.

3. Na janela Teste local, especifique um Caminho executável do servidor. Selecione... para selecionar o caminho e o nome do executável do seu aplicativo de servidor.

4. Na janela Teste local, especifique uma porta local GL.

5. Escolha Implantar e executar para implantar e executar o servidor.

6. Para parar seu servidor de jogos, escolha Parar ou feche as janelas do servidor de jogos.

Para atualizar as AWS credenciais

1. No Unity, no guia Plug-in para Unity, escolha o guia Implantar.

2. No painel Implantar, escolha Credenciais da AWS .

3. Você pode criar novas AWS credenciais ou escolher credenciais existentes.

   • Para criar credenciais, escolha Criar novo perfil de credenciais e, em seguida, especifique o Nome do novo perfil, ID da chave de acesso da AWS , chave secreta da AWS e Região da AWS.

   • Para escolher as credenciais existentes, escolha Escolher perfil de credenciais existente e, em seguida, selecione um nome de perfil e Região da AWS.

4. Na janela Atualizar AWS Credenciais, escolha Atualizar Perfil de Credenciais.

Para atualizar a localização do bootstrap da conta

1. No Unity, no guia Plug-in para Unity, escolha a guia Implantar.

2. No painel Implantar, escolha Atualizar conta Bootstrap.

3. Na janela Account Bootstrapping, você escolhe um bucket do Amazon S3 existente ou cria um novo bucket do Amazon S3:

   • Para escolher um bucket existente, escolha Escolher bucket do Amazon S3 existente e Atualizar para salvar sua seleção.

   • Escolha Criar o bucket do Amazon S3 para criar um bucket do Amazon Simple Storage Service e, em seguida, escolha uma política. A política especifica quando o bucket do Amazon S3 expirará. Escolha Criar para criar o bucket.

Para implantar um cenário

1. No Unity, no guia Plug-in para Unity, escolha o guia Implantar.

2. No painel Implantar, escolha Abrir interface de implantação.

3. Na janela Implantar, escolha um cenário.

4. Insira um Nome de Jogo. Essa opção deve ser exclusiva. O nome do jogo faz parte do nome da AWS CloudFormation pilha quando você implanta o cenário.

5. Escolha o Caminho da pasta de compilação do servidor de jogo. O caminho da pasta de compilação aponta para a pasta que contém o executável e as dependências do servidor.

6. Escolha o Caminho do arquivo .exe de compilação do servidor de jogo. O caminho do arquivo executável de compilação aponta para o executável do servidor do jogo.

7. Escolha Iniciar implantação para começar a implantar um cenário. Você poderá acompanhar o status da atualização na janela Implantação em Estado atual. Os cenários podem levar vários minutos para serem implantados.

   

8. Quando a implantação do cenário é concluída, o Estado atual é atualizado para incluir o ID do cliente Cognito e a Endpoint do API Gateway, que você pode copiar e colar no jogo.

   

9. Para atualizar as configurações do jogo, no menu Unity, escolha Ir para configurações de conexão do cliente. Isso exibe um guia Inspector no lado direito da tela do Unity.

10. Desmarque o Modo de teste local.

11. Insira o Endpoint do API Gateway e o ID do cliente Coginito. Escolha o mesmo Região da AWS que você usou para a implantação do cenário. Em seguida, você poderá reconstruir e executar o cliente do jogo usando os recursos do cenário implantado.

Para excluir recursos criados pelo cenário

1. Na janela do Amazon GameLift Servers plug-in para Unity Deployment, selecione View AWS CloudFormation Console para abrir o AWS CloudFormation console.

2. No AWS CloudFormation console, escolha Pilhas e, em seguida, escolha a pilha que inclui o nome do jogo especificado durante a implantação.

3. Escolha Excluir para excluir a pilha. Pode levar alguns minutos para excluir uma pilha. Depois de AWS CloudFormation excluir a pilha usada pelo cenário, seu status muda para. ROLLBACK_COMPLETE

1. No Unity, no menu, escolha e Amazon GameLift Servers, em seguida, escolha Importar amostra de jogo.

2. Na janela Importar amostra de jogo, escolha Importar para importar o jogo, seus ativos e dependências.

3. Crie o servidor do jogo. No Unity, no menu, escolha e, em seguida Amazon GameLift Servers, escolha Aplicar configurações de compilação do Windows Sample Server ou Aplicar configurações de compilação do macOS Sample Server. Depois de definir as configurações do servidor do jogo, o Unity recompila os ativos.

4. No Unity, no menu, escolha Arquivo e, em seguida, escolha Compilar. Escolha Compilação de servidor, escolha Compilar e, em seguida, escolha uma pasta de compilação específica para arquivos do servidor.

   O Unity cria o servidor de jogo de amostra, colocando os ativos executáveis e necessários na pasta de compilação especificada.

1. No Unity, no menu, escolha e, em seguida Amazon GameLift Servers, escolha Aplicar configurações de compilação do Windows Sample Client ou Aplicar configurações de compilação do cliente de amostra do macOS. Depois que as configurações do cliente do jogo forem definidas, o Unity recompilará os ativos.

2. No Unity, no menu, selecione Ir para configurações do cliente. Isso exibirá um guia Inspector no lado direito da tela do Unity. Na guia Configurações do Amazon GameLift Servers cliente, selecione Modo de teste local.

3. Crie o cliente do jogo. No Unity, no menu, escolha Arquivo. Confirme se a opção Compilação de servidor não está marcada, escolha Compilação e selecione uma pasta de compilação específica para arquivos do cliente.

   O Unity cria o cliente de jogo de amostra, colocando os ativos executáveis e necessários na pasta de criação do cliente especificada.

4. Você não construiu o servidor e o cliente do jogo. Nas próximas etapas, você executa o jogo e vê como ele interage comAmazon GameLift Servers.

1. Inicie o servidor do jogo. No Unity, no guia Plug-in para Unity, escolha o guia Implantar.

2. No painel Teste, escolha Abrir interface de teste local.

3. Na janela Teste local, especifique um Caminho de arquivo .exe do servidor de jogos. O caminho deve incluir o nome do executável. Por exemplo, .C:/MyGame/GameServer/MyGameServer.exe

4. Escolha Implantar e executar. O plug-in para Unity inicia o servidor do jogo e abre uma janela de registro Amazon GameLift Servers local. A janela contém mensagens de log, incluindo mensagens enviadas entre o servidor do jogo e o Amazon GameLift Servers Local.

5. Inicie o cliente do jogo. Encontre o local de compilação com o cliente do jogo de amostra e escolha o arquivo executável.

6. No Jogo de Amazon GameLift Servers Amostra, forneça um e-mail e uma senha e, em seguida, escolha Entrar. O e-mail e a senha não são validados nem usados.

7. No Jogo Amazon GameLift Servers de Amostra, escolha Iniciar. O cliente do jogo procura uma sessão de jogo. Se ele não conseguir encontrar uma sessão, ele cria uma. O cliente do jogo então inicia a sessão do jogo. Você poderá ver a atividade do jogo nos registros.

1. No cliente do jogo, escolha Sair ou feche a janela para parar o cliente do jogo.

2. No Unity, na janela Teste local, escolha Parar ou feche as janelas do servidor de jogos para parar o servidor.