Flujo de modelado

Esta página describe el flujo completo de una tarea de modelado desde su creación hasta la descarga de sus resultados, las transiciones de estado de la tarea y el contenido de los resultados del modelado. Completa la configuración de la Guía de acceso antes de llamar a las API.

Requisitos de los datos de entrada

Elige los datos de entrada según tus necesidades de modelado:

Tipo de entrada	Descripción	Recomendación
Paquete de escena LCC2	Directorio completo de la escena, con recursos relacionados como `info/poses.json` y con trayectoria de captura	Preferible cuando necesitas un modelo con detalle fino, texturas nítidas y texto legible
Nube de puntos LAS	Nube de puntos LiDAR sin trayectoria de captura. Debe contener color RGB (Point Data Record Format 2 / 3 / 5 / 7 / 8 / 10). No se admiten archivos LAS sin color	Preferible cuando necesitas una alta precisión dimensional
Nube de puntos PLY	Nube de puntos 3DGS completa; se puede procesar sin trayectoria de captura	Úsala cuando no dispongas ni de un paquete de escena LCC2 ni de una nube de puntos LAS

Se admiten dos formas de carga:

Forma de directorio: sube varios archivos directamente al directorio input, conservando sus rutas relativas.
Forma de archivo comprimido: sube un .zip; el servidor lo descomprime automáticamente.

Flujo mínimo de integración

Crear una tarea: llama a Crear tarea y obtener las credenciales de carga. El modelado automático está activado de forma predeterminada (autoRebuild = 1). La respuesta contiene el modelId de la tarea y las credenciales temporales necesarias para la carga.
Subir los datos de entrada: con las credenciales temporales del paso anterior, sube los datos por partes mediante la API de almacenamiento de objetos del proveedor de nube correspondiente. Consulta Credenciales temporales de carga. La Key final del archivo es savePath más la ruta relativa del archivo, por ejemplo savePath + "render2/info/poses.json".
Notificar la finalización de la carga: cuando todos los archivos estén subidos, llama a Actualizar el estado de carga con status = 3. A continuación, el sistema inicia el modelado automáticamente.
Consultar el progreso de la tarea: llama a Lista paginada de tareas o a Detalles de tareas y observa status y percent. status = 8 significa que el modelado ha finalizado; status = 9 significa que el modelado ha fallado. No consultes con una frecuencia mayor de una vez cada 5 segundos.
Descargar los resultados: llama a Descargar los resultados del modelado para obtener enlaces de descarga temporales.

Nota: La concurrencia de tareas de modelado no está limitada. Puedes enviar varias tareas a la vez; cada una entra en la cola justo después de enviarse y el centro de cálculo la programa a medida que quedan nodos libres.

Otros flujos admitidos

Carga reanudable y credenciales caducadas

Si una carga se interrumpe o las credenciales temporales caducan, llama a Obtener de nuevo las credenciales de carga para obtener nuevas credenciales temporales de carga y, a continuación, continúa con la carga por partes.

Iniciar el modelado manualmente

Se aplica cuando la tarea se creó con autoRebuild = 0 y todos los datos de entrada se han subido. Llama a Iniciar tarea para iniciar el modelado manualmente.

Máquina de estados de la tarea

status	Significado	Descripción
0	Esperando carga	Tarea creada, carga no iniciada
1	Cargando	Estado predeterminado tras crear la tarea
2	Carga en pausa	Pausa notificada por el integrador
3	Carga completada	Tras la notificación, el servidor analiza el directorio `input`; con `autoRebuild = 1`, el modelado se inicia automáticamente
4	Carga fallida	Fallo notificado por el integrador
5	Esperando entrar en cola	Estado reservado; no se produce en los escenarios de la API abierta
6	En cola	Enviada al centro de cálculo, esperando un nodo libre
7	Modelando	Observa `percent` para conocer el progreso del modelado
8	Modelado completado	Llama a la API de descarga para obtener los resultados
9	Modelado fallido	Lee `errorCode` y `failedReason` para averiguar la causa

Transiciones de estado con modelado automático:

0 Waiting for upload → 1 Uploading → 3 Upload completed → 6 Queued → 7 Modeling → 8 Modeling completed
                           ↓                                                 ↓
                     4 Upload failed                                 9 Modeling failed

Resultados del modelado

Al finalizar el modelado se generan los siguientes resultados. Las descargas principales son los tres archivos en coordenadas nativas de LCC.

Archivo de resultado	Valor de type	Descripción	Unidades y coordenadas
`model_align_scan.dxf`	`DXF`	Dibujo vectorial editable, malla 3D 3DFACE	Milímetros, 1:1, coordenadas nativas de LCC
`model_align_scan.glb`	`GLB`	Modelo 3D GLB, listo para previsualización o motores	Metros, Z-up explícito, coordenadas nativas de LCC
`model_align_scan.blend`	`BLEND`	Archivo de proyecto de Blender editable	Coordenadas nativas de LCC
`model_align_scan.rvt`	`RVT`	Modelo de Revit	Coordenadas nativas de LCC

Otros resultados auxiliares son una imagen BEV del plano de planta, una imagen de superposición de la nube de puntos, una imagen de la distribución del mobiliario, una previsualización renderizada general y los metadatos de transformación de coordenadas coordinate_transform.json.