Lumberyard
Guía del usuario (Version 1.20)

Uso de Asset Processor

Asset Processor es una utilidad que se ejecuta en segundo plano para detectar cambios en los archivos de activos. Cuando Asset Processor detecta archivos de recursos nuevos o actualizados, lanza el compilador de recursos (Rc.exe) y, a continuación, procesa los recursos y los coloca en la caché. Asset Processor notifica a continuación a todas las instancias de la herramienta o del juego en ejecución que los recursos se han actualizado. El juego puede a continuación volver a cargar los activos actualizados.


            Utilice Asset Processor para administrar los archivos de recursos nuevos y actualizados en Amazon Lumberyard.

Asset Processor permite ejecutar los juegos en otras plataformas sin implementar activos en esa plataforma. En lugar de ello, se obtiene acceso a los activos desde la caché de activos en un sistema Windows o macOS. Con el Asset Processor, también puede ejecutar juegos con los activos de otra persona.

Al crear solicitudes de proxy a través de sí mismo, Asset Processor se comunica con un servidor de compilador de sombreador iOS o Android por medio de un cable USB en iOS y Android.

En Windows, Asset Processor se inicia automáticamente si ejecuta Lumberyard Editor con conexiones que se mantienen de forma automática. Asset Processor también se reinicia automáticamente si modifica cualquiera de los archivos de datos que necesita para funcionar o si recupera una nueva versión.

En macOS, debe iniciar manualmente Asset Processor (ubicado en el directorio lumberyard_version/dev/BinMac64) desde una ventana de línea de comandos.

nota

No se admiten enlaces simbólicos si utiliza Asset Processor en macOS. Para garantizar que Asset Processor funciona correctamente en macOS, siga estas directrices:

  • No utilice un enlace simbólico para su directorio de la memoria caché al almacenar los activos compilados en una ubicación central.

  • No almacene los activos de proyecto de origen en un directorio de enlace simbólico.

  • Utilice un directorio de caché exclusivo. No comparta el directorio de caché con un sistema de Windows que también esté ejecutando Asset Processor.

Puede abrir las opciones Asset Processor del área de notificaciones en la barra de tareas.


            Haga clic con el botón derecho del ratón en el icono Asset Processor en su área de notificación en la barra de tareas y, a continuación, elija Show (Mostrar).

No es necesario cerrar Asset Processor al obtener las últimas actualizaciones del control de origen. Puede iniciar Lumberyard Editor mientras Asset Processor aún está procesando los recursos.

No obstante, si no está utilizando el juego o Lumberyard Editor, puede salir de Asset Processor haciendo clic con el botón derecho del ratón en el icono de su área de notificación en la barra de tareas (Windows) o la barra de menú (macOS).

Asset Processor también puede trasmitir archivos directamente a videojuegos de la consola que se estén ejecutando para que los activos no tengan que estar presentes en el dispositivo de juegos. Este es el sistema de archivos virtuales (VFS), necesario para volver a cargar en directo para trabajar en esas plataformas. Para obtener más información, consulte Recarga en directo y VFS.

Modificación del archivo de configuración del Asset Processor

Utilice el archivo de configuración AssetProcessorPlatformConfig.ini (ubicado en el directorio lumberyard_version/dev/) para realizar las siguientes tareas:

  • Añadir nuevos tipos de archivo para Asset Processor para enviar datos al compilador de recursos, copiar en la caché o actualizar reglas de tipos de archivos existentes.

  • Actualizar la lista de pasar por alto.

  • Especificar las plataformas habilitadas actualmente. El valor predeterminado es la plataforma de host en la que se ejecuta Asset Processor. Asset Processor compila automáticamente recursos para la plataforma de host. Por ejemplo, si Asset Processor se ejecuta en Windows, Asset Processor compila recursos de Windows aunque pc no esté habilitado en el archivo .ini. Si Asset Processor se ejecuta en macOS, Asset Processor compila recursos de macOS aunque osx_gl no esté habilitado en el archivo .ini. Para compilar activos para otras plataformas, actualice el archivo .ini y habilite las plataformas que desee.

  • Añadir carpetas para que Asset Processor las pueda ver. Por ejemplo, puede especificar carpetas como bibliotecas de partículas compartidas y texturas asociadas entre proyectos.

  • Especificar qué archivos disparan archivos relacionados para su reconstrucción. Estas son huellas digitales de metarchivos.

Para añadir anulaciones específicas de juego, puede agregar un archivo denominado AssetProcessorGamePlatformConfig.ini a su directorio de activos del juego. Este archivo se lee después del archivo de configuración raíz y puede tener una configuración adicional específica del juego para la lista de pasar por alto, las plataformas y los tipos de archivo.

Para obtener más información sobre estos archivos de configuración, consulte Configuración de la canalización de activos.

Uso del archivo de lotes del Asset Processor

El archivo AssetProcessorBatch.exe compila todos los activos para el proyecto actual y las plataformas habilitadas. Si el archivo realiza la operación sin errores, emite un código 0. Puede utilizar el archivo como parte de su sistema de compilación para la automatización.

El archivo AssetProcessorBatch.exe acepta los siguientes parámetros de línea de comando anulando el comportamiento predeterminado:

  • /platforms=comma separated list

  • /gamefolder=name of game folder

Ejemplo:

AssetProcessorBatch.exe /platforms=pc,ios /gamefolder=SamplesProject