Schritt 4. Konfigurieren Sie Ihre Website für die Integration mit WorkSpaces Amazon-Anwendungen - WorkSpaces Amazon-Anwendungen
Importieren Sie die JavaScript Appstream-Embed-DateiInitialisieren und Konfigurieren des Schnittstellenobjekts AppStream.EmbedBeispiele für das Ausblenden von Elementen in der Benutzeroberfläche der WorkSpaces Anwendung

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

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

Importieren Sie die JavaScript Appstream-Embed-Datei

  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>

  2. Als nächstes erstellen Sie ein leeres Container-div. Die ID des DIV, das Sie festgelegt haben, wird an den Konstruktor zum Einbetten von WorkSpaces Anwendungen ü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

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 oder dem create-streaming-url 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.

Typ: Map (key:value)

Required: No

Beispiele für das Ausblenden von Elementen in der Benutzeroberfläche der WorkSpaces Anwendung

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.

Beispiel 1: Die gesamte WorkSpaces Anwendungssymbolleiste ausblenden

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

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

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