Complemento de Amazon GameLift Servers para Unity (SDK 4 del servidor)

Descarga e instalación del complemento para Unity

1. Descargue el complemento de Amazon GameLift Servers para Unity. Puede encontrar la versión más reciente en la página del repositorio del complemento de Amazon GameLift Servers para Unity. En la versión más reciente, elija Activos y, a continuación, descargue el archivo com.amazonaws.gamelift-version.tgz.

2. Lance Unity y elija un proyecto.

3. En la barra de navegación superior, en Ventana, elija Administrador de paquetes:

   

4. En la pestaña Administrador de paquetes, seleccione + y, a continuación, elija Añadir paquete desde archivo tarball... :

   

5. En la ventana Seleccionar paquetes en disco, navegue hasta la com.amazonaws.gamelift carpeta, elija el archivo ycom.amazonaws.gamelift-version.tgz , a continuación, elija Abrir:

   

6. Una vez que Unity haya cargado el complemento, Amazon GameLift Servers aparecerá como un elemento nuevo en el menú de Unity. La instalación y recopilación de los scripts puede llevar unos minutos. La pestaña Configuración del complemento de Amazon GameLift Servers se abrirá automáticamente.

   

7. En el panel del SDK, elija Usar .NET 4.x.

   Cuando esté configurado, el estado cambiará de No configurado a Configurado.

1. En la ventana del complemento para Unity, elija la pestaña Prueba.

2. En el panel Prueba, elija Descargar Amazon GameLift Servers local. El complemento para Unity abrirá una ventana del navegador y descargará el archivo GameLift_06_03_2021.zip en la carpeta de descargas.

   La descarga incluye el SDK del servidor de C#, los archivos de origen de.NET y un componente de .NET compatible con Unity.

3. Descomprima el archivo descargado GameLift_06_03_2021.zip.

4. En la ventana Configuración del complemento de Amazon GameLift Servers, elija Ruta de Amazon GameLift Servers local, diríjase a la carpeta sin comprimir, elija el archivo GameLiftLocal.jar y, a continuación, seleccione Abrir.

   Cuando esté configurado, el estado de la prueba local cambiará de No configurado a Configurado.

5. Verifique el estado de JRE. Si el estado es No configurado, seleccione Descargar JRE e instale la versión de Java recomendada.

   Después de instalar y configurar el entorno de Java, el estado cambiará a Configurado.

1. En la pestaña del complemento para Unity, elija la pestaña Prueba.

2. En el panel Prueba, elija Abrir interfaz de usuario de prueba local.

3. En la ventana Prueba local, especifique una ruta de un archivo ejecutable del servidor. Elija ... para seleccionar la ruta y el nombre del archivo ejecutable de la aplicación del servidor.

4. En la ventana Prueba local, especifique un puerto local de GL.

5. Elija Implementar y ejecutar para implementar y ejecutar el servidor.

6. Para detener el servidor de juegos, elija Detener o cierre las ventanas del servidor de juegos.

Para actualizar las credenciales de AWS, realice el siguiente procedimiento:

1. En Unity, en la pestaña del complemento para Unity, elija la pestaña Implementar.

2. En el panel Implementar, elija Credenciales de AWS.

3. Puede crear credenciales de AWS nuevas o utilizar las existentes.

   • Para crear credenciales, elija Crear nuevo perfil de credenciales y, a continuación, especifique el nombre del nuevo perfil, el ID de la clave de acceso de AWS, la clave secreta de AWS y la Región de AWS.

   • Para elegir las credenciales existentes, seleccione Elegir perfil de credenciales existente y, a continuación, seleccione un nombre de perfil y la Región de AWS.

4. En la ventana Actualizar credenciales de AWS, seleccione Actualizar perfil de credenciales.

Para actualizar la ubicación de arranque de la cuenta, realice el siguiente procedimiento:

1. En Unity, en la pestaña del complemento para Unity, elija la pestaña Implementar.

2. En el panel Implementar, seleccione Actualizar arranque de cuenta.

3. En la ventana de Arranque de cuenta, elija un bucket de Amazon S3 existente o cree un bucket de Amazon S3 nuevo:

   • Para elegir un bucket existente, seleccione Elegir un bucket de Amazon S3 existente y Actualizar para guardar la selección.

   • Seleccione Crear un bucket de Amazon S3 nuevo para crear un nuevo bucket de Amazon Simple Storage Service y, a continuación, elija una política. La política especifica cuándo caducará el bucket de Amazon S3. Elija Crear para crear el bucket.

Implementación de un escenario

1. En Unity, en la pestaña del complemento para Unity, elija la pestaña Implementar.

2. En el panel Implementar, seleccione Abrir interfaz de usuario de implementación.

3. En la ventana Implementación, elija un escenario.

4. Especifique un nombre de juego. Deben ser únicos. El nombre del juego forma parte del nombre de la pila de CloudFormation cuando implementa el escenario.

5. Elija la ruta de la carpeta de compilación del servidor de juegos. La ruta de la carpeta de compilación apunta a la carpeta que contiene el archivo ejecutable del servidor y las dependencias.

6. Elija la ruta del archivo .exe de compilación del servidor de juegos. La ruta del archivo ejecutable de compilación apunta al archivo ejecutable del servidor de juegos.

7. Elija Iniciar implementación para comenzar a implementar un escenario. Puede seguir el estado de la actualización en la ventana Implementación, en Estado actual. Los escenarios pueden tardar varios minutos en implementarse.

   

8. Cuando el escenario finalice la implementación, el estado actual se actualizará para incluir el ID de cliente de Cognito y el punto de conexión de API Gateway, que podrá copiar y pegar en el juego.

   

9. Para actualizar la configuración del juego, en el menú de Unity, elija Ir a la configuración de conexión del cliente. Aparecerá la pestaña Inspector en el lado derecho de la pantalla de Unity.

10. Anule la selección de la opción Modo de prueba local.

11. Especifique el punto de conexión de API Gateway y el ID de cliente de Cognito. Elija la misma Región de AWS que utilizó para la implementación del escenario. A continuación, podrá volver a compilar y ejecutar el cliente de juego con los recursos del escenario implementados.

Para eliminar recursos creados por el escenario, realice el siguiente procedimiento:

1. En la ventana Implementación del complemento de Amazon GameLift Servers para Unity, seleccione Ver la consola de AWS CloudFormation para abrir la consola de CloudFormation.

2. En la consola de CloudFormation, seleccione Pilas y, a continuación, elija la pila que incluye el nombre del juego especificado durante la implementación.

3. Elija Eliminar para borrar la pila. La pila tarda unos minutos en eliminarse. Después de que CloudFormation elimine la pila utilizada en el escenario, su estado cambia a ROLLBACK_COMPLETE.

1. En Unity, en el menú, elija Amazon GameLift Servers y, a continuación, seleccione Importar un juego de muestra.

2. En la ventana Importar un juego de muestra, elija Importar para importar el juego, sus recursos y dependencias.

3. Compile el servidor de juegos. En Unity, en el menú, elija Amazon GameLift Servers y, a continuación, seleccione Aplicar configuración de compilación del servidor de ejemplo de Windows o Aplicar configuración de compilación del servidor de ejemplo de MacOS. Después de configurar los ajustes del servidor de juegos, Unity vuelve a compilar los recursos.

4. En Unity, en el menú, elija Archivo y, a continuación, elija Compilación. Elija Compilación del servidor, Compilación y, a continuación, seleccione una carpeta de compilación específica para los archivos del servidor.

   Unity compila el servidor de juegos de ejemplo y coloca el archivo ejecutable y los recursos necesarios en la carpeta de compilación especificada.

1. En Unity, en el menú, elija Amazon GameLift Servers y, a continuación, seleccione Aplicar configuración de compilación del cliente de ejemplo de Windows o Aplicar configuración de compilación del cliente de ejemplo de MacOS. Una vez configurados los ajustes del cliente de juegos, Unity volverá a compilar los recursos.

2. En Unity, en el menú, seleccione Ir a la configuración del cliente. Aparecerá la pestaña Inspector en el lado derecho de la pantalla de Unity. En la pestaña Configuración del cliente de Amazon GameLift Servers, seleccione Modo de prueba local.

3. Compile el cliente de juegos. En Unity, en el menú, elija Archivo. Confirme que la opción Compilación del servidor no esté activa, elija Compilación y, a continuación, seleccione una carpeta de compilación específica para los archivos del cliente.

   Unity compila el cliente de juegos de ejemplo y coloca el archivo ejecutable y los recursos necesarios en la carpeta de compilación del cliente especificada.

4. No ha compilado el servidor y el cliente de juegos. En los siguientes pasos podrá ejecutar el juego y observar cómo interactúa con Amazon GameLift Servers.

1. Lance el servidor de juegos. En Unity, en la pestaña del complemento para Unity, elija la pestaña Implementar.

2. En el panel Prueba, elija Abrir interfaz de usuario de prueba local.

3. En la ventana Prueba local, especifique una ruta de archivo .exe del servidor de juegos. La ruta debe incluir el nombre del archivo ejecutable. Por ejemplo, C:/MyGame/GameServer/MyGameServer.exe.

4. Elija Implementar y ejecutar. El complemento de Unity lanza el servidor de juegos y abre una ventana de registro de Amazon GameLift Servers local. La ventana contiene mensajes de registro, incluidos los mensajes enviados entre el servidor de juegos y Amazon GameLift Servers local.

5. Lance el cliente de juegos. Busque la ubicación de la compilación con el cliente de juegos de ejemplo y elija el archivo ejecutable.

6. En el juego de ejemplo de Amazon GameLift Servers, especifique un correo electrónico y una contraseña y, a continuación, elija Iniciar sesión. El correo electrónico y la contraseña no están validados o no se utilizan.

7. En el juego de ejemplo de Amazon GameLift Servers, elija Iniciar. El cliente de juegos busca una sesión de juego. Si no encuentra una sesión, crea una. A continuación, el cliente de juegos inicia la sesión de juego. Puede ver la actividad del juego en los registros.

1. En el cliente de juegos, elija Salir o cierre la ventana para detener el cliente de juegos.

2. En Unity, en la ventana Pruebas locales, seleccione Detener o cierre las ventanas del servidor de juegos para detener el servidor.