Creación de una gema en la nube - Lumberyard Guía del usuario

Si proporcionásemos una traducción de la versión en inglés de la guía, prevalecerá la versión en inglés de la guía si hubiese algún conflicto. La traducción se proporciona mediante traducción automática.

Creación de una gema en la nube

Lumberyard incluye algunas gemas en la nube, como tablas de clasificación y distribución dinámica de contenido, que proporcionan servicios con todas las funciones. Puede utilizar estas gemas en los juegos con un mínimo de esfuerzo. Porque el código fuente completo de estas gemas en la nube se incluye con Lumberyard, puedes puede personalizarlos o utilizarlos como ejemplos para desarrollar sus propias gemas en la nube.

Puede desarrollar sus propias gemas en la nube para crear paquetes discretos de soluciones personalizadas y conectadas a la nube para mejorar el juego. Las gemas en la nube aprovechan el poder de AWS, benefíciate de la del modelo de seguridad de AWS y Lumberyardy se pueden comunicar entre sí para crear una comunicación experiencia de juego.

Puede crear fácilmente su propia gema en la nube mediante la lmbr_aws cloud-gem create del comando.

Prerequisites

  1. Asegúrese de que la gema Cloud Gem Framework está habilitada para su proyecto. Realice una de las lo siguiente:

    • Utiliza el botón Habilitación de gemas para habilitar el Marco de gemas en la nube gema.

      de los EE. UU.

    • Desde la pestaña \dev\Tools\LmbrSetup\Win , escriba el siguiente comando. Reemplazar <projectname> con el nombre del proyecto.

      lmbr gems enable <projectname> CloudGemFramework
  2. Asegúrese de que los recursos de Cloud Gem Framework del proyecto se corresponden con los más recientes versión de la gema Cloud Gem Framework. Desde una ventana del símbolo del sistema en la \dev , escriba el siguiente comando:

    lmbr_aws project update-framework-version
  3. Si la gema en la nube va a utilizar la API del servicio Cloud Gem Framework, realice una de las siguientes acciones:

    • En Ejecución de Lumberyard Setup Assistant, elige Compilación el código del juego

      de los EE. UU.

    • Desde una ventana del símbolo del sistema en la \dev\Tools\LmbrSetup\Win , escriba el siguiente comando:

      lmbr capabilities enable compilegame

Para crear una gema en la nube

  • Desde la pestaña \dev , introduce el lmbr_aws cloud-gem create del comando. Utilice la siguiente sintaxis:

    lmbr_aws cloud-gem create --gem {gem-name} --initial-content {content-option} --enable

    Las opciones de sintaxis son las siguientes:

    • --gem {gem-name} – Especifica el nombre de la gema en la nube.

    • --initial-content {content-option} – Especifica el contenido de inicio de la gema en la nube. Para obtener una lista de opciones de contenido, consulte gém-nube crear.

    • --enable – Habilita la gema en la nube en su proyecto.

    Example

    El siguiente ejemplo de comando crea una gema en la nube denominada MyCloudGem que está habilitado en el proyecto actual y tiene Amazon API Gateway y AWS Lambda Los recursos de función de.

    lmbr_aws cloud-gem create --gem MyCloudGem --initial-content api-lambda --enable

    Resultados del comando

    En función del parámetro que elija para el parámetro --initial-content , la opción cloud-gem create El comando de la puede hacer gran parte del trabajo inicial del código de gema en la nube por usted. Por ejemplo, elegir api-lambda El parámetro crea los siguientes recursos localmente:

    • A \dev\Gems\{gem-name}\vN\ gem.json que declara una dependencia en la gema en la nube Marco.

    • A \dev\Gems\{gem-name}\vN\AWS que incluye los siguientes elementos:

      • La cgp-resource-code directorio que contiene código de recurso de esqueleto para su Cloud Gem Portal.

      • La lambda-code directorio que contiene esqueleto ServiceLambda Código de API. ServiceLambda es un AWS Lambda función que implementa la funcionalidad de la gema en la nube.

      • La swagger.json que describe la API de para la gema en la nube. Para obtener más información acerca de la swagger.json del archivo, consulte API del servicio Cloud Gem Framework.

      • La recurso-plantilla.json que el archivo define los recursos iniciales de la gema en la nube. En la pestaña api-lambda ejemplo, el resource-template.json especifica el lo siguiente:

        • ServiceApide ServiceLambda, y ServiceLambdaConfiguration Los recursos de.

        • Una salida para la URL de la API del servicio.

        • Un AccessControl recurso configurado como descrito en Control del acceso a Recursos.

    • A \dev\Gems\{gem-name}\vN\Code\ con código de esqueleto que se generó automáticamente a partir del swagger.json del archivo. El Code el directorio contiene lo generado Uso de la Waf Sistema de compilación y los siguientes subdirectorios:

      • \AWS\ServiceAPI\ – Contiene {gem-name}ClientComponent.h y {gem-name}ClientComponent.cpp de los archivos. Utilice el código de esqueleto en estos archivos para implementar un Lumberyard que puede utilizar para invocar la API del servicio de la gema en la nube Las operaciones de desde C++ o Lua.

      • \Include\{gem-name}\ – Contiene un {gem-name}Bus.h Bus electrónico del archivo.

      • \Source\ – Contiene esqueleto componente, módulo de gema y archivos de componentes del sistema.

      • \Tests\ – Contiene un esqueleto {gem-name}Test.cpp archivo

En desarrollo su gema en la nube

Después de utilizar la función lmbr_aws cloud-gem create comando, puedes desarrolle su gema en la nube haciendo lo siguiente:

  • Añada las definiciones de recursos que la gema en la nube requiere al resource-template.json del archivo. En Cloud Canvas Responsable de recursos, haga clic en Cargar todo recursos para crear e implementar el AWS los recursos que están definido en su resource-template.json del archivo.

  • Implemente la funcionalidad de la gema en la nube añadiendo código al lambda-code del directorio.

  • Adición de rutas y operaciones al swagger.json que el archivo exponga la funcionalidad de la gema en la nube. Para obtener más información, consulte API del servicio Cloud Gem Framework.

  • Uso Lumberyard los componentes, Bus electrónico, y otros características para implementar la funcionalidad del cliente de juego para la gema. Coloque el código en la gema en la nube \dev\Gems\<gem-name>\vN\Code del directorio. Puede utilizar el cliente de API de servicio generado para obtener acceso a la en la funcionalidad de la gema en la nube ServiceLambda Lambda función.