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

Paso 4. Configurar su 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 de AppStream 2.0 integradas.

Importar el archivo JavaScript appstream-embed

  1. En la página web donde planea integrar la sesión de streaming de AppStream 2.0, importe el archivo appstream-embed.js en la página web; para ello, añada 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 se establece se pasa al generador de integración de 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 interfaz AppStream.Embed en JavaScript, debe añadir código que cree un objeto AppStream.Embed con opciones para la configuración de la URL de streaming y de la interfaz de usuario. 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 por sus propios valores.

nota

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

sessionUrl

La URL de streaming que creó mediante la consola de AppStream 2.0, la acción CreateStreamingURL de la API o el comando create-streaming-url de la AWS CLI. 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 interfaz de usuario que están ocultos inicialmente cuando se inicializa la sesión de streaming de 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 (clave:valor)

Obligatorio: no

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

En los ejemplos de esta sección se muestra cómo ocultar elementos a los usuarios de la interfaz de usuario de AppStream 2.0 durante sus sesiones de streaming de AppStream 2.0 insertadas.

Ejemplo 1: Ocultar toda la barra de herramientas de AppStream 2.0

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

Puede mostrar la barra de herramientas de AppStream 2.0, pero impedir que los usuarios accedan a un botón determinado de ella 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 en la barra de herramientas de AppStream 2.0

Puede mostrar la barra de herramientas de AppStream 2.0, pero impedir que los usuarios accedan a varios botones de esta 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]}
 };