Configurando um servidor web e um cliente com o Amazon GameLift Streams - Amazon GameLift Streams
Pré-requisitosBaixe o Web SDKConfigure seus recursos de streamingConfigurar um servidor de back-endInicie um cliente webLimpe os recursos de streaming

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

Configurando um servidor web e um cliente com o Amazon GameLift Streams

Neste tutorial, você configurará um aplicativo cliente web que integra o serviço de streaming do Amazon GameLift Streams. Em seguida, você usará o Amazon GameLift Streams Web SDK, uma JavaScript biblioteca e um código de amostra com os quais você pode começar. O código de amostra inclui um servidor web de back-end simples do Amazon GameLift Streams e um cliente web simples. Ao final deste tutorial, você pode iniciar um stream usando o código de amostra.

Se é a primeira vez que você usa o Amazon GameLift Streams, é altamente recomendável começar com o Iniciando sua primeira transmissão no Amazon GameLift Streams tutorial, que orienta você a fazer o upload de um jogo para o Amazon S3 e testar a transmissão do mesmo a partir do console do GameLift Amazon Streams em seu navegador.

Pré-requisitos

Baixe o Web SDK

Para este tutorial, você precisará baixar os seguintes materiais da seção Recursos da página de introdução do produto:

  • Pacote Amazon GameLift Streams Web SDK: inclui código de amostra para um serviço de back-end simples e um cliente web.

  • Referência da API do Amazon GameLift Streams Web SDK: Essa referência de API documenta os wrappers de API do Amazon GameLift Streams para. JavaScript

Configure seus recursos de streaming

Você precisa ter recursos de stream — um aplicativo e um grupo de stream — para iniciar um stream. Especificamente, você deve ter:

  • Um aplicativo no status Pronto.

  • Um grupo de streams em status Ativo com capacidade de stream disponível.

Para configurar um aplicativo e um grupo de streams usando o console do Amazon GameLift Streams ou a GameLift CLI do Amazon Streams, consulte e, respectivamente. Prepare um aplicativo no Amazon GameLift Streams Gerencie o streaming com um grupo de GameLift streams do Amazon Streams Como alternativa, para ver um end-to-end passo a passo no console do Amazon GameLift Streams, consulte. Iniciando sua primeira transmissão no Amazon GameLift Streams

Configurar um servidor de back-end

O servidor de back-end é responsável por lidar com tarefas como autenticar usuários, configurar parâmetros de stream e realizar chamadas de API do serviço Amazon GameLift Streams em nome dos usuários finais. Analise o código de amostra e a referência da API Amazon GameLift Streams Web SDK para saber mais sobre como configurar isso. Especificamente, consulte o arquivo server.js no pacote Amazon GameLift Streams Web SDK.

Importante

Esse código é um exemplo de código apenas para fins de teste e avaliação e não deve ser usado em uma capacidade de produção. Para obter orientação sobre a criação de aplicativos cliente de produção, incluindo procedimentos adequados de teste e avaliação, consulte.

Para executar o serviço de back-end de amostra

  1. Abra um terminal ou prompt de comando e navegue até a pastaAmazonGameLiftStreamsWebSDK\GameLiftStreamsSampleGamePublisherService\.

  2. Execute os seguintes comandos : 

    
npm install
node server.js

Com o exemplo de serviço de back-end em execução, os usuários finais podem se conectar a um stream por meio do cliente web. Teste o cliente web na próxima etapa.

Inicie um cliente web

O aplicativo cliente web é responsável por receber e decodificar os streams do Amazon GameLift Streams, transmitir para os usuários finais e fornecer a interface do usuário do navegador da web para que os usuários finais interajam com o aplicativo. Analise o código de amostra e a referência da API do Amazon GameLift Streams Web SDK para saber mais sobre como integrar o JavaScript Amazon GameLift Streams Web SDK em seu próprio aplicativo cliente web. Especificamente, veja public/index.html no pacote Amazon GameLift Streams Web SDK. Você também pode ver a fonte da página da Web ao iniciar um cliente Web em seu navegador.

Para iniciar um aplicativo cliente web

  1. Abra um navegador da web e navegue atéhttp://localhost:port/. O número da porta é definido pelo servidor de back-end; por padrão, essa é a porta HTTP 8000.

  2. Jogue o jogo ou use o software.

    1. Para anexar uma entrada, como o mouse, escolha Anexar entrada.

    2. Para sair do jogo, escolha a tecla Esc.

    3. Para interromper o processo do servidor, escolha a tecla Ctrl+C.

Limpe os recursos de streaming

Atenção

Um grupo de streams incorre em custos quando tem capacidade de streaming alocada, mesmo que essa capacidade não seja usada. Para evitar custos desnecessários, escale seus grupos de stream para o tamanho necessário. Durante o desenvolvimento, sugerimos que você escale a capacidade sempre ativa em seus grupos de stream para zero quando não estiver em uso ou use a capacidade sob demanda. Para obter mais informações, consulte Dimensione grupos de stream para capacidade zero.

Depois de concluir o tutorial e não precisar mais transmitir seu aplicativo, siga estas etapas para limpar seus recursos do Amazon GameLift Streams.

Excluindo um grupo de streams

Quando você exclui um grupo de streams, o Amazon GameLift Streams trabalha para liberar toda a capacidade de streaming.

Para excluir um grupo de streams usando o console do Amazon GameLift Streams

  1. Faça login no AWS Management Console e abra o console do Amazon GameLift Streams.

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

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

  4. Na página de detalhes do grupo de transmissão, escolha Excluir.

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

O Amazon GameLift Streams começa a liberar recursos computacionais e a excluir o grupo de streams. Durante esse período, o grupo de stream está no status Excluindo. Depois que o Amazon GameLift Streams excluir o grupo de streams, você não poderá mais recuperá-lo.

Excluindo um aplicativo

Você só pode excluir um aplicativo que atenda às seguintes condições:

  • O aplicativo está no estado Pronto ou com Erro.

  • O aplicativo não é o aplicativo padrão de nenhum grupo de stream. Primeiro, você deve excluir o grupo de streams usando o console do Amazon GameLift Streams ou usando a DeleteStreamGroupAPI do Amazon GameLift Streams.

  • O aplicativo não está vinculado a nenhum grupo de stream. Primeiro, você deve desvincular o grupo de streams usando o console do Amazon GameLift Streams ou usando DisassociateApplicationsa API do Amazon GameLift Streams.

  • Um aplicativo não está sendo transmitido em nenhuma sessão de streaming em andamento. Você deve esperar até que o cliente encerre a sessão de stream ou chamar TerminateStreamSessiona API do Amazon GameLift Streams para finalizar o stream.

Para excluir um aplicativo usando o console do Amazon GameLift Streams

  1. Faça login no AWS Management Console e abra o console do Amazon GameLift Streams.

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

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

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

O Amazon GameLift Streams começa a excluir o aplicativo. Durante esse período, o aplicativo está em Deleting status. Depois que o Amazon GameLift Streams excluir o aplicativo, você não poderá mais recuperá-lo.