Etapa 4. Configure seu site para integração com o Amazon AppStream 2.0 - Amazon AppStream 2.0
Importar o arquivo JavaScript appstream-embedInicializar e configurar o objeto de interface AppStream.EmbedExemplos para ocultar itens na interface de usuário AppStream 2.0

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

Etapa 4. Configure seu site para integração com o Amazon AppStream 2.0

As seções a seguir fornecem informações sobre como configurar sua página da Web para hospedar sessões de streaming AppStream 2.0 incorporadas.

Importar o arquivo JavaScript appstream-embed

  1. Na página da Web em que você planeja incorporar a sessão de streaming AppStream 2.0, importe o arquivo appstream-embed.js para a página da Web adicionando o seguinte código:

    <script type="text/javascript" src="./appstream_embed.js"> </script>

  2. Em seguida, crie um div de contêiner vazio. O ID do div que você definiu é passado para o construtor de incorporação AppStream 2.0. Ele é usado, então, para injetar um iframe à sessão de streaming. Para criar o div, adicione o seguinte código:

    <div id="appstream-container"> </div>

Inicializar e configurar o objeto de interface AppStream.Embed

Para inicializar o objeto de AppStream.Embed interface em JavaScript, você deve adicionar um código que crie um AppStream.Embed objeto com opções para o streaming URL e a configuração da interface do usuário. Essas opções e o ID do div que você criou são armazenados em um objeto chamado appstreamOptions.

O código de exemplo a seguir mostra como inicializar o objeto de interface AppStream.Embed.

var appstreamOptions = {
     sessionURL: 'https://appstream2.region.aws.amazon.com/authenticate?parameters=authenticationcode...',
     userInterfaceConfig:{[AppStream.Embed.Options.HIDDEN_ELEMENTS]:[AppStream.Embed.Elements.TOOLBAR]}
 };
 appstreamEmbed = new AppStream.Embed("appstream-container", appstreamOptions);

No código, substitua sessionURL e userInterfaceConfig com seus próprios valores.

nota

O valor especificado para userInterfaceConfig esconde toda a barra de ferramentas AppStream 2.0. Esse valor, que é incluído como exemplo, é opcional.

sessionUrl

O streaming URL que você criou usando o console AppStream 2.0, a CreateStreamingURLAPIação ou o create-streaming-url AWS CLIcomando. Esse parâmetro diferencia maiúsculas de minúsculas.

Type: string

Obrigatório: Sim

userInterfaceConfig

A configuração que gera o estado inicial dos elementos da interface do usuário. A configuração é um par de chave/valor.

A chave,AppStream.Embed.Options.HIDDEN_ELEMENTS, especifica os objetos da interface do usuário que ficam inicialmente ocultos quando a sessão de streaming AppStream 2.0 incorporada é inicializada. Posteriormente, você pode retornar objetos ocultos e visíveis usando o parâmetro getInterfaceState.

O valor é uma matriz de constantes (botões da barra de ferramentas). Para obter uma lista de constantes que podem ser usadas, consulte Trabalhar com o HIDDEN_ELEMENTS.

Tipo: Mapa (key:value)

Obrigatório: não

Exemplos para ocultar itens na interface de usuário AppStream 2.0

Os exemplos nesta seção mostram como ocultar itens na interface de usuário AppStream 2.0 dos usuários durante suas sessões de streaming AppStream 2.0 incorporadas.

Exemplo 1: ocultar toda a barra de ferramentas AppStream 2.0

Para impedir que os usuários acessem qualquer botão na barra de ferramentas AppStream 2.0 durante as sessões de streaming incorporadas, use a AppStream.Embed.Elements.TOOLBAR constante. Essa constante permite ocultar todos os botões da barra de ferramentas AppStream 2.0.

var appstreamOptions = {
     sessionURL: 'https://appstream2.region.aws.amazon.com/authenticate?parameters=authenticationcode...',
     userInterfaceConfig:{[AppStream.Embed.Options.HIDDEN_ELEMENTS]:[AppStream.Embed.Elements.TOOLBAR]}
 };

Exemplo 2: Ocultar um botão específico na barra de ferramentas AppStream 2.0

Você pode exibir a barra de ferramentas AppStream 2.0 e, ao mesmo tempo, impedir que os usuários acessem um botão específico da barra de ferramentas durante as sessões de streaming incorporadas. Para fazer isso, especifique a constante para o botão que você deseja ocultar. O código a seguir usa a constante AppStream.Embed.Elements.FILES_BUTTON para ocultar o botão My Files (Meus arquivos) . Isso impede que os usuários acessem opções de armazenamento persistente durante as sessões de streaming incorporadas.

var appstreamOptions = {
     sessionURL: 'https://appstream2.region.aws.amazon.com/authenticate?parameters=authenticationcode...',
     userInterfaceConfig:{[AppStream.Embed.Options.HIDDEN_ELEMENTS]:[AppStream.Embed.Elements.FILES_BUTTON]}
 };

Exemplo 3: Ocultar vários botões na barra de ferramentas AppStream 2.0

Você pode exibir a barra de ferramentas AppStream 2.0 e, ao mesmo tempo, impedir que os usuários acessem mais de um botão da barra de ferramentas durante as sessões de streaming incorporadas. Para fazer isso, especifique as constantes para os botões que você deseja ocultar. O código a seguir usa as constantes AppStream.Embed.Elements.END_SESSION_BUTTON e AppStream.Embed.Elements.FULLSCREEN_BUTTON para ocultar os botões End Session (Encerrar sessão) e Fullscreen (Modo de tela inteira).

nota

Separe cada constante com uma vírgula, sem espaço anterior ou posterior.

var appstreamOptions = {
     sessionURL: 'https://appstream2.region.aws.amazon.com/authenticate?parameters=authenticationcode... (https://appstream2.region.aws.amazon.com/#/)',
     userInterfaceConfig:{[AppStream.Embed.Options.HIDDEN_ELEMENTS]:[AppStream.Embed.Elements.END_SESSION_BUTTON,AppStream.Embed.Elements.FULLSCREEN_BUTTON]}
 };