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
<a name="configure-website-for-integration"></a>

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.

**Topics**
+ [Importar o arquivo JavaScript appstream-embed](#import-embed-javascript-file)
+ [Inicializar e configurar o objeto de interface `AppStream.Embed`](#initialize-configure-embed-interface-object)
+ [Exemplos para ocultar itens na interface de usuário do WorkSpaces aplicativo](#examples-hiding-user-interface-items)

## Importar o arquivo JavaScript appstream-embed
<a name="import-embed-javascript-file"></a>

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>
   ```

1. Em seguida, crie um div de contêiner vazio. O ID do div que você definiu é 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`
<a name="initialize-configure-embed-interface-object"></a>

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](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStreamingURL.html) ou o comando da [create-streaming-url](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-streaming-url.html) 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`](constants-functions-events-embedded-sessions.md#constants-hidden-elements).  
**Tipo**: Mapa (*key*:*value*)  
**Obrigatório**: não

## Exemplos para ocultar itens na interface de usuário do WorkSpaces aplicativo
<a name="examples-hiding-user-interface-items"></a>

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.

**Topics**
+ [Exemplo 1: ocultar toda a barra de ferramentas de WorkSpaces aplicativos](#example-hide-the-entire-tooolbar)
+ [Exemplo 2: Ocultar um botão específico na barra de ferramentas de WorkSpaces aplicativos](#example-hide-a-specific-toolbar-button)
+ [Exemplo 3: Ocultar vários botões na barra de ferramentas de WorkSpaces aplicativos](#example-hide-multiple-toolbar-buttons)

### Exemplo 1: ocultar toda a barra de ferramentas de WorkSpaces aplicativos
<a name="example-hide-the-entire-tooolbar"></a>

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
<a name="example-hide-a-specific-toolbar-button"></a>

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
<a name="example-hide-multiple-toolbar-buttons"></a>

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]}
 };
```