View a markdown version of this page

Configuración de un servidor web y un cliente con Amazon Streams GameLift - Amazon GameLift Streams

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.

Configuración de un servidor web y un cliente con Amazon Streams GameLift

En este tutorial, configurará una aplicación de cliente web que integre el servicio de streaming GameLift de Amazon Streams. A continuación, utilizará el SDK web de Amazon GameLift Streams, una JavaScript biblioteca y un código de muestra con el que puede empezar. El código de muestra incluye un sencillo servidor web de backend de Amazon GameLift Streams y un cliente web sencillo. Al final de este tutorial, puede iniciar una transmisión con el código de muestra.

Si es la primera vez que utilizas Amazon GameLift Streams, te recomendamos encarecidamente que comiences por el Comenzar tu primera transmisión en Amazon GameLift Streams tutorial, que te explica cómo subir un juego a Amazon S3 y probar su streaming desde la consola de Amazon GameLift Streams de tu navegador.

Requisitos previos

Descargue el SDK web

Para este tutorial, tendrá que descargar los siguientes materiales de la sección Recursos de la página de inicio del producto:

  • Paquete de SDK web de Amazon GameLift Streams: incluye un código de muestra para un servicio de backend y un cliente web sencillos.

  • Referencia de la API del SDK web de Amazon GameLift Streams: esta referencia de la API documenta los contenedores de API de Amazon GameLift Streams para. JavaScript

Configure sus recursos de streaming

Debes tener recursos de transmisión (una aplicación y un grupo de transmisión) para iniciar una transmisión. En concreto, debes tener:

  • Una solicitud en estado Listo.

  • Un grupo de transmisiones en estado activo con capacidad de transmisión disponible.

  • Para la transmisión en ubicaciones distintas a la ubicación principal, la aplicación debe haber terminado de replicarse en esa ubicación.

Para configurar una aplicación y un grupo de GameLift transmisiones mediante la consola de Amazon Streams o la CLI de Amazon GameLift Streams, consulte Preparar una aplicación en Amazon GameLift Streams yGestione la transmisión con un grupo de GameLift transmisiones de Amazon Streams, respectivamente. Como alternativa, para ver un tutorial completo en la consola de Amazon GameLift Streams, consulte. Comenzar tu primera transmisión en Amazon GameLift Streams

Configure un servidor back-end

El servidor back-end es responsable de gestionar tareas como la autenticación de los usuarios, la configuración de los parámetros de transmisión y la realización de llamadas a la API del servicio Amazon GameLift Streams en nombre de los usuarios finales. Consulte el código de ejemplo y la referencia de la API del SDK web de Amazon GameLift Streams para obtener más información sobre cómo configurarlo. En concreto, consulte el archivo server.js del paquete del SDK web de Amazon GameLift Streams.

importante

Este código es un código de ejemplo destinado únicamente a fines de prueba y evaluación y no debe utilizarse con fines de producción.

Para ejecutar el servicio de backend de muestra
  1. Abra una terminal o línea de comandos y navegue hasta la carpetaAmazonGameLiftStreamsWebSDK\GameLiftStreamsSampleGamePublisherService\.

  2. Ejecute los siguientes comandos :

    npm install node server.js

Con el servicio de backend de ejemplo en ejecución, los usuarios finales pueden conectarse a una transmisión a través del cliente web. Pruebe el cliente web en el siguiente paso.

Lanza un cliente web

La aplicación de cliente web es responsable de recibir y decodificar las GameLift transmisiones de Amazon Streams, transmitirlas a los usuarios finales y proporcionar la interfaz de usuario del navegador web para que los usuarios finales puedan interactuar con la aplicación. Consulte el código de ejemplo y la referencia de la API del SDK web de Amazon GameLift Streams para obtener más información sobre cómo integrar el SDK web de JavaScript Amazon GameLift Streams en su propia aplicación de cliente web. En concreto, consulte el public/index.html paquete del SDK web de Amazon GameLift Streams. También puede consultar el código fuente de la página web al iniciar un cliente web en su navegador.

nota

Para obtener información sobre la compatibilidad con IPv6 en los entornos de ejecución, consulteCompatibilidad con IPv6.

Para iniciar una aplicación de cliente web
  1. Abra un navegador web y navegue hastahttp://localhost:port/. El número de puerto lo establece el servidor de fondo; de forma predeterminada, es el puerto HTTP 8000.

  2. Juega al juego o usa el software.

    1. Para adjuntar una entrada, como el ratón, selecciona Adjuntar entrada.

    2. Para salir del juego, selecciona la tecla Esc.

    3. Para detener el proceso del servidor, elija la tecla Ctrl+C.

Limpia los recursos de streaming

aviso

Un grupo de streaming incurre en costes cuando tiene asignada una capacidad de streaming, incluso si esa capacidad no se utiliza. Para evitar costes innecesarios, escala tus grupos de streaming al tamaño que necesites. Durante el desarrollo, te sugerimos que reduzcas a cero la capacidad permanente y la capacidad inactiva objetivo de tus grupos de streaming cuando no estén en uso. Para obtener más información, consulta Escale los grupos de streaming a una capacidad cero.

Cuando hayas completado el tutorial y ya no necesites transmitir tu aplicación en streaming, sigue estos pasos para limpiar tus recursos de Amazon Streams. GameLift

Eliminar un grupo de transmisiones

Cuando eliminas un grupo de GameLift transmisiones, Amazon Streams trabaja para liberar toda la capacidad de transmisión.

Para eliminar un grupo de transmisiones mediante la consola de Amazon GameLift Streams
  1. Inicie sesión en la consola de Amazon GameLift Streams Consola de administración de AWS y ábrala.

  2. Para ver una lista de sus grupos de transmisiones existentes, en el panel de navegación, seleccione Grupos de transmisiones.

  3. Elige el nombre del grupo de transmisiones que deseas eliminar.

  4. En la página de detalles del grupo de transmisiones, selecciona Eliminar.

  5. En el cuadro de diálogo Eliminar, confirma la acción de eliminación.

Amazon GameLift Streams comienza a liberar recursos informáticos y a eliminar el grupo de transmisiones. Durante este tiempo, el grupo de transmisiones se encuentra en estado de eliminación. Una vez que Amazon GameLift Streams elimine el grupo de transmisiones, ya no podrá recuperarlo.

Eliminar una aplicación

Solo puede eliminar una aplicación que cumpla las siguientes condiciones:

  • La aplicación está en estado Listo o Error.

  • Una aplicación no está transmitiendo en ninguna sesión de transmisión en curso. Debe esperar a que el cliente finalice la sesión de transmisión o llame a TerminateStreamSession la API de Amazon GameLift Streams para finalizar la transmisión.

Si la aplicación está vinculada a algún grupo de transmisiones, debe desvincularla de todos los grupos de transmisiones asociados antes de poder eliminarla. En la consola, un cuadro de diálogo le guiará a través de este proceso.

Para eliminar una aplicación mediante la consola de Amazon GameLift Streams
  1. Inicie sesión en la consola de Amazon GameLift Streams Consola de administración de AWS y ábrala.

  2. En la barra de navegación, seleccione Aplicaciones para ver una lista de las aplicaciones existentes. Elige la aplicación que quieres eliminar.

  3. En la página de detalles de la aplicación, selecciona Eliminar.

  4. En el cuadro de diálogo Eliminar, confirme la acción de eliminación.

Amazon GameLift Streams comienza a eliminar la aplicación. Durante este tiempo, la solicitud está en Deleting estado. Una vez que Amazon GameLift Streams elimine la aplicación, ya no podrá recuperarla.