Iniciando seu primeiro stream no Amazon GameLift Streams

Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em https://console.aws.amazon.com/s3/.

Crie um bucket do Amazon S3. Insira um nome de bucket e selecione um Região da AWS. Essa região deve ser igual ao aplicativo e ao grupo de streams que você criará posteriormente. Veja Regiões da AWS e locais de streaming suportados pelo Amazon GameLift Streams uma lista de Regiões da AWS onde o Amazon GameLift Streams está disponível. Para os campos restantes, mantenha as configurações padrão.

Para obter mais instruções, consulte Criação de um bucket no Guia do usuário do Amazon Simple Storage Service.

Abra o novo bucket e faça o upload da pasta com os arquivos do aplicativo.

Faça login no Console de gerenciamento da AWS e abra o console do Amazon GameLift Streams. Escolha o mesmo Região da AWS que o bucket do Amazon S3 em que você carregou seu conjunto de arquivos. Para obter mais informações, consulte Como escolher uma região no Console de gerenciamento da AWS Guia de introdução.

Na barra de navegação, escolha Aplicativos e escolha Criar aplicativo.

Em Configurações de tempo de execução, insira o seguinte:

1. Ambiente de execução

   Esse é o ambiente de execução no qual executar seu aplicativo. O Amazon GameLift Streams pode ser executado no Windows, no Ubuntu 22.04 LTS ou no Proton. https://en.wikipedia.org/wiki/Proton_(software)

   Não é possível editar esse campo após o fluxo de trabalho de criação.

   Escolha um dos seguintes ambientes .

   • Para aplicativos Linux:

     • Ubuntu 22.04 LTS () UBUNTU, 22_04_LTS

   • Para aplicativos do Windows:

     • Microsoft Windows Server 2022 Base (WINDOWS, 2022)

     • Próton 10.0-4 () PROTON, 20260204

     • Próton 9.0-2 () PROTON, 20250516

     • Próton 8.0-5 () PROTON, 20241007

     • Próton 8.0-2c () PROTON, 20230704

   Analise as descrições e use a lista de verificação de comparação para ajudá-lo a selecionar o ambiente de execução ideal para seu aplicativo.

Em Configurações gerais, insira o seguinte:

1. Descrição

   É um rótulo legível por humanos para a aplicação. Esse valor não precisa ser exclusivo. Recomenda-se o uso de uma descrição, um nome ou um rótulo pertinente para a aplicação. É possível editar esse campo a qualquer momento.

2. Caminho base

   É o URI do Amazon S3 para a pasta raiz da aplicação no bucket do Amazon S3. A pasta e todas as subpastas devem conter o executável de compilação e todos os arquivos de apoio.

   Um URI válido é o prefixo de bucket que contém todos os arquivos necessários para executar e fazer streaming da aplicação. Por exemplo, um bucket chamado mygamebuild contém três versões completas dos arquivos de compilação do jogo, cada uma em uma pasta separada. Convém fazer streaming da compilação na pasta mygamebuild-EN101. Nesse exemplo, o URI é s3://amzn-s3-demo-bucket/mygamebuild-EN101.

   Não é possível editar esse campo após o fluxo de trabalho de criação.

3. Caminho de lançamento executável

   Esse é o URI do Amazon S3 do arquivo executável que o Amazon GameLift Streams transmitirá. O arquivo deve estar na pasta raiz da aplicação. Para aplicativos do Windows, o arquivo deve ser um arquivo executável ou em lote válido do Windows com um nome de arquivo terminado em .exe, .cmd ou .bat. Para aplicativos Linux, o arquivo deve ser um executável binário Linux válido ou um script que contenha uma linha inicial do interpretador começando com um shebang ('#!').

   Não é possível editar esse campo após o fluxo de trabalho de criação.

(Opcional) Em Caminho do registro do aplicativo, insira o seguinte:

1. Caminho do registro do aplicativo

   Especifique os caminhos para registrar arquivos ou pastas que você deseja que o Amazon GameLift Streams salve. Ao final de cada sessão de stream, o Amazon GameLift Streams copia os arquivos especificados para o bucket do Amazon S3 que você nomeou.

   • Os caminhos são relativos ao diretório do seu aplicativo ou ao diretório inicial do usuário ao usar uma variável de caminho compatível.

   • Se você especificar um diretório, somente os arquivos .txt, .log e .utrace serão coletados. Para coletar outros tipos de arquivo, especifique o caminho exato do arquivo.

   • A operação de cópia não é realizada recursivamente nas subpastas.

   • É possível especificar até 10 caminhos de log. Cada arquivo de log individual não pode exceder 50 MB.

   Variáveis de caminho

   As variáveis a seguir são reconhecidas quando aparecem como o primeiro componente de um caminho.

   • %USERPROFILE%: o diretório inicial do usuário (Windows e Proton)

   • $HOME, ~: o diretório inicial do usuário (Linux)

   Exemplos:

   • Saved\Logs: coleta os arquivos .txt, .log e .utrace do diretório Saved\Logs relativo ao seu aplicativo.

   • Saved\Logs\debug.dmp: coleta um arquivo nomeado específico.

   • %USERPROFILE%\AppData\Local\MyGame\Logs: coleta os arquivos .txt, .log e .utrace em relação ao diretório inicial do usuário. Use uma variável de caminho quando seu aplicativo gravar logs fora do diretório do aplicativo.

   Para desabilitar o registro em log, remova todos os caminhos de log da aplicação e limpe o destino de saída do log da aplicação.

   É possível editar esse campo a qualquer momento.

2. Saída do registro do aplicativo

   Esse é o URI do bucket do Amazon S3 em que o Amazon GameLift Streams copiará os arquivos de log do aplicativo. Esse campo é obrigatório quando você especifica um caminho para os logs da aplicação.

   Para desabilitar o registro em log, remova todos os caminhos de log da aplicação e limpe o destino de saída do log da aplicação.

   É possível editar esse campo a qualquer momento.

   Para salvar arquivos de log em seu nome, o Amazon GameLift Streams deve ter permissão para salvar seu bucket do S3. Se você permitir que o Amazon GameLift Streams crie o bucket para registro, a política de permissão será aplicada automaticamente após a criação. Se você fornecer um bucket próprio, precisará aplicar a política de permissão por conta própria.

   Modelo de política de permissão de bucket

   Copie o código de política a seguir e aplique-o ao bucket que você deseja usar para os logs da aplicação. Substitua amzn-s3-demo-bucket pelo nome do bucket do S3 existente.

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Sid": "PutPolicy",
         "Effect": "Allow",
         "Principal": {
           "Service": [
             "gameliftstreams.amazonaws.com"
           ]
         },
         "Action": "s3:PutObject",
         "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*",
         "Condition": {
           "StringEquals": {
             "aws:SourceAccount": "123456789012"
           }
         }
       }
     ]
   }

(Opcional) Em Tags, atribua tags a esse aplicativo.

As tags são rótulos que podem ajudar você a organizar seus AWS recursos. Para ter mais informações, consulte Marcar seus recursos da AWS.

Por exemplo, para rastrear versões de aplicativos, use uma tag comoapplication-version : my-game-1121.

Selecione Criar aplicativo.

Faça login no Console de gerenciamento da AWS e abra o console do Amazon GameLift Streams. Escolha Região da AWS onde você deseja criar seu grupo de stream. Essa região deve ser a mesma do aplicativo que você deseja transmitir com o grupo de streams. Para obter mais informações, consulte Como escolher uma região no Console de gerenciamento da AWS Guia de introdução.

Para abrir o fluxo de trabalho de criação, no painel de navegação, escolha Grupos de transmissão e, em seguida, escolha Criar grupo de fluxo.

Em Definir grupo de streams, insira o seguinte:

1. Descrição

   Um rótulo legível por humanos para seu grupo de transmissões. Esse valor não precisa ser exclusivo. Como prática recomendada, use uma descrição, um nome ou um rótulo significativo para o grupo de transmissões. É possível editar esse campo a qualquer momento.

2. Tags

   As tags são rótulos que podem ajudar você a organizar seus AWS recursos. Para ter mais informações, consulte Marcar seus recursos da AWS.

Em Selecionar classe de fluxo, escolha uma classe de fluxo para o grupo de fluxo.

1. Opções de classe de transmissão

   O tipo de recursos computacionais com os quais executar e transmitir aplicativos. Essa escolha afeta a qualidade da experiência de streaming e o custo. É possível especificar somente uma classe de transmissão por grupo de transmissões. Escolha a classe que melhor se adapta à sua aplicação.

   Classe de transmissão	Description
   gen6n_pro_win2022	(NVIDIA, pro) Aceita aplicações com complexidade de cena 3D extremamente alta que exigem o máximo de recursos. Executa aplicações no Microsoft Windows Server 2022 Base e comporta o DirectX 12. Compatível com o Unreal Engine versões até 5.6, aplicações de 32 bits e 64 bits e tecnologia antifraude. Usa a GPU NVIDIA L4 Tensor Core. Recursos por aplicação: vCPUs: 16. RAM: 64 GB. VRAM: 24 GB. Locação: comporta até uma sessão de transmissões simultânea.
   gen6n_pro	(NVIDIA, pro) Aceita aplicações com complexidade de cena 3D extremamente alta que exigem o máximo de recursos. Usa a GPU NVIDIA L4 Tensor Core. Recursos por aplicação: vCPUs: 16. RAM: 64 GB. VRAM: 24 GB. Locação: comporta até uma sessão de transmissões simultânea.
   gen6n_ultra_win2022	(NVIDIA, ultra) Comporta aplicações com alta complexidade de cena 3D. Executa aplicações no Microsoft Windows Server 2022 Base e comporta o DirectX 12. Compatível com o Unreal Engine versões até 5.6, aplicações de 32 bits e 64 bits e tecnologia antifraude. Usa a GPU NVIDIA L4 Tensor Core. Recursos por aplicação: vCPUs: 8. RAM: 32 GB. VRAM: 24 GB. Locação: comporta até uma sessão de transmissões simultânea.
   gen6n_ultra	(NVIDIA, ultra) Comporta aplicações com alta complexidade de cena 3D. Usa a GPU NVIDIA L4 Tensor Core. Recursos por aplicação: vCPUs: 8. RAM: 32 GB. VRAM: 24 GB. Locação: comporta até uma sessão de transmissões simultânea.
   gen6n_high	(NVIDIA, alta) Comporta aplicações com complexidade de cena 3D de moderada a alta. Usa a GPU NVIDIA L4 Tensor Core. Recursos por aplicação: vCPUs: 4. RAM: 16 GB. VRAM: 12 GB. Locação: comporta até duas sessões de transmissão simultâneas.
   gen6n_medium	(NVIDIA, média) Comporta aplicações com complexidade de cena 3D moderada. Usa a GPU NVIDIA L4 Tensor Core. Recursos por aplicação: vCPUs: 2. RAM: 8 GB VRAM: 6 GB. Locação: comporta até quatro sessões de transmissões simultâneas.
   gen6n_small	(NVIDIA, pequeno) Aceita aplicações com complexidade de cena 3D leve e baixo uso da CPU. Usa a GPU NVIDIA L4 Tensor Core. Recursos por aplicação: vCPUs: 1. RAM: 4 GB. VRAM: 2 GB. Locação: comporta até 12 sessões de transmissões simultâneas.
   gen6n_medium_win2022	(NVIDIA, média) Comporta aplicações com baixa complexidade de cena 3D. Executa aplicações no Microsoft Windows Server 2022 Base. Usa a GPU NVIDIA L4 Tensor Core. Recursos por aplicação: vCPUs: 8. RAM: 32 GB. VRAM: 6 GB. Locação: comporta até uma sessão de transmissões simultânea.
   gen6n_small_win2022	(NVIDIA, pequena) Comporta aplicações com baixa complexidade de cena 3D. Executa aplicações no Microsoft Windows Server 2022 Base. Usa a GPU NVIDIA L4 Tensor Core. Recursos por aplicação: vCPUs: 2. RAM: 8 GB VRAM: 3 GB. Locação: comporta até uma sessão de transmissões simultânea.
   gen6e_pro_win2022	(NVIDIA, pro) Aceita aplicações com complexidade de cena 3D extremamente alta que exigem o máximo de recursos. Executa aplicações no Microsoft Windows Server 2022 Base e comporta o DirectX 12. Compatível com o Unreal Engine versões até 5.6, aplicações de 32 bits e 64 bits e tecnologia antifraude. Utiliza a GPU NVIDIA L40S Tensor Core. Recursos por aplicação: vCPUs: 16. MEMÓRIA RAM: 128 GB. VRAM: 48 GB. Locação: comporta até uma sessão de transmissões simultânea.
   gen6e_pro	(NVIDIA, pro) Aceita aplicações com complexidade de cena 3D extremamente alta que exigem o máximo de recursos. Utiliza a GPU NVIDIA L40S Tensor Core. Recursos por aplicação: vCPUs: 16. MEMÓRIA RAM: 128 GB. VRAM: 48 GB. Locação: comporta até uma sessão de transmissões simultânea.
   gen5n_win2022	(NVIDIA, ultra) Comporta aplicações com complexidade de cena 3D extremamente alta. Executa aplicações no Microsoft Windows Server 2022 Base e comporta o DirectX 12 e o DirectX 11. Comporta o Unreal Engine até a versão 5.6, aplicações de 32 e 64 bits e tecnologia antifraude. Usa a GPU NVIDIA A10G Tensor Core. Recursos por aplicação: vCPUs: 8. RAM: 32 GB. VRAM: 24 GB. Locação: comporta uma sessão de transmissão simultânea.
   gen5n_high	(NVIDIA, alta) Comporta aplicações com complexidade de cena 3D de moderada a alta. Usa a GPU NVIDIA A10G Tensor Core. Recursos por aplicação: vCPUs: 4. RAM: 16 GB. VRAM: 12 GB. Locação: comporta até duas sessões de transmissão simultâneas.
   gen5n_ultra	(NVIDIA, ultra) Comporta aplicações com complexidade de cena 3D extremamente alta. Usa a GPU NVIDIA A10G Tensor Core. Recursos por aplicação: vCPUs: 8. RAM: 32 GB. VRAM: 24 GB. Locação: comporta uma sessão de transmissão simultânea.
   gen4n_win2022	(NVIDIA, ultra) Comporta aplicações com alta complexidade de cena 3D. Executa aplicações no Microsoft Windows Server 2022 Base e comporta o DirectX 12 e o DirectX 11. Comporta o Unreal Engine até a versão 5.6, aplicações de 32 e 64 bits e tecnologia antifraude. Usa a GPU NVIDIA T4 Tensor Core. Recursos por aplicação: vCPUs: 8. RAM: 32 GB. VRAM: 16 GB. Locação: comporta uma sessão de transmissão simultânea.
   gen4n_high	(NVIDIA, alta) Comporta aplicações com complexidade de cena 3D de moderada a alta. Usa a GPU NVIDIA T4 Tensor Core. Recursos por aplicação: vCPUs: 4. RAM: 16 GB. VRAM: 8 GB. Locação: comporta até duas sessões de transmissão simultâneas.
   gen4n_ultra	(NVIDIA, ultra) Comporta aplicações com alta complexidade de cena 3D. Usa a GPU NVIDIA T4 Tensor Core. Recursos por aplicação: vCPUs: 8. RAM: 32 GB. VRAM: 16 GB. Locação: comporta uma sessão de transmissão simultânea.

Para continuar, escolha Avançar.

No aplicativo Link, escolha um aplicativo que você deseja transmitir ou selecione "Sem aplicativo" para escolher um mais tarde. Você pode editar o grupo de streams após sua criação para adicionar ou remover aplicativos. Você só pode vincular um aplicativo que esteja em Ready status e tenha um tempo de execução compatível com a classe de stream que você escolheu. Por padrão, essas são as únicas aplicações mostradas na tabela. Para ver todos os aplicativos em Ready status, escolha All runtimes na lista suspensa.

Para continuar, escolha Avançar.

Em Definir configurações de stream, em Locais e capacidade, escolha um ou mais locais onde seu grupo de stream terá capacidade para transmitir seu aplicativo. Por padrão, a região em que você cria o grupo de streams, conhecida como localização principal, já foi adicionada ao seu grupo de streams e não pode ser removida. Você pode adicionar outros locais marcando a caixa ao lado de cada local que você deseja adicionar. Para obter menor latência e melhor qualidade de streaming, você deve escolher locais mais próximos de seus usuários.

Para cada local, você pode especificar sua capacidade de streaming. A capacidade de transmissão representa o número de transmissões simultâneas que podem estar ativas por vez. Ela é definida por local em cada grupo de transmissões.

Você pode aumentar ou diminuir sua capacidade total de stream a qualquer momento para atender às mudanças na demanda do usuário por um local ajustando qualquer uma das capacidades. O Amazon GameLift Streams atende às solicitações de streaming usando os recursos ociosos e pré-alocados no pool de capacidade sempre ativo, se houver algum disponível. Se toda a capacidade sempre ativa estiver em uso, o Amazon GameLift Streams provisionará recursos computacionais adicionais até o número máximo especificado na capacidade sob demanda. À medida que a capacidade alocada escala, essa alteração se evidencia no custo total do grupo de transmissões.

Os aplicativos vinculados serão automaticamente replicados em cada local habilitado. Um aplicativo deve concluir a replicação em um local remoto antes que o local remoto possa hospedar um stream. Para verificar o status da replicação, abra o grupo de stream após sua criação e consulte a coluna Status da replicação na tabela de aplicativos vinculados. Clique no status atual para ver o status de replicação de cada local adicionado.

Em Revisar e criar grupo de streams, verifique a configuração do grupo de streams e faça as alterações necessárias. Quando tudo estiver correto, escolha Criar grupo de streams.

Faça login no Console de gerenciamento da AWS e abra o console do Amazon GameLift Streams.

Você pode testar um stream de várias maneiras. Comece na página Grupos de transmissão ou na página de teste da transmissão e siga estas etapas:

1. Selecione um grupo de streams que você deseja usar para transmitir.

2. Se você estiver começando na página Grupos de transmissão, escolha Testar transmissão. Se você estiver começando na página Testar stream, selecione Escolher. Isso abre a página de configuração de fluxo de teste para o grupo de fluxo selecionado.

3. Em Aplicativos vinculados, selecione um aplicativo.

4. Em Local, escolha um local com capacidade disponível.

5. (Opcional) Nas configurações do programa, insira argumentos de linha de comando ou variáveis de ambiente para passar para o aplicativo quando ele for iniciado.

6. Confirme sua seleção e escolha Testar transmissão.

Depois que seu stream for carregado, você poderá realizar as seguintes ações em seu stream:

1. Para conectar entradas, como mouse, teclado e gamepad (exceto microfones, que não são suportados no fluxo de teste), escolha Anexar entrada. Você conecta automaticamente o mouse ao mover o cursor para a janela do stream.

2. Para que os arquivos criados durante a sessão de streaming sejam exportados para um bucket do Amazon S3 no final da sessão, escolha Exportar arquivos e especifique os detalhes do bucket. Os arquivos exportados podem ser encontrados na página Sessões.

3. Para ver a transmissão em tela cheia, escolha Tela cheia. Pressione Escape para reverter essa ação.

Para finalizar a transmissão, escolha Encerrar sessão. Quando o fluxo se desconecta, a capacidade do fluxo fica disponível para iniciar outro fluxo.

Faça login no Console de gerenciamento da AWS e abra o console do Amazon GameLift Streams.

Para ver uma lista dos seus grupos de streams existentes, no painel de navegação, escolha Stream groups.

Escolha o nome do grupo de streams que você deseja excluir.

Na página de detalhes do grupo de streams, escolha Excluir.

Na caixa de diálogo Excluir, confirme a ação de exclusão.

Faça login no Console de gerenciamento da AWS e abra o console do Amazon GameLift Streams.

Na barra de navegação, escolha Aplicativos para ver uma lista de seus aplicativos existentes. Escolha o aplicativo que você deseja excluir.

Na página de detalhes do aplicativo, escolha Excluir.

Na caixa de diálogo Excluir, confirme a ação de exclusão.