Paso 4. Configura tu sitio web para la integración con Amazon AppStream 2.0 - Amazon AppStream 2.0
Importar el archivo appstream-embed JavaScript Inicializar y configurar el objeto de interfaz AppStream.EmbedEjemplos de ocultación de elementos en la interfaz de usuario AppStream 2.0

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Paso 4. Configura tu sitio web para la integración con Amazon AppStream 2.0

En las siguientes secciones se proporciona información sobre cómo configurar la página web para alojar sesiones de streaming AppStream 2.0 integradas.

Importar el archivo appstream-embed JavaScript

  1. En la página web en la que planea incrustar la sesión de streaming AppStream 2.0, importe el archivo appstream-embed.js a la página web añadiendo el siguiente código:

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

  2. A continuación, cree un contenedor div vacío. El ID del div que estableces se pasa al constructor embed AppStream 2.0. A continuación, se usa para inyectar un iframe para la sesión de streaming. Para crear el div, añada el siguiente código:

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

Inicializar y configurar el objeto de interfaz AppStream.Embed

Para inicializar el objeto de AppStream.Embed interfaz JavaScript, debe añadir código que cree un AppStream.Embed objeto con opciones para la configuración de la interfaz de usuario URL y de transmisión. Estas opciones, así como el ID div que ha creado, se almacenan en un objeto denominado appstreamOptions.

El código de ejemplo siguiente muestra cómo inicializar el objeto de interfaz 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);

En el código, sustituya sessionURL y userInterfaceConfig con tus propios valores.

nota

El valor especificado para userInterfaceConfig oculta toda la barra de herramientas AppStream 2.0. Este valor, que se incluye como ejemplo, es opcional.

sessionUrl

La transmisión URL que creó con la consola AppStream 2.0, la CreateStreamingURLAPIacción o el create-streaming-url AWS CLIcomando. Este parámetro distingue entre mayúsculas y minúsculas.

Tipo: cadena

Obligatorio: sí

userInterfaceConfig

La configuración que genera el estado inicial de los elementos de la interfaz de usuario. La configuración es un par de clave-valor.

La clave,AppStream.Embed.Options.HIDDEN_ELEMENTS, especifica los objetos de la interfaz de usuario que se ocultan inicialmente al inicializar la sesión de streaming AppStream 2.0 integrada. Posteriormente, puede devolver tanto objetos ocultos como visibles mediante el parámetro getInterfaceState.

El valor es una matriz de constantes (botones de la barra de herramientas). Para obtener una lista de constantes que puede utilizar, consulte Uso de HIDDEN_ELEMENTS.

Tipo: Mapa (key:value)

Obligatorio: no

Ejemplos de ocultación de elementos en la interfaz de usuario AppStream 2.0

Los ejemplos de esta sección muestran cómo ocultar a los usuarios los elementos de la interfaz de usuario AppStream 2.0 durante sus sesiones de streaming AppStream 2.0 integradas.

Ejemplo 1: ocultar toda la barra de herramientas de la AppStream versión 2.0

Para evitar que los usuarios accedan a cualquier botón de la barra de herramientas de la AppStream versión 2.0 durante las sesiones de streaming integradas, utilice la AppStream.Embed.Elements.TOOLBAR constante. Esta constante le permite ocultar todos los botones de la barra de herramientas 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]}
 };

Ejemplo 2: ocultar un botón específico de la barra de herramientas AppStream 2.0

Puede mostrar la barra de herramientas AppStream 2.0 y, al mismo tiempo, impedir que los usuarios accedan a un botón específico de la barra de herramientas durante las sesiones de streaming integradas. Para ello, especifique la constante del botón que desea ocultar. El código siguiente utiliza la constante AppStream.Embed.Elements.FILES_BUTTON para ocultar el botón My Files (Mis archivos). Esto impide que los usuarios accedan a las opciones de almacenamiento persistente durante las sesiones de streaming integradas.

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

Ejemplo 3: Ocultar varios botones de la barra de herramientas de la AppStream versión 2.0

Puede mostrar la barra de herramientas AppStream 2.0 y, al mismo tiempo, impedir que los usuarios accedan a más de un botón de la barra de herramientas durante las sesiones de streaming integradas. Para ello, especifique las constantes de los botones que desea ocultar. El código siguiente utiliza las constantes AppStream.Embed.Elements.END_SESSION_BUTTON y AppStream.Embed.Elements.FULLSCREEN_BUTTON para ocultar los botones Finalizar sesión y Pantalla completa.

nota

Separe las constantes entre sí mediante comas, sin espacio anterior ni posterior.

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