Etapa 4: Configure seu site para integração com os WorkSpaces aplicativos da Amazon - WorkSpaces Aplicativos da Amazon
Importar o arquivo JavaScript appstream-embedInicializar e configurar o objeto de interface AppStream.EmbedExemplos para ocultar itens na interface de usuário do WorkSpaces aplicativo

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 os WorkSpaces aplicativos da Amazon

As seções a seguir fornecem informações sobre como configurar sua página da web para hospedar sessões de streaming de WorkSpaces aplicativos incorporados.

Importar o arquivo JavaScript appstream-embed

  1. Na página da Web em que você planeja incorporar a sessão de streaming de WorkSpaces Aplicativos, 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 é passado para o construtor de incorporação de WorkSpaces aplicativos. 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 URL de streaming 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 por seus próprios valores.

nota

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

sessionUrl

O URL de streaming que você criou usando o console de WorkSpaces aplicativos, a ação da API de CreateStreamingURL ou o comando da create-streaming-url 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 do usuário que ficam inicialmente ocultos quando a sessão de streaming de WorkSpaces aplicativos incorporados é 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 do WorkSpaces aplicativo

Os exemplos nesta seção mostram como ocultar itens na interface de usuário dos WorkSpaces aplicativos dos usuários durante as sessões de streaming de WorkSpaces aplicativos incorporados.

Exemplo 1: ocultar toda a barra de ferramentas de WorkSpaces aplicativos

Para impedir que os usuários acessem qualquer botão na barra de ferramentas de WorkSpaces aplicativos 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 de WorkSpaces aplicativos.

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 de WorkSpaces aplicativos

Você pode exibir a barra de ferramentas de WorkSpaces aplicativos 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 de WorkSpaces aplicativos

Você pode exibir a barra de ferramentas de WorkSpaces aplicativos 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]}
 };