Étape 4 : Configurez votre site Web pour l'intégrer à Amazon AppStream 2.0 - Amazon AppStream 2.0
Importez le fichier appstream-embed JavaScript Initialisation et configuration de l'objet d'interface AppStream.EmbedExemples de masquage d'éléments dans l'interface utilisateur AppStream 2.0

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Étape 4 : Configurez votre site Web pour l'intégrer à Amazon AppStream 2.0

Les sections suivantes fournissent des informations sur la configuration de votre page Web pour héberger des sessions de streaming AppStream 2.0 intégrées.

Importez le fichier appstream-embed JavaScript

  1. Sur la page Web sur laquelle vous prévoyez d'intégrer la session de streaming AppStream 2.0, importez le fichier appstream-embed.js dans la page Web en ajoutant le code suivant :

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

  2. Ensuite, créez un conteneur div vide. L'ID du div que vous avez défini est transmis au constructeur d'intégration AppStream 2.0. Il est ensuite utilisé pour injecter un iframe pour la session de streaming. Pour créer le conteneur div, ajoutez le code suivant :

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

Initialisation et configuration de l'objet d'interface AppStream.Embed

Pour initialiser l'objet AppStream.Embed d'interface JavaScript, vous devez ajouter du code qui crée un AppStream.Embed objet avec des options pour le streaming URL et la configuration de l'interface utilisateur. Ces options, ainsi que l'ID div que vous avez créé, sont stockés dans un objet appelé appstreamOptions.

L'exemple de code suivant montre comment initialiser l'objet d'interface 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);

Dans le code, remplacez sessionURL and userInterfaceConfig avec vos propres valeurs.

Note

La valeur spécifiée pour userInterfaceConfig masque l'intégralité de la barre d'outils AppStream 2.0. Cette valeur, qui est incluse à titre d'exemple, est facultative.

sessionUrl

Le streaming URL que vous avez créé à l'aide de la console AppStream 2.0, de l'CreateStreamingURLAPIaction ou de la create-streaming-url AWS CLIcommande. Ce paramètre n'est pas sensible à la casse.

Type : chaîne

Obligatoire : oui

userInterfaceConfig

Configuration qui génère l'état initial des éléments de l'interface utilisateur. La configuration est une paire clé-valeur.

La clé,AppStream.Embed.Options.HIDDEN_ELEMENTS, spécifie les objets de l'interface utilisateur qui sont initialement masqués lors de l'initialisation de la session de streaming AppStream 2.0 intégrée. Par la suite, vous pouvez renvoyer des objets masqués et visibles à l'aide du paramètre getInterfaceState.

La valeur est un tableau de constantes (boutons de barre d'outils). Pour obtenir la liste des constantes que vous pouvez utiliser, consultez Utilisation de l’option HIDDEN_ELEMENTS.

Type : Carte (key:value)

Obligatoire : non

Exemples de masquage d'éléments dans l'interface utilisateur AppStream 2.0

Les exemples de cette section montrent comment masquer des éléments de l'interface utilisateur AppStream 2.0 aux utilisateurs lors de leurs sessions de streaming AppStream 2.0 intégrées.

Exemple 1 : masquer l'intégralité de la barre d'outils AppStream 2.0

Pour empêcher les utilisateurs d'accéder à n'importe quel bouton de la barre d'outils AppStream 2.0 pendant les sessions de streaming intégrées, utilisez la AppStream.Embed.Elements.TOOLBAR constante. Cette constante permet de masquer tous les boutons de la barre d'outils 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]}
 };

Exemple 2 : masquer un bouton spécifique dans la barre d'outils AppStream 2.0

Vous pouvez afficher la barre d'outils AppStream 2.0, tout en empêchant les utilisateurs d'accéder à un bouton de barre d'outils spécifique pendant les sessions de streaming intégrées. Pour ce faire, spécifiez la constante du bouton que vous souhaitez masquer. Le code suivant utilise la constante AppStream.Embed.Elements.FILES_BUTTON pour masquer le bouton Mes fichiers. Cela empêche les utilisateurs d'accéder aux options de stockage persistant pendant les sessions de streaming intégrées.

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

Exemple 3 : masquer plusieurs boutons dans la barre d'outils AppStream 2.0

Vous pouvez afficher la barre d'outils AppStream 2.0, tout en empêchant les utilisateurs d'accéder à plusieurs boutons de barre d'outils pendant les sessions de streaming intégrées. Pour ce faire, spécifiez les constantes des boutons que vous souhaitez masquer. Le code suivant utilise les constantes AppStream.Embed.Elements.END_SESSION_BUTTON et AppStream.Embed.Elements.FULLSCREEN_BUTTON pour masquer les boutons End Session (Fin de session) et Fullscreen (Plein écran).

Note

Séparez chaque constante par une virgule, sans espace devant ou après.

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