Etapa 4. Configurar o site para a integração com o Amazon AppStream 2.0 - Amazon AppStream 2.0
Importar o arquivo JavaScript incorporado ao appstreamInicializar e configurar o objeto de interface AppStream.EmbedExemplos para ocultar itens na interface de usuário do AppStream 2.0

Etapa 4. Configurar o site para a integração com o Amazon AppStream 2.0

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

Importar o arquivo JavaScript incorporado ao appstream

  1. Na página da web onde você pretende incorporar a sessão de streaming do 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ê define é enviado ao construtor incorporado do 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 interface AppStream.Embed em JavaScript, você deve adicionar o código que cria um objeto AppStream.Embed com opções para o URL de streaming e a configuração de 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 por seus próprios valores.

nota

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

sessionUrl

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

Tipo: 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 de usuário que ficam ocultos quando a sessão de streaming incorporada do AppStream 2.0 é 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 (chave:valor)

Obrigatório: não

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

Os exemplos desta seção mostram como ocultar itens da interface de usuário do AppStream 2.0 durante as sessões de streaming incorporadas do AppStream 2.0.

Exemplo 1: ocultar toda a barra de ferramentas do AppStream 2.0

Para evitar que os usuários acessem os botões na barra de ferramentas do AppStream 2.0 durante sessões de streaming incorporadas, use a constante AppStream.Embed.Elements.TOOLBAR. Essa constante permite ocultar todos os botões da barra de ferramentas do 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 do AppStream 2.0

Você pode exibir a barra de ferramentas do AppStream 2.0 e, ao mesmo tempo, impedir que os usuários acessem um botão específico da barra de ferramentas durante 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 do AppStream 2.0

Você pode exibir a barra de ferramentas do AppStream 2.0 e, ao mesmo tempo, impedir que os usuários acessem mais de um botão da barra de ferramentas durante 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]}
 };