Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Schritt 4. Konfigurieren Sie Ihre Website für die Integration mit WorkSpaces Amazon-Anwendungen
<a name="configure-website-for-integration"></a>

Die folgenden Abschnitte enthalten Informationen zur Konfiguration Ihrer Webseite für das Hosten eingebetteter WorkSpaces Anwendungs-Streaming-Sitzungen.

**Topics**
+ [Importieren Sie die JavaScript Appstream-Embed-Datei](#import-embed-javascript-file)
+ [Initialisieren und Konfigurieren des Schnittstellenobjekts `AppStream.Embed`](#initialize-configure-embed-interface-object)
+ [Beispiele für das Ausblenden von Elementen in der Benutzeroberfläche der WorkSpaces Anwendung](#examples-hiding-user-interface-items)

## Importieren Sie die JavaScript Appstream-Embed-Datei
<a name="import-embed-javascript-file"></a>

1. Importieren Sie auf der Webseite, auf der Sie die WorkSpaces Anwendungs-Streaming-Sitzung einbetten möchten, die Datei **appstream-embed.js** in die Webseite, indem Sie den folgenden Code hinzufügen:

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

1. Als nächstes erstellen Sie ein leeres Container-div. Die ID des DIV, das Sie festgelegt haben, wird an den WorkSpaces Applications Embed-Konstruktor übergeben. Es wird dann verwendet, um einen iframe für die Streaming-Sitzung zu einzufügen. Um das div zu erstellen, fügen Sie den folgenden Code hinzu:

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

## Initialisieren und Konfigurieren des Schnittstellenobjekts `AppStream.Embed`
<a name="initialize-configure-embed-interface-object"></a>

Um das `AppStream.Embed` Schnittstellenobjekt in zu initialisieren JavaScript, müssen Sie Code hinzufügen, der ein `AppStream.Embed` Objekt mit Optionen für die Streaming-URL und die Konfiguration der Benutzeroberfläche erstellt. Diese Optionen und die von Ihnen erstellte div-ID werden in einem Objekt namens `appstreamOptions` gespeichert.

Der folgende Beispielcode zeigt, wie das Schnittstellenobjekt `AppStream.Embed` initialisiert wird.

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

Ersetzen Sie im Code *sessionURL* und *userInterfaceConfig* durch Ihre eigenen Werte. 

**Anmerkung**  
Der für angegebene Wert *userInterfaceConfig* verbirgt die gesamte WorkSpaces Anwendungssymbolleiste. Dieser Wert, der als Beispiel enthalten ist, ist optional.

***sessionUrl***  
Die Streaming-URL, die Sie mit der WorkSpaces Anwendungskonsole, der [CreateStreamingURL-API-Aktion](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStreamingURL.html) oder dem [create-streaming-url](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-streaming-url.html) AWS CLI-Befehl erstellt haben. Bei diesem Parameter wird zwischen Groß- und Kleinschreibung unterschieden.  
**Typ:** Zeichenfolge  
**Erforderlich**: Ja

***userInterfaceConfig***  
Die Konfiguration, die den Anfangszustand der Benutzeroberflächenelemente generiert. Die Konfiguration ist ein Schlüssel-Wert-Paar.   
Der Schlüssel,`AppStream.Embed.Options.HIDDEN_ELEMENTS`, gibt die Benutzeroberflächenobjekte an, die zunächst ausgeblendet sind, wenn die eingebettete WorkSpaces Anwendungs-Streaming-Sitzung initialisiert wird. Später können Sie mithilfe des Parameters `getInterfaceState` sowohl ausgeblendete als auch sichtbare Objekte zurückgeben.  
Der Wert ist ein Array von Konstanten (Symbolleistenschaltflächen). Eine Liste der Konstanten, die Sie verwenden können, finden Sie unter [Arbeiten mit `HIDDEN_ELEMENTS`](constants-functions-events-embedded-sessions.md#constants-hidden-elements).  
**Typ**: Map (*key*:*value*)  
**Required**: No

## Beispiele für das Ausblenden von Elementen in der Benutzeroberfläche der WorkSpaces Anwendung
<a name="examples-hiding-user-interface-items"></a>

Die Beispiele in diesem Abschnitt zeigen, wie Sie Elemente in der WorkSpaces Anwendungsbenutzeroberfläche vor Benutzern während ihrer eingebetteten WorkSpaces Anwendungs-Streaming-Sitzungen verbergen können.

**Topics**
+ [Beispiel 1: Die gesamte WorkSpaces Anwendungssymbolleiste ausblenden](#example-hide-the-entire-tooolbar)
+ [Beispiel 2: Blenden Sie eine bestimmte Schaltfläche auf der WorkSpaces Anwendungssymbolleiste aus](#example-hide-a-specific-toolbar-button)
+ [Beispiel 3: Verbergen Sie mehrere Schaltflächen auf der WorkSpaces Anwendungssymbolleiste](#example-hide-multiple-toolbar-buttons)

### Beispiel 1: Die gesamte WorkSpaces Anwendungssymbolleiste ausblenden
<a name="example-hide-the-entire-tooolbar"></a>

Verwenden Sie die `AppStream.Embed.Elements.TOOLBAR` Konstante, um zu verhindern, dass Benutzer während eingebetteter Streaming-Sitzungen auf eine Schaltfläche auf der Anwendungssymbolleiste zugreifen. WorkSpaces Mit dieser Konstante können Sie alle Schaltflächen der WorkSpaces Anwendungssymbolleiste ausblenden.

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

### Beispiel 2: Blenden Sie eine bestimmte Schaltfläche auf der WorkSpaces Anwendungssymbolleiste aus
<a name="example-hide-a-specific-toolbar-button"></a>

Sie können die WorkSpaces Anwendungs-Symbolleiste anzeigen und gleichzeitig verhindern, dass Benutzer während eingebetteter Streaming-Sitzungen auf eine bestimmte Schaltfläche in der Werkzeugleiste zugreifen. Geben Sie dazu die Konstante für die Schaltfläche an, die ausgeblendet werden soll. Im folgenden Code wird die Konstante `AppStream.Embed.Elements.FILES_BUTTON` zum Ausblenden der Schaltfläche **My Files (Eigene Dateien)** verwendet. Dadurch wird verhindert, dass Benutzer während eingebetteter Streaming-Sitzungen auf persistente Speicheroptionen zugreifen.

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

### Beispiel 3: Verbergen Sie mehrere Schaltflächen auf der WorkSpaces Anwendungssymbolleiste
<a name="example-hide-multiple-toolbar-buttons"></a>

Sie können die WorkSpaces Anwendungs-Symbolleiste anzeigen und gleichzeitig verhindern, dass Benutzer während eingebetteter Streaming-Sitzungen auf mehr als eine Schaltfläche in der Werkzeugleiste zugreifen. Geben Sie dazu die Konstanten für die Schaltflächen an, die ausgeblendet werden sollen. Im folgenden Code werden die Konstanten `AppStream.Embed.Elements.END_SESSION_BUTTON` und `AppStream.Embed.Elements.FULLSCREEN_BUTTON` verwendet, um die Schaltflächen **End Session (Sitzung beenden)** und **Fullscreen (Vollbild)** auszublenden. 

**Anmerkung**  
Trennen Sie jede Konstante durch ein Komma, ohne vorherige oder folgende Leerzeichen.

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