Fase 4. Configura il tuo sito Web per l'integrazione con Amazon AppStream 2.0 - Amazon AppStream 2.0
Importa il file JavaScript appstream-embedInizializzare e configurare l'oggetto di interfaccia AppStream.EmbedEsempi per nascondere elementi nell'interfaccia utente AppStream 2.0

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à.

Fase 4. Configura il tuo sito Web per l'integrazione con Amazon AppStream 2.0

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

Importa il file JavaScript appstream-embed

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

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

  2. Quindi, crea un div container vuoto. L'ID del div impostato viene passato al costruttore embed AppStream 2.0. 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

Per inizializzare l'oggetto dell'AppStream.Embedinterfaccia in JavaScript, è necessario aggiungere il codice che crei un AppStream.Embed oggetto con opzioni per lo streaming URL 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 AppStream 2.0. Questo valore, incluso come esempio, è facoltativo.

sessionUrl

Lo streaming URL creato utilizzando la console AppStream 2.0, l'CreateStreamingURLAPIazione o il create-streaming-url AWS CLIcomando. Questo parametro prevede la distinzione tra maiuscole e minuscole.

Tipo: Stringa

Campo obbligatorio: sì

userInterfaceConfig

La configurazione che genera lo stato iniziale degli elementi dell'interfaccia utente. La configurazione è una coppia chiave-valore.

La chiaveAppStream.Embed.Options.HIDDEN_ELEMENTS, specifica gli oggetti dell'interfaccia utente che vengono inizialmente nascosti quando viene inizializzata la sessione di streaming AppStream 2.0 incorporata. 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.

Tipo: Mappa (key:value)

Required: No

Esempi per nascondere elementi nell'interfaccia utente AppStream 2.0

Gli esempi in questa sezione mostrano come nascondere gli elementi dell'interfaccia utente AppStream 2.0 agli utenti durante le sessioni di streaming AppStream 2.0 incorporate.

Esempio 1: nasconde l'intera barra degli strumenti AppStream 2.0

Per impedire agli utenti di accedere a qualsiasi pulsante della barra degli strumenti AppStream 2.0 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 AppStream 2.0.

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 sulla barra degli strumenti AppStream 2.0

È possibile visualizzare la barra degli strumenti AppStream 2.0, 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 sulla barra degli strumenti 2.0 AppStream

È possibile visualizzare la barra degli strumenti AppStream 2.0, 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]}
 };