Instale o plug-in para Unity

Esta seção descreve como adicionar o plug-in a um projeto Unity. Depois que o plug-in for instalado, a funcionalidade do plug-in estará disponível quando você tiver o projeto aberto no editor Unity.

Antes de começar

Veja o que você precisa para usar o GameLift plug-in da Amazon para Unity:

• Unity para Windows 2022 LTS ou Unity para macOS

• GameLift Plugin da Amazon para download do Unity. [Site de download] O download inclui dois pacotes:

  • Plugin GameLift autônomo da Amazon para Unity

  • SDK do servidor Amazon GameLift C# para Unity

• Microsoft Visual Studio 2019 ou mais recente.

• Um projeto de jogo multijogador com código de jogo C#.

• O registro UnityNuGet com escopo de terceiros. Essa ferramenta gerencia DLLs de terceiros. Para obter mais informações, consulte o repositório UnityNuGetGithub.

Adicione o plug-in ao projeto de jogo

Conclua as tarefas a seguir, trabalhando no editor Unity e nos arquivos de projeto do seu jogo.

Etapa 1: adicionar UnityNuGet ao seu projeto de jogo

Se você não tiver UnityNuGet configurado seu projeto de jogo, use as etapas a seguir para instalar a ferramenta usando o gerenciador de pacotes Unity. Como alternativa, você pode usar a NuGet CLI para baixar manualmente as DLLs. Para obter mais informações, consulte o Amazon GameLift C# server SDK for Unity. README

1. Com seu projeto aberto no editor Unity, acesse o menu principal e selecione Editar, Configurações do projeto. Nas opções, escolha a seção Gerenciador de pacotes e abra o grupo Registros com Escopo.

2. Escolha o botão + e insira os seguintes valores para o registro UnityNuGet com escopo:

   Name: Unity NuGet
   URL: https://unitynuget-registry.azurewebsites.net
   Scope(s): org.nuget

Para usuários da versão 2021 do Unity:

Após a configuração UnityNuGet, verifique se há Assembly Version Validation erros exibidos no console do Unity. Esses erros ocorrem se os redirecionamentos de vinculação para assemblies com nomes fortes nos NuGet pacotes não estiverem sendo resolvidos corretamente para caminhos dentro do seu projeto Unity. Para resolver esse problema, configure a validação da versão de montagem do Unity:

1. No editor do Unity, acesse o menu principal e selecione Editar, Configurações do projeto e abra a seção Player.

2. Desmarque a opção Validação da versão de montagem.

Etapa 2: Adicionar o plug-in e os pacotes do SDK do servidor C#

1. Descompacte o GameLift plug-in da Amazon para download do Unity, que contém os dois pacotes.

2. Com seu projeto aberto no Unity Editor, vá até o menu principal e selecione Window, Package Manager.

3. Escolha o botão + para adicionar um novo pacote. Escolha a opção Adicionar pacote do tarball.

4. Em Selecionar pacotes no disco, localize o plug-in Amazon GameLift C# Server SDK para baixar arquivos do Unity e escolha o com.amazonaws.gameliftserver.sdk-<version>.tgz arquivo. Escolha Abrir para instalar o plug-in.

5. Em Selecionar pacotes no disco, localize o plug-in GameLift autônomo da Amazon para arquivos de download do Unity e escolha o arquivocom.amazonaws.gamelift-<version>.tgz. Escolha Abrir para instalar o plug-in.

6. Verifique se o plug-in independente foi adicionado ao seu projeto. Retorne à janela do editor Unity. Verifique o menu principal para ver o novo botão de GameLift menu da Amazon.

Etapa 3: importar o jogo de amostra (opcional)

O plug-in para Unity vem com um conjunto de amostras de ativos do jogo, incluindo cenas, que você pode adicionar ao seu projeto de jogo. A importação do jogo de amostra oferece um caminho rápido para testar, criar e implantar um jogo multijogador simples com a Amazon. GameLift O jogo de amostra já está totalmente integrado aos GameLift SDKs da Amazon, então você pode pular as tarefas de integração e concluir as tarefas restantes do fluxo de trabalho.

Ao usar o jogo de amostra, você pode configurar e ingressar em uma frota Amazon GameLift Anywhere hospedada localmente em apenas alguns minutos. Você pode implantar o jogo na Amazon GameLift e participar de um jogo ao vivo hospedado na nuvem em menos de uma hora.

Para importar o jogo de amostra:

1. Com seu projeto de jogo aberto no Unity Editor, acesse o GameLift menu Amazon e selecione Sample Game, Import Sample Game.

2. Depois que os arquivos forem importados, acesse o GameLift menu Amazon novamente e selecione Sample Game, Initialize Settings. Esta etapa configura seu projeto para criar o cliente e o servidor do jogo.

Quando a instalação estiver concluída, você verá duas novas cenas adicionadas ao seu projeto de jogo. Você também verá alguns ativos adicionais do projeto, incluindo um GameLiftClientSettingsativo.

Para obter mais detalhes sobre a interface de usuário e a jogabilidade da amostra, consulte a amostra do readme do jogo.