Lumberyard
Guía del usuario (Version 1.21)

Uso del administrador de contenido dinámico

Puede utilizar Dynamic Content Cloud Gem y su administrador de contenido dinámico para administrar las actualizaciones de contenido dinámico de su juego mediante AWS. Puede utilizar el administrador de contenido dinámico para crear manifiestos y paquetes, añadir archivos a los paquetes y cargar el manifiesto y los paquetes en la nube de AWS. Esto garantiza que sus clientes tengan el contenido más reciente del juego.

Requisitos previos

Este tutorial se basa en los siguientes supuestos:

  • Está utilizando un proyecto de Lumberyard que tiene habilitada la gema en la nube Dynamic Content (en Project Configurator, elija Cloud Gem Dynamic Content (Gema en la nube Dynamic Content)).

  • Ha creado una pila de proyecto y una pila de implementación en el administrador de recursos de Cloud Canvas con el grupo de recursos CloudGemDynamicContent.

nota

Si no dispone de una implementación con el grupo de recursos CloudGemDynamicContent, la interfaz Dynamic Content Manager (Administrador de contenido dinámico) se deshabilita.

Para utilizar el administrador de contenido dinámico para cargar contenido dinámico

  1. En Lumberyard Editor, elija AWS, Cloud Canvas, Dynamic Content Manager (Administrador de contenido dinámico).

    
          Administrador de contenido dinámico
  2. En Dynamic Content Manager (Administrador de contenido dinámico), haga clic en Create a new manifest (Crear un nuevo manifiesto).

    
          Cree un manifiesto

    Un manifiesto es un archivo que lleva un seguimiento de los archivos de contenido dinámico que usted entrega a los clientes. Un manifiesto registra la información siguiente:

    • Los archivos de contenido que han cambiado localmente.

    • Los archivos que se incluyen en cualquier paquete de archivos.

    • Las diferencias entre los paquetes locales y los paquetes en la nube que están preparados para su entrega a los clientes.

    • Los sistemas operativos y dispositivos de destino de este manifiesto

    Puede crear tantos manifiestos como sea necesario. Por ejemplo, puede crear manifiestos especializados para diferentes tipos de activos.

  3. Elija un nombre para el manifiesto. El nombre debe reflejar el objetivo del manifiesto.

  4. Seleccione los sistemas operativos y dispositivos de destino en los que prefiera trabajar con este manifiesto.

  5. Cuando crea un manifiesto, esta está vacío y no contiene archivos ni paquetes.

    
          Añada archivos

    Haga clic en Add Files (Añadir archivos) o en Add Folder (Añadir carpeta) y elija uno de los sistemas operativos de destino.

    
          Seleccione el SO
  6. En el navegador de archivos, seleccione los archivos que quiera añadir al manifiesto.

    
          Elija los archivos del manifiesto

    Dado que es posible que los activos originales no tengan un formato que su juego pueda consumir, el navegador de archivos se abre en la ubicación de la memoria caché de activos de proyectos de su juego. Por ejemplo, puede que su SO del juego necesite que las texturas estén en formato .dds, pero el activo original de una textura puede estar en un archivo .png. El procesador de activos convierte los archivos al formato adecuado y los almacena en la memoria caché de activos, por lo que dicha memoria es su opción más segura. Sin embargo, si ha procesado activos en otro punto de su sistema de archivos, no hay problema si los incluye.

    Avisos de archivos

    Si los archivos que ha seleccionado no son compatibles con el manifiesto actual o no son compatibles con el SO que ha seleccionado, se le avisará en consecuencia.

    
          Sistemas operativos no admitidos

    Si los archivos que ha seleccionado no están en la memoria caché de activos de proyectos de su juego (y, por lo tanto, el procesador de activos no los ha procesado), se le notificará el error.

    
          Los archivos seleccionados no están en la memoria caché de los recursos
  7. El panel izquierdo de Dynamic Content Manager (Administrador de contenido dinámico) muestra los archivos que ha añadido al manifiesto. Puede añadir archivos para diferentes sistemas operativos de destino y ordenar los archivos por nombre, SO o estado. Cuando tenga algunos archivos en el administrador de archivos, podrá seleccionar uno o varios archivos o sacarlos. Puede sacarlos haciendo clic con el botón derecho del ratón o haciendo clic en Remove Files (Eliminar archivos).

    
          Cree un nuevo paquete

    Ahora ya está listo para añadir un paquete al manifiesto.

    Haga clic en New Package (Nuevo paquete).

  8. Escriba un nombre para el paquete y elija el tipo de sistema operativo o dispositivo para él.

    
          Nombre del nuevo paquete
  9. El nuevo paquete se muestra en el panel derecho de Dynamic Content Manager (Administrador de contenido dinámico). Puede ordenar los paquetes por columna.

    
          Paquete nuevo creado

    Cada paquete se almacena en un archivo .pak, que es el formato de archivo archivado que Lumberyard utiliza para los recursos de su juego publicado. Puede tener uno o varios paquetes por manifiesto y puede asignar el mismo archivo a varios paquetes. Esto es útil cuando tiene archivos comunes y archivos específicos del sistema operativo o el dispositivo que tiene que entregar en un paquete. También es útil si quiere crear paquetes de elementos que puedan compartir activos.

  10. Para añadir archivos al paquete que ha creado, arrastre los archivos desde el manifiesto situado en el lado izquierdo, hasta el paquete situado en el lado derecho. Puede arrastrar varios archivos al mismo archivo .pak.

    
          Añada archivos desde el manifiesto en el paquete

    Puede arrastrar los archivos específicos del sistema operativo o dispositivo a un paquete con ese tipo de sistema operativo solamente. Si arrastra varios archivos a un paquete y el tipo de sistema operativo de esos archivos no coincide con el del paquete, Lumberyard generará una advertencia sobre los archivos incompatibles.

    
          Alerta de archivo incompatible

    Los iconos que aparecen en el panel Packages (Paquetes) se describen como se indica a continuación.

    Icono Descripción

    Un archivo de un paquete se ha actualizado en la caché de activos. El contenido del paquete se ha actualizado, por lo que es posible que desee cargar de nuevo el paquete.

    El paquete no está en la nube. Este caso puede darse cuando el paquete todavía no se ha cargado.

    Un paquete ha cambiado con respecto a su copia en la nube. El contenido del paquete se ha actualizado, por lo que es posible que desee cargar de nuevo el paquete.

    El paquete local coincide con el paquete en la nube. No es necesaria ninguna acción.

    Notas

    • Puede eliminar archivos individuales de un paquete, pero para evitar las eliminaciones accidentales, esta acción se limita a un archivo a la vez.

    • También puede utilizar Dynamic Content Manager (Administrador de contenido dinámico) para eliminar paquetes, pero eliminar un paquete no elimina los paquetes organizados en la nube. Para eliminar los paquetes organizados en la nube, debe utilizar el Cloud Gem Portal basado en web que administra el lado de servicio de una gema de nube.

  11. Puede cambiar los sistemas operativos o dispositivos de destino del manifiesto actual en cualquier momento.

    1. Haga clic en el botón de configuración y seleccione Change Target Platforms (Cambiar plataformas de destino).

      
              Cambiar los sistemas operativos de destino
    2. Elija los sistemas operativos o los dispositivos que desee. Si no se selecciona ninguno, se añaden todos los sistemas operativos y dispositivos compatibles.

      
              Elija los sistemas operativos y dispositivos de destino

      Después de actualizar los sistemas operativos y dispositivos de destino, Dynamic Content Manager (Administrador de contenido dinámico) genera una lista que muestra únicamente los archivos y los paquetes para los que ha seleccionado. Puede añadir archivos y carpetas únicamente para el sistema operativo o dispositivo de destino seleccionado.

      
              Archivos específicos del sistema operativo
  12. Cuando esté preparado, haga clic en Upload Packages (Cargar paquetes).

  13. (Opcional) Para firmar los paquetes, seleccione Sign packages with security key (Firmar paquetes con clave de seguridad).

    
          Firme los paquetes con una clave de seguridad
  14. Si todavía no ha generado pares de claves, haga clic en Next (Siguiente) para generar un nuevo par de claves y, a continuación, haga clic en Continue (Continuar).

    
          Genere nuevas claves

    También puede utilizar el menú de archivo para generar un nuevo par de claves en cualquier momento.

    
          Genere un par de claves desde el menú de archivo
  15. Una vez que haya generado el nuevo par de claves, haga clic en Upload (Cargar). Esta acción tanto crea los archivos del paquete localmente, como los carga en su bucket de colocación privado en la nube de AWS.

    
          Cargar

    La barra de estado de la ventana principal muestra los mensajes del proceso de carga.

    
          Cargue los mensajes del proceso

    Una animación en la columna S3 Status (Estado de S3) indica el paquete que se está cargando.

    
          Indicador del proceso de carga

    Los paquetes se muestran en la sección Dynamic Content (Contenido dinámico) de Cloud Gem Portal. De forma predeterminada, Lumberyard los marca como Private (Privados). Cuando esté listo, puede mover los paquetes a la etapa Public (Público) para que los clientes del juego tengan la posibilidad de descargarlos. Para obtener más información sobre este paso, consulte Administración de paquetes de contenido dinámico.