Schritt 4. Konfigurieren Sie Ihre Website für die Integration mit Amazon AppStream 2.0 - Amazon AppStream 2.0

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 Amazon AppStream 2.0

Die folgenden Abschnitte enthalten Informationen darüber, wie Sie Ihre Webseite für das Hosten von eingebetteten AppStream 2.0-Streaming-Sitzungen konfigurieren können.

Importieren Sie die JavaScript Appstream-Embed-Datei

  1. Importieren Sie auf der Webseite, auf der Sie die AppStream 2.0-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 von Ihnen festgelegten Divs wird an den AppStream 2.0-Einbettungskonstruktor ü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 das 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 and userInterfaceConfig mit deinen eigenen Werten.

Anmerkung

Der angegebene Wert für userInterfaceConfig blendet die gesamte AppStream 2.0-Symbolleiste aus. Dieser Wert, der als Beispiel enthalten ist, ist optional.

sessionUrl

Das StreamingURL, das Sie mit der AppStream 2.0-Konsole, der CreateStreamingURLAPIAktion oder dem create-streaming-url AWS CLIBefehl 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 bei der Initialisierung der Embedded AppStream 2.0-Streamingsitzung zunächst ausgeblendet werden. 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 AppStream 2.0-Benutzeroberfläche

Die Beispiele in diesem Abschnitt zeigen, wie Sie Elemente in der AppStream 2.0-Benutzeroberfläche vor Benutzern während ihrer Embedded AppStream 2.0-Streaming-Sitzungen verbergen können.

Beispiel 1: Die gesamte AppStream 2.0-Symbolleiste ausblenden

Um zu verhindern, dass Benutzer während eingebetteter Streaming-Sitzungen auf eine Schaltfläche auf der AppStream 2.0-Symbolleiste zugreifen, verwenden Sie die AppStream.Embed.Elements.TOOLBAR Konstante. Mit dieser Konstante können Sie alle AppStream 2.0-Symbolleistenschaltflächen 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: Eine bestimmte Schaltfläche auf der AppStream 2.0-Symbolleiste ausblenden

Sie können die AppStream 2.0-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 AppStream 2.0-Symbolleiste

Sie können die AppStream 2.0-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]} };