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á.
Prepare um aplicativo no Amazon GameLift Streams
Para configurar o streaming com o Amazon GameLift Streams, primeiro você carrega o jogo ou outro aplicativo que deseja transmitir e, em seguida, configura um recurso do aplicativo no Amazon GameLift Streams para definir metadados sobre seu jogo. Um aplicativo Amazon GameLift Streams consiste nos arquivos que você carregou (executáveis e quaisquer arquivos de suporte) e em uma configuração que instrui o GameLift Amazon Streams sobre qual executável executar durante o streaming.
Cada aplicativo Amazon GameLift Streams representa uma única versão do seu conteúdo. Se você tiver várias versões, deverá criar um aplicativo separado para cada versão. Depois de criar um aplicativo, você não pode atualizar os arquivos. Se você precisar atualizar o executável ou qualquer arquivo de suporte, deverá criar um novo aplicativo Amazon GameLift Streams.
Antes de fazer o upload
Antes de criar um aplicativo Amazon GameLift Streams, verifique se seu jogo cumpre as seguintes limitações.
| Name |
Padrão |
Ajustável |
Description |
| Arquivos por aplicativo |
30.000 arquivos |
Sim* |
O número máximo de arquivos que você pode ter em um aplicativo nessa conta. |
| Tamanho de arquivo único |
80 GiB |
Não |
O tamanho máximo de um único arquivo em um aplicativo. Observe que um gibibyte (GiB) é igual a 1024*1024*1024 bytes. |
| Tamanho do aplicativo |
100 GiB |
Sim* |
O tamanho total máximo de um aplicativo Amazon GameLift Streams, nessa conta. Observe que um gibibyte (GiB) é igual a 1024*1024*1024 bytes. |
*Para solicitar um aumento, faça login Console de gerenciamento da AWS e abra o console Service Quotas no GameLift Amazon Streams, onde você pode revisar suas cotas atuais na coluna Valor da cota aplicada em nível de conta e enviar uma solicitação para aumentar um valor.
Para economizar tempo e esforço, verifique se os arquivos que você está pronto para carregar são a versão correta do seu aplicativo. Embora você possa fazer upload de novas versões posteriormente, você precisará repetir a Criar uma aplicação do etapa para cada versão.
Carregue seu aplicativo em um bucket do Amazon S3
Agora que você preparou seu jogo para o Amazon GameLift Streams, é hora de carregá-lo em um bucket do Amazon Simple Storage Service (Amazon S3) em sua conta. AWS
A classe de armazenamento Amazon S3 que o Amazon GameLift Streams exige é o padrão S3 Standard. Outras classes de armazenamento, como S3 Glacier ou objetos que estão sendo movidos para acesso infrequente ou acesso a arquivos pelo S3 Intelligent-Tiering, não são compatíveis com o Amazon Streams. GameLift
Para otimizar o custo de armazenamento, você pode excluir o aplicativo do bucket do S3 depois de concluído Criar uma aplicação do e o aplicativo estar no status Pronto.
Para fazer o upload do seu aplicativo para o Amazon S3
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 a mesma do aplicativo e do grupo de streams que você criará posteriormente. Consulte Regiões da AWS e locais remotos suportados pelo Amazon GameLift Streams para obter 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 Como criar 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 seu aplicativo.
Você deve carregar os arquivos do aplicativo como uma pasta não compactada. Não faça upload de uma .zip pasta.
Criar uma aplicação do
Um aplicativo Amazon GameLift Streams é um recurso que contém um jogo ou aplicativo interativo executado na infraestrutura do Amazon GameLift Streams e oferece experiências de jogo aos jogadores por meio de streaming na nuvem. O aplicativo é executado em instâncias de AWS computação e renderiza o conteúdo do jogo que é transmitido diretamente para os dispositivos dos jogadores pela Internet, eliminando a necessidade de os jogadores baixarem, instalarem ou executarem o jogo localmente.
Ao criar um aplicativo Amazon GameLift Streams, você fornece o URI do Amazon S3 para a pasta do aplicativo que você carregou no seu bucket do Amazon S3 e o caminho relativo para um arquivo executável ou script válido.
O Amazon GameLift Streams não mantém os arquivos do seu aplicativo sincronizados com os arquivos no bucket do Amazon S3. Se você quiser atualizar os arquivos em seu aplicativo Amazon GameLift Streams, você deve criar um novo aplicativo Amazon GameLift Streams.
- Console
-
Para criar um aplicativo Amazon GameLift Streams usando o console Amazon GameLift Streams
-
Faça login no Console de gerenciamento da AWS e abra o console do Amazon GameLift Streams. Escolha o Região da AWS mesmo bucket do Amazon S3 em que você fez o upload do 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, em seguida, escolha Criar aplicativo.
-
Em Configurações de tempo de execução, insira o seguinte:
-
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.
Não é possível editar esse campo após o fluxo de trabalho de criação.
Escolha um dos seguintes ambientes de tempo de execução .
Analise as descrições e use a lista de verificação de comparação para ajudá-lo a selecionar o ambiente de tempo de execução ideal para seu aplicativo.
-
Em Configurações gerais, insira o seguinte:
-
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.
-
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. 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.
-
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:
-
Caminho do registro do aplicativo
Esse é o caminho (ou os caminhos) para a pasta ou o arquivo da aplicação que contém os logs que você deseja salvar. Especifique cada caminho de log em relação ao caminho base da aplicação. Se você usar esse recurso, no final de cada sessão de stream, o Amazon GameLift Streams copiará os arquivos que você especificar para o bucket do Amazon S3 que você nomear. A operação de cópia não é realizada recursivamente nas subpastas da pasta de uma 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.
-
Saída do log do aplicativo
Esse é o URI para o 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 receber permissão para que seu bucket do S3 salve. 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": "your 12-digit account id"
}
}
}
]
}
-
(Opcional) Em Tags, atribua tags a esse aplicativo.
As tags são rótulos que podem ajudar você a organizar seus AWS recursos. Para obter mais informações, consulte Como marcar seus recursos da AWS.
Por exemplo, para rastrear as versões do aplicativo, use uma tag comoapplication-version : my-game-1121.
-
Selecione Criar aplicativo.
- CLI
-
Pré-requisito
Você deve configurar o AWS CLI com suas credenciais de usuário e as escolhidas Região da AWS. Para obter instruções de configuração, consulteBaixe o AWS CLI.
Para criar um aplicativo usando o AWS CLI
Em seu AWS CLI uso, o CreateApplicationcomando, personalizado para o seu conteúdo.
aws gameliftstreams create-application \
--description "MyGame v1" \
--runtime-environment '{"Type":"PROTON", "Version":"20241007"}' \
--executable-path "launcher.exe" \
--application-source-uri "s3://amzn-s3-demo-bucket/example"
para onde
-
description:
É 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.
-
runtime-environment:
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.
Não é possível editar esse campo após o fluxo de trabalho de criação.
Escolha um dos seguintes ambientes de tempo de execução .
-
application-source-uri:
É 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. 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.
-
executable-path:
Esse é o caminho relativo e o nome do arquivo executável que o Amazon GameLift Streams transmitirá. Especifique um caminho relativo aoapplication-source-uri. 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.
Se a solicitação for bem-sucedida, o Amazon GameLift Streams retornará uma resposta semelhante à seguinte:
{
"Arn": "arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6",
"Description": "MyGame v1",
"RuntimeEnvironment": {
"Type": "PROTON",
"Version": "20241007"
},
"ExecutablePath": "launcher.exe",
"ApplicationSourceUri": "s3://amzn-s3-demo-bucket/example",
"Id": "a-9ZY8X7Wv6",
"Status": "PROCESSING",
"CreatedAt": "2022-11-18T15:47:11.924000-08:00",
"LastUpdatedAt": "2022-11-18T15:47:11.924000-08:00"
}
Para verificar o status do seu aplicativo, chame o GetApplicationcomando, conforme mostrado no exemplo a seguir.
aws gameliftstreams get-application /
--identifier a-9ZY8X7Wv6
O Amazon GameLift Streams leva alguns minutos para preparar sua inscrição. Durante esse período, o novo aplicativo está no status Processamento. Quando seu aplicativo estiver no status Pronto, você poderá ir para a próxima etapa,Crie um grupo de stream.
Se a solicitação retornar um erro ou se o aplicativo for criado, mas colocado em um status de erro, verifique se você está trabalhando com credenciais de usuário que incluem acesso ao Amazon S3 e ao Amazon Streams. GameLift
Quando um aplicativo está no status Pronto, o Amazon GameLift Streams copiou com sucesso seus arquivos do aplicativo para seu bucket privado do Amazon S3. Você pode excluir os arquivos originais do aplicativo sem afetar o novo aplicativo. Isso também ajuda você a otimizar o custo de armazenamento. Para obter mais informações, consulte Excluir uma aplicação do .
Editar um aplicativo
Você pode atualizar as configurações de qualquer aplicativo no status Pronto. Se você fizer alterações em um aplicativo existente, essas alterações afetarão o comportamento de streaming dos grupos de streaming novos e existentes.
- Console
-
Para editar um aplicativo no console do Amazon GameLift Streams
-
Na barra de navegação, escolha Aplicativos para ver uma lista dos aplicativos existentes. Escolha o aplicativo que você deseja editar.
-
Na página de detalhes do aplicativo, localize a seção que contém as configurações que você deseja alterar e escolha Editar ou Gerenciar tags adequadamente.
-
Você pode alterar as seguintes configurações:
- Descrição breve
-
É 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.
- Caminho do log da aplicação
-
Esse é o caminho (ou os caminhos) para a pasta ou o arquivo da aplicação que contém os logs que você deseja salvar. Especifique cada caminho de log em relação ao caminho base da aplicação. Se você usar esse recurso, no final de cada sessão de stream, o Amazon GameLift Streams copiará os arquivos que você especificar para o bucket do Amazon S3 que você nomear. A operação de cópia não é realizada recursivamente nas subpastas da pasta de uma 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.
- Saída do log da aplicação
-
Esse é o URI para o 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 receber permissão para que seu bucket do S3 salve. 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.
Para obter mais informações, consulte Política de permissão do repositório de registros de aplicativos.
- Tags
-
As tags são rótulos que podem ajudar você a organizar seus AWS recursos. Para obter mais informações, consulte Como marcar seus recursos da AWS.
Por exemplo, para rastrear as versões do aplicativo, use uma tag comoapplication-version : my-game-1121.
-
Escolha Salvar alterações. O console do Amazon GameLift Streams retorna à página de detalhes do aplicativo, exibindo as configurações atualizadas.
- CLI
-
Pré-requisito
Você deve configurar o AWS CLI com suas credenciais de usuário e as escolhidas Região da AWS. Para obter instruções de configuração, consulteBaixe o AWS CLI.
Para editar um aplicativo usando o AWS CLI
Em seu AWS CLI uso, o UpdateApplicationcomando, personalizado para o seu conteúdo.
aws gameliftstreams update-application \
--identifier a-9ZY8X7Wv6 \
--description "MyGame v2" \
--application-log-paths '[".\\logs"]' \
--application-log-output-uri "s3://amzn-s3-demo-bucket/mygame"
para onde
-
identifier: O aplicativo a ser editado.
Esse valor é um nome de recurso da Amazon (ARN) ou ID que identifica de forma exclusiva o recurso do aplicativo.
Exemplo de ARN: arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6
Exemplo de ID: a-9ZY8X7Wv6
-
description:
É 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.
-
application-log-paths:
Esse é o caminho (ou os caminhos) para a pasta ou o arquivo da aplicação que contém os logs que você deseja salvar. Especifique cada caminho de log em relação ao caminho base da aplicação. Se você usar esse recurso, no final de cada sessão de stream, o Amazon GameLift Streams copiará os arquivos que você especificar para o bucket do Amazon S3 que você nomear. A operação de cópia não é realizada recursivamente nas subpastas da pasta de uma 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.
-
application-log-output-uri:
Esse é o URI para o 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 receber permissão para que seu bucket do S3 salve. 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.
Para obter mais informações, consulte Política de permissão do repositório de registros de aplicativos.
Excluir uma aplicação do
Exclua um aplicativo se você não precisar mais dele. Essa ação exclui permanentemente o aplicativo, incluindo os arquivos de conteúdo do aplicativo armazenados no Amazon GameLift Streams. No entanto, isso não exclui os arquivos originais que você carregou no seu bucket do Amazon S3; você pode excluí-los a qualquer momento após o Amazon GameLift Streams criar um aplicativo, que é a única vez que o Amazon GameLift Streams acessa seu bucket do Amazon S3.
Você só pode excluir um aplicativo que atenda às seguintes condições:
-
O aplicativo está no estado Pronto ou com Erro.
-
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.
Se o aplicativo estiver vinculado a algum grupo de stream, você deverá desvinculá-lo de todos os grupos de stream associados antes de excluí-lo. No console, uma caixa de diálogo o guiará por esse processo.
- Console
-
Para excluir um aplicativo usando o console do Amazon GameLift Streams
-
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 dos 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.
- CLI
-
Pré-requisito
Você deve configurar o AWS CLI com suas credenciais de usuário e as escolhidas Região da AWS. Para obter instruções de configuração, consulteBaixe o AWS CLI.
Para excluir um aplicativo usando o AWS CLI
Em seu AWS CLI uso, o DeleteApplicationcomando, personalizado para o seu conteúdo.
aws gameliftstreams delete-application \
--identifier arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6
para onde
-
identifier: O aplicativo a ser excluído.
Esse valor é um nome de recurso da Amazon (ARN) ou ID que identifica de forma exclusiva o recurso do aplicativo.
Exemplo de ARN: arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6
Exemplo de ID: a-9ZY8X7Wv6
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.
Política de permissão do repositório de registros de aplicativos
Se você fornecer seu próprio bucket Amazon S3 de log de aplicativos, precisará aplicar uma política de permissão ao bucket para que o Amazon GameLift Streams possa salvar arquivos de log no bucket. Use o modelo a seguir para atualizar as permissões no Amazon S3.
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": "your 12-digit account id"
}
}
}
]
}
O Amazon GameLift Streams não permite o acesso a recursos entre contas. O bucket do Amazon S3 deve pertencer à mesma AWS conta do recurso do aplicativo. Embora isso seja fortemente imposto pelo serviço, é uma prática recomendada sempre incluir aws:SourceAccount aws:SourceArn condições para evitar o problema confuso de deputados ao conceder permissão a qualquer AWS serviço.
Grupos de stream vinculados
Se quiser transmitir vários aplicativos usando o mesmo pool de recursos computacionais, você pode vincular vários aplicativos ao mesmo grupo de stream. Da mesma forma, se você quiser transmitir um aplicativo usando diferentes conjuntos de recursos computacionais, poderá vincular um aplicativo a vários grupos de stream.
Para obter mais informações sobre como vincular aplicativos a grupos de streaming, consulte. Visão geral dos grupos de streams de vários aplicativos