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

Compartilhe sessões de stream com URLs de stream

Os URLs de transmissão permitem que você compartilhe rapidamente suas sessões de transmissão com qualquer pessoa. Os destinatários acessam suas sessões de stream em um navegador da Web compatível, sem necessidade Conta da AWS de integração com o cliente, e você controla a expiração, o uso e a revogação. Depois de criar um URL de stream, qualquer pessoa que o acesse inicia sua própria sessão de stream sem precisar de nenhuma credencial. Os URLs de streaming são ideais para configurar demonstrações, testes de jogo, avaliações de partes interessadas e acesso de convidados de forma rápida e fácil.

Como funcionam os URLs de stream

Uma URL de stream une um grupo de stream (a capacidade que executa o stream) e um aplicativo nesse grupo de stream (o conteúdo a ser executado). Quando você cria um URL de stream, o Amazon GameLift Streams retorna um URL de stream no seguinte formato:

https://gameliftstreams.aws.com/su-1AB2C3De4/stream?token=EXAMPLETOKEN

O fluxo de trabalho tem quatro etapas:

Como o URL do stream não é autenticado, o usuário final nunca vê nem precisa de suas AWS credenciais. O serviço encaminha cada usuário final para um local próximo com base na preferência de localização de streaming que você definiu no momento da criação. O Amazon GameLift Streams reordena seus locais de streaming preferidos por proximidade, mas nunca adiciona locais que você não incluiu.

A experiência do usuário final

Os usuários com quem você compartilha um URL de stream não precisam Conta da AWS de instalação de nenhum software. Eles abrem a URL em um navegador compatível e transmitem a partir de uma página da web que o Amazon GameLift Streams hospeda para você. O streaming usa WebRTC e tem os mesmos requisitos de navegador e dispositivo do cliente Amazon GameLift Streams Web SDK. Para ver os navegadores compatíveis e as versões mínimas, consulteDispositivos GameLift e navegadores compatíveis com Amazon Streams. Se o grupo de streams não tiver capacidade disponível quando um usuário final abrir a URL, a página mostrará uma mensagem de que o stream está temporariamente esgotado e o usuário final poderá tentar novamente. Se o usuário final tentar fechar ou recarregar a guia, a página solicitará que ele confirme, pois sair da página encerra a sessão.

Pré-requisitos

Antes de criar um URL de stream, você precisa do seguinte:

Criação de um URL de stream

O AWS CLI exemplo a seguir cria uma URL de stream para um aplicativo em um grupo de stream. O URL do stream é válido por duas horas e pode ser usado até cinco vezes, além de preferir os us-east-1 locais us-west-2 e.

aws gameliftstreams create-stream-url \
    --identifier sg-1AB2C3De4 \
    --application-identifier a-9ZY8X7Wv6 \
    --protocol WebRTC \
    --url-expires-after-minutes 120 \
    --usage-limit 5 \
    --locations us-west-2 us-east-1 \
    --description "Preview build - reviewer invites"

Uma chamada bem-sucedida retorna o recurso de URL do stream, incluindo seu StreamUrlId (prefixadosu-), seu ARN, o compartilhável completoStreamUrl, o tempo de expiração calculado e os usos iniciais restantes.

{
    "StreamUrlId": "su-1AB2C3De4",
    "Arn": "arn:aws:gameliftstreams:us-west-2:111122223333:streamurl/sg-1AB2C3De4/su-1AB2C3De4",
    "StreamUrl": "https://gameliftstreams.aws.com/su-1AB2C3De4/stream?token=EXAMPLETOKEN",
    "Status": "ACTIVE",
    "UsageLimit": 5,
    "RemainingUses": 5,
    "ExpiresAt": "2026-07-31T20:00:00+00:00"
}

Os seguintes parâmetros são obrigatórios:

Os parâmetros a seguir são opcionais. Todas as configurações de sessão fornecidas são congeladas no URL do stream no momento da criação e aplicadas a todas as sessões iniciadas a partir do URL do stream.

Monitorando seus URLs de stream

Use GetStreamUrl para recuperar um único URL de stream. Especifique o grupo de stream com --identifier e o URL do stream com --stream-url-identifier (um ID de URL de stream ou ARN). Além da configuração do URL do stream, current e StatusRemainingUses, a resposta inclui uma StreamSessions lista das sessões iniciadas a partir dele, para que você possa ver quem está transmitindo ativamente.

aws gameliftstreams get-stream-url \
    --identifier sg-1AB2C3De4 \
    --stream-url-identifier su-1AB2C3De4

Use ListStreamUrls para enumerar os URLs do stream em sua conta. Você pode filtrar por Status e por grupo de streams e percorrer os resultados com MaxResults (1—100, padrão 25) e. NextToken

aws gameliftstreams list-stream-urls \
    --status ACTIVE \
    --stream-group-identifier sg-1AB2C3De4

Você também pode auditar a atividade de gerenciamento de URL do stream em CloudTrail. CloudTrail grava chamadas para CreateStreamUrlGetStreamUrl,ListStreamUrls, e RevokeStreamUrl como eventos de dados. Um usuário final abrindo um URL de stream e iniciando uma sessão não é uma de suas chamadas de API e não é registrado como CloudTrail atividade do cliente. Para obter mais informações, consulte Registro de chamadas de API do Amazon GameLift Streams usando AWS CloudTrail.

Revogar um URL de stream

Revogue um URL de stream quando quiser impedir que ele inicie mais sessões, por exemplo, quando um período de visualização terminar ou quando ele tiver sido compartilhado involuntariamente.

RevokeStreamUrlleva umRevocationMode:

aws gameliftstreams revoke-stream-url \
    --identifier sg-1AB2C3De4 \
    --stream-url-identifier su-1AB2C3De4 \
    --revocation-mode REVOKE_AND_TERMINATE_SESSIONS

Um URL de stream revogado passa para o REVOKED status e não pode ser reativado. Crie um novo URL de stream se precisar retomar o compartilhamento.

O Amazon GameLift Streams também revoga automaticamente um URL de stream quando um recurso do qual ele depende é excluído. A exclusão do grupo de streams revoga todos os URLs de stream nesse grupo de stream, e a exclusão do aplicativo revoga todos os URLs de stream que fazem referência a esse aplicativo. Em ambos os casos, o URL do stream é movido para REVOKED com um motivo de status que identifica o recurso excluído.

Ciclo de vida e status do URL do stream

Um URL de stream é ACTIVE criado e permanece assim até expirar, ficar sem uso ou ser revogado. Nunca volta ACTIVE depois de deixar esse estado.

Quando o URL de um stream éREVOKED, GetStreamUrl e ListStreamUrls também retorna um motivo de status que explica o porquê.

Diferenças das sessões com as quais você começa StartStreamSession

As sessões iniciadas a partir de um URL de stream são executadas na mesma infraestrutura das sessões que você mesmo inicia, mas são ajustadas para reprodução curta, sem intervenção e em um único visualizador. Lembre-se dessas diferenças:

Solução de problemas

O Amazon GameLift Streams oculta deliberadamente dos usuários finais o motivo específico de uma falha na ativação do URL do stream. Um usuário final que abre um URL de stream que não pode iniciar um stream sempre vê uma página genérica “não encontrada” ou uma mensagem “na capacidade máxima”, independentemente da causa subjacente. Para diagnosticar a causa real, inspecione o URL do stream do lado do criador com GetStreamUrl eListStreamUrls, verifique o motivo do status Status e revise a atividade da API do URL do stream em. CloudTrail