Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Passaggio 4. Configura il tuo sito Web per l'integrazione con WorkSpaces le applicazioni Amazon
<a name="configure-website-for-integration"></a>

Le seguenti sezioni forniscono informazioni su come configurare la pagina Web per ospitare sessioni di streaming di WorkSpaces Applicazioni integrate.

**Topics**
+ [Importa il file JavaScript appstream-embed](#import-embed-javascript-file)
+ [Inizializzare e configurare l'oggetto di interfaccia `AppStream.Embed`](#initialize-configure-embed-interface-object)
+ [Esempi per nascondere elementi nell'interfaccia utente delle WorkSpaces applicazioni](#examples-hiding-user-interface-items)

## Importa il file JavaScript appstream-embed
<a name="import-embed-javascript-file"></a>

1. Nella pagina Web in cui intendi incorporare la sessione di streaming WorkSpaces delle applicazioni, importa il file **appstream-embed.js** nella pagina Web aggiungendo il codice seguente:

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

1. Quindi, crea un div container vuoto. L'ID del div impostato viene passato al costruttore WorkSpaces Applications embed. Viene quindi utilizzato per inserire un iframe per la sessione di streaming. Per creare il div, aggiungere il seguente codice:

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

## Inizializzare e configurare l'oggetto di interfaccia `AppStream.Embed`
<a name="initialize-configure-embed-interface-object"></a>

Per inizializzare l'oggetto dell'`AppStream.Embed`interfaccia in JavaScript, è necessario aggiungere il codice che crei un `AppStream.Embed` oggetto con opzioni per l'URL di streaming e la configurazione dell'interfaccia utente. Queste opzioni e l'ID div creato vengono memorizzati in un oggetto chiamato `appstreamOptions`.

Il codice di esempio seguente mostra come inizializzare l'oggetto di interfaccia `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);
```

Nel codice, sostituisci *sessionURL* e *userInterfaceConfig* con i tuoi valori. 

**Nota**  
Il valore specificato per *userInterfaceConfig* nasconde l'intera barra degli strumenti WorkSpaces Applicazioni. Questo valore, incluso come esempio, è facoltativo.

***sessionUrl***  
L'URL di streaming che hai creato utilizzando la console WorkSpaces Applicazioni, l'azione API [CreateStreamingURL](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStreamingURL.html) o il comando [create-streaming-url](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-streaming-url.html) AWS CLI. Questo parametro prevede la distinzione tra maiuscole e minuscole.  
▬**Tipo:** stringa  
**Obbligatorio:** sì

***userInterfaceConfig***  
La configurazione che genera lo stato iniziale degli elementi dell'interfaccia utente. La configurazione è una coppia chiave-valore.   
La chiave`AppStream.Embed.Options.HIDDEN_ELEMENTS`, specifica gli oggetti dell'interfaccia utente inizialmente nascosti quando viene inizializzata la sessione di streaming WorkSpaces delle Applicazioni incorporate. Successivamente, è possibile restituire oggetti nascosti e visibili utilizzando il parametro `getInterfaceState`.  
Il valore è un array di costanti (pulsanti della barra degli strumenti). Per un elenco di costanti che è possibile utilizzare, consulta [Utilizzo di `HIDDEN_ELEMENTS`](constants-functions-events-embedded-sessions.md#constants-hidden-elements).  
**Tipo**: Mappa (:) *key* *value*  
**Obbligatorio:** no

## Esempi per nascondere elementi nell'interfaccia utente delle WorkSpaces applicazioni
<a name="examples-hiding-user-interface-items"></a>

Gli esempi in questa sezione mostrano come nascondere gli elementi nell'interfaccia utente delle WorkSpaces Applicazioni agli utenti durante le sessioni di streaming WorkSpaces delle Applicazioni incorporate.

**Topics**
+ [Esempio 1: Nascondi l'intera barra degli strumenti WorkSpaces delle Applicazioni](#example-hide-the-entire-tooolbar)
+ [Esempio 2: nasconde un pulsante specifico nella barra degli strumenti WorkSpaces Applicazioni](#example-hide-a-specific-toolbar-button)
+ [Esempio 3: nascondere più pulsanti nella barra degli strumenti delle WorkSpaces Applicazioni](#example-hide-multiple-toolbar-buttons)

### Esempio 1: Nascondi l'intera barra degli strumenti WorkSpaces delle Applicazioni
<a name="example-hide-the-entire-tooolbar"></a>

Per impedire agli utenti di accedere a qualsiasi pulsante della barra degli strumenti WorkSpaces delle Applicazioni durante le sessioni di streaming incorporate, usa la `AppStream.Embed.Elements.TOOLBAR` costante. Questa costante consente di nascondere tutti i pulsanti della barra degli strumenti WorkSpaces delle Applicazioni.

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

### Esempio 2: nasconde un pulsante specifico nella barra degli strumenti WorkSpaces Applicazioni
<a name="example-hide-a-specific-toolbar-button"></a>

È possibile visualizzare la barra degli strumenti WorkSpaces delle Applicazioni, impedendo al contempo agli utenti di accedere a un pulsante specifico della barra degli strumenti durante le sessioni di streaming incorporate. A tale scopo, specifica la costante del pulsante da nascondere. Il codice seguente utilizza la costante `AppStream.Embed.Elements.FILES_BUTTON` per nascondere il pulsante **My Files (File)**. Ciò impedisce agli utenti di accedere alle opzioni di storage persistente durante le sessioni di streaming incorporate.

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

### Esempio 3: nascondere più pulsanti nella barra degli strumenti delle WorkSpaces Applicazioni
<a name="example-hide-multiple-toolbar-buttons"></a>

È possibile visualizzare la barra degli strumenti WorkSpaces delle Applicazioni, impedendo al contempo agli utenti di accedere a più di un pulsante della barra degli strumenti durante le sessioni di streaming incorporate. A tale scopo, specifica le costanti dei pulsanti da nascondere. Il codice seguente utilizza le costanti `AppStream.Embed.Elements.END_SESSION_BUTTON` e `AppStream.Embed.Elements.FULLSCREEN_BUTTON` per nascondere i pulsanti **End Session (Termina sessione)** e **Fullscreen (Schermo intero)**. 

**Nota**  
Separa ogni costante con una virgola, senza spazio precedente o successivo.

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