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 segue as seguintes limitações.
Nome |
Padrão |
Ajustável |
Descrição |
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 AWS Management Console 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 AWS Management Console 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 o jogo ou outro software que você deseja transmitir e as configurações para executá-lo. Ao criar um aplicativo, você fornece o caminho para os arquivos do aplicativo que você carregou no seu bucket do Amazon S3.
O Amazon GameLift Streams não sincroniza automaticamente seus arquivos de jogo do bucket Amazon S3 que você criou. Se quiser atualizar seus arquivos de jogo, 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 AWS Management Console 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 AWS Management Console 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
É o ambiente de runtime no qual você pode executar a aplicação. O Amazon GameLift Streams pode ser executado em Windows, Ubuntu 22.04 LTS ou 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 ajudar você a selecionar o ambiente de runtime ideal para a aplicação.
-
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. 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.
-
Caminho de lançamento executável
Esse é o URI do Amazon S3 para o arquivo executável que o Amazon GameLift Streams transmitirá. O arquivo deve estar contido na pasta raiz da aplicação.
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 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 desativar o registro, remova todos os caminhos do registro do aplicativo e limpe o destino de saída do registro do aplicativo.
É 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 se você especifica um caminho para os logs da aplicação.
Para desativar o registro, remova todos os caminhos do registro do aplicativo e limpe o destino de saída do registro do aplicativo.
É 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 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": "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 ter mais informações, consulte Marcar seus recursos da AWS.
Por exemplo, para rastrear versões de aplicações, use uma tag, como application-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
:
É o ambiente de runtime no qual você pode executar a aplicação. O Amazon GameLift Streams pode ser executado em Windows, Ubuntu 22.04 LTS ou 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 .
-
executable-path
:
Esse é o caminho para o arquivo executável que o Amazon GameLift Streams transmitirá. Especifique um caminho relativo aoapplication-source-uri
. O arquivo deve estar contido na pasta raiz da aplicação.
Não é possível editar esse campo após o fluxo de trabalho de criaçã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. 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.
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 dos logs da aplicação
-
Esse é o caminho (ou 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 desativar o registro, remova todos os caminhos do registro do aplicativo e limpe o destino de saída do registro do aplicativo.
É 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 se você especifica um caminho para os logs da aplicação.
Para desativar o registro, remova todos os caminhos do registro do aplicativo e limpe o destino de saída do registro do aplicativo.
É 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 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.
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 ter mais informações, consulte Marcar seus recursos da AWS.
Por exemplo, para rastrear versões de aplicações, use uma tag, como application-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 exclusivamente 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 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 desativar o registro, remova todos os caminhos do registro do aplicativo e limpe o destino de saída do registro do aplicativo.
É 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 se você especifica um caminho para os logs da aplicação.
Para desativar o registro, remova todos os caminhos do registro do aplicativo e limpe o destino de saída do registro do aplicativo.
É 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 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.
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.
É possível excluir apenas uma aplicação que atenda às seguintes condições:
-
A aplicação está no estado Pronto ou Erro.
-
Não está sendo realizado o streaming de uma aplicação 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 a aplicação estiver vinculada a qualquer grupo de transmissões, você deverá primeiro desvinculá-la de todos os grupos de transmissões associados para poder excluí-la. No console, uma caixa de diálogo conduzirá você por esse processo.
- Console
-
Para excluir um aplicativo usando o console do Amazon GameLift Streams
-
Faça login no AWS Management Console 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 exclusivamente 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 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 fluxos vinculados
Se você quiser fazer streaming de várias aplicações usando o mesmo grupo de recursos computacionais, poderá vincular várias aplicações ao mesmo grupo de transmissões. Da mesma forma, se você quiser fazer streaming de uma aplicação usando diferentes conjuntos de recursos computacionais, poderá vincular uma aplicação a vários grupos de fluxos.
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