Instalar y configurar Experience Service > Parámetros de configuración > Generación de destinos
  
Generación de destinos
Al mostrar una experiencia, Vuforia View utiliza destinos para efectuar el seguimiento de objetos físicos y representar aumentos respecto a dichos objetos físicos. Al crear una experiencia, el autor puede elegir entre diferentes tipos de objetivos: ThingMarks, objetivos espaciales, objetivos tipo modelo y objetivos tipo imagen. Si una experiencia que utiliza objetivos tipo modelo o tipo imagen se publica en Experience Service, Experience Service debe generar un objetivo a partir del modelo o la imagen que se haya cargado.
La generación de objetivos complejos puede consumir muchos recursos del sistema; además, puede degradar el rendimiento de Experience Service. En concreto, la generación de objetivos tipo modelo para modelos grandes y complejos puede consumir gran cantidad de memoria. Los parámetros de configuración que se describen a continuación pueden utilizarse para limitar los recursos del sistema que se consumen en la generación de destinos.
Parámetro
Descripción
targetGenerator.maxTasks
Este parámetro define el número de tareas simultáneas de generación de objetivos permitidas. Si se publica un proyecto que requiere generación de objetivos mientras el número de tareas en curso es igual al límite de targetGenerator.maxTasks, la solicitud de publicación es rechazada con un estado HTTP 429.
Por defecto, este parámetro se define como 0, lo que indica que no hay ningún límite en el número de tareas simultáneas. Defina este parámetro con un número entero positivo para limitar la cantidad de tareas simultáneas de generación de objetivos.
targetGenerator.timeout
Esta propiedad define la cantidad máxima de tiempo permitido para completar una solicitud de publicación que requiere generación de destinos. Si el tiempo que se tarda en completar una solicitud de publicación que requiere generación de destinos supera el límite de targetGenerator.timeout, dicha tarea finaliza y Experience Service responde a la solicitud de publicación original con un estado de HTTP 413.
Por defecto, este parámetro se define en -1, lo que indica que hay un límite de 120.000 ms (2 minutos) en la cantidad de tiempo que se necesita para completar una solicitud de publicación con generación de objetivos. Si no se desea limitar el tiempo necesario para completar una solicitud de publicación con generación de destino, ajuste este parámetro a 0.
targetGenerator.maxMemory
Esta propiedad define la cantidad máxima de memoria disponible para todas las tareas de generación de destinos. Si el uso de la memoria combinada de todas las tareas simultáneas de generación de objetivos supera el límite de targetGenerator.maxMemory, la tarea de generación de objetivos que utiliza actualmente la mayor cantidad de memoria finaliza y Experience Service responde a la solicitud de publicación correspondiente con un estado HTTP 413.
Defina este parámetro con un número entero positivo. La finalidad es limitar la cantidad máxima de memoria en bytes que pueden consumir todas las tareas simultáneas de generación de objetivos en ejecución. Por ejemplo, 2.5GB. Especifique unidades mediante las siguientes abreviaturas que distinguen mayúsculas y minúsculas:
• b (bytes)
• kb (kilobytes)
• mb (megabytes)
• gb (gigabytes)
• tb (terabytes)
Si no se especifica ninguna unidad, se supone que la unidad es b. Por defecto, este parámetro se define en 1.5GB.
* 
Este parámetro se puede definir en cero para indicar que no debe haber ningún límite en la cantidad de memoria que consuman las tareas de generación de objetivos. No se recomienda definir este parámetro en cero en un entorno de producción; de lo contrario, Experience Service puede bloquearse si las tareas de generación de objetivos consumen toda la memoria disponible.
targetGenerator.image.disable
Para activar la generación de objetivos tipo imagen, defina esta propiedad en false. Para desactivarla, defínala en true. Por defecto, este parámetro se define en false.
targetGenerator.image.maxImageSize
Este parámetro define el tamaño máximo de fichero para una imagen que requiere generación de objetivos. Si el tamaño de fichero de una imagen que requiere generación de objetivos excede el límite de targetGenerator.image.maxImageSize, la solicitud de publicación se rechaza con un estado HTTP 413.
* 
Este límite no se aplica a las imágenes que no requieren generación de objetivos.
Por defecto, este parámetro se define en 0, lo que indica que no hay ningún límite en el tamaño de fichero para imágenes que requieren generación de objetivos. Defina este parámetro con un número entero positivo para especificar el tamaño máximo de fichero en bytes. Especifique unidades mediante las siguientes abreviaturas que distinguen mayúsculas y minúsculas:
• b (bytes)
• kb (kilobytes)
• mb (megabytes)
• gb (gigabytes)
Si no se especifica ninguna unidad, se supone que la unidad es bytes.
targetGenerator.model.disable
Este parámetro se puede configurar mediante el instalador. Para activar la generación de objetivos tipo modelo, defina esta propiedad en false. Para desactivarla, defínala en true.
targetGenerator.model.maxModelSize
Este parámetro define el tamaño máximo de fichero para un modelo que requiere generación de objetivos. Si el tamaño de fichero de un modelo que requiere generación de objetivos excede el límite de targetGenerator.model.maxModelSize, la solicitud de publicación se rechaza con un estado HTTP 413.
* 
Este límite no se aplica a los modelos que no requieren generación de objetivos tipo modelo.
Por defecto, este parámetro se define en 0, lo que indica que no hay ningún límite en el tamaño de fichero para modelos que requieren generación de objetivos. Defina este parámetro con un número entero positivo para especificar el tamaño máximo de fichero en bytes. Especifique unidades mediante las siguientes abreviaturas que distinguen mayúsculas y minúsculas:
• b (bytes)
• kb (kilobytes)
• mb (megabytes)
• gb (gigabytes)
Si no se especifica ninguna unidad, se supone que la unidad es bytes.
targetGenerator.model.maxPolygons
Este parámetro define la cantidad máxima de polígonos contenidos en un modelo que requiere generación de objetivos. El número de polígonos está muy correlacionado con la cantidad de memoria que se requiere para la generación de objetivos. Este límite lo impone Vuforia Studio, no Experience Service. Si el número de polígonos de un modelo que requiere generación de objetivos excede el límite detargetGenerator.model.maxPolygons, Vuforia Studio no permitirá que el modelo se publique.
Defina este parámetro con un número entero positivo para limitar el número de polígonos que se pueden contener en un modelo que requiere generación de objetivos. Este parámetro se puede definir en cero para indicar que no debe haber ningún límite en la cantidad de polígonos. Por defecto, este parámetro se define en 500,000.
Este es un ejemplo de fragmento JSON que configura Experience Service como se indica a continuación:
• Permite la generación de objetivos tipo modelo y tipo imagen en Experience Service
• Limita a 4 la cantidad de tareas simultáneas de generación de destinos
• Limita a 3 minutos la cantidad de tiempo permitido para completar una solicitud de publicación que requiere generación de destinos
• Limitar a 4 GB la cantidad de memoria que puedan consumir todas las tareas simultáneas de generación de destinos en ejecución
• Limita a 80 MB el tamaño de un modelo que requiere la generación de destinos
• Limita a 300 000 el número de polígonos de un modelo que requiere la generación de destinos
• Limita a 10 MB el tamaño de una imagen que requiere la generación de destinos
"targetGenerator": {
"maxTasks": 4,
"timeout": 180000,
"maxMemory": "4GB",
"model": {
"maxModelSize": "80MB",
"maxPolygons": 300000,
"disable": false
},
"image": {
"maxImageSize": "10MB",
"disable": false
}
}