Guía de inicio rápido para PC
Importa el LCC Unity SDK y renderiza una escena 3DGS en Unity desde cero.
Requisitos previos
Antes de empezar, asegúrate de que tu equipo de desarrollo cumple los requisitos de hardware y de versión de Unity, y de que has obtenido el paquete del LCC Unity SDK. Consulta Requisitos del entorno de desarrollo para más detalles.
- Versión de Unity: probada y verificada por completo en Unity 2022.3.62f1, Unity 6000.0.69f1 y Unity 6000.5.9f1
- Pipeline de renderizado: probado y verificado en Built-in Pipeline y Universal Render Pipeline (URP)
- Se ha descargado el paquete del LCC Unity SDK (Descarga del SDK).
Flujo de trabajo básico
Paso 1: Crear un proyecto URP
Usando Unity 6.0 LTS como ejemplo, crea un proyecto Universal 3D (URP).
La versión Built-in del LCC Unity SDK es compatible con Unity 2022.3 LTS (incluidos los pipelines Built-in y URP); las demás versiones solo admiten los pipelines URP. Al crear un proyecto con Unity 6.0 LTS o posterior, asegúrate de seleccionar la plantilla Universal 3D.
Crear un proyecto Universal 3D (URP) con Unity 6.0 LTS
Paso 2: Importar el paquete del LCC SDK
- En Unity, abre el Package Manager mediante Ventana → Administrador de paquetes.
- Haz clic en el botón ＋ de la esquina superior izquierda y selecciona Instalar paquete desde disco.
Seleccionar Instalar paquete desde disco en el Administrador de paquetes
- En el diálogo de archivo que aparece, navega hasta la ubicación del paquete del LCC SDK, selecciona su archivo
package.jsony haz clic en Abrir para importar el paquete.
Seleccionar el archivo package.json del paquete a importar
- Unity comienza a importar el paquete del LCC SDK. Cuando la importación finalice, selecciona Samples en el panel de importación del paquete para importar las muestras de uso.
Importar las Samples en el panel de importación del paquete
En este punto, la importación del paquete del LCC SDK ha finalizado.
Paso 3: Configurar la API gráfica
Abre el panel de ajustes mediante Editar → Ajustes del proyecto → Player, selecciona la entrada Otros bajo la pestaña de la plataforma correspondiente y configura la API gráfica por plataforma:
| Plataforma | Acción |
|---|---|
| Windows | Desmarca Auto Graphics API para Windows y añade DirectX12, Vulkan y DirectX11 |
| macOS | Desmarca Auto Graphics API para Mac y mantén Metal |
| Linux | Desmarca Auto Graphics API para Linux y mantén Vulkan |
Configurar la API gráfica para cada plataforma en los ajustes de Player
Nota: se recomienda Gamma para el espacio de color.
Paso 4: Abrir la escena de ejemplo
Abre la escena de ejemplo importada, ubicada por defecto en Proyecto → Samples/LCC SDK/X.X.X/LCC SDK/LCCViewer (X.X.X es el número de versión del paquete).
Abrir la escena LCCViewer de la muestra
Nota:
En la escena abierta, selecciona el GameObject LCCManager en el panel Jerarquía; comprueba en la ventana Inspector si el componente LCCManager está adjunto (en algunos casos el componente puede perderse) y, si no lo está, añádelo mediante Agregar componente.
Paso 5: Establecer la ruta de datos
En la escena abierta, selecciona el GameObject LCCRenderer en el panel Jerarquía; en el panel Inspector, apunta la propiedad File Path del script LCC Renderer al directorio de datos. Ten en cuenta que debe apuntar directamente al archivo xxx.lcc2.
Establecer la File Path del LCC Renderer en el Inspector
Nota:
En la escena abierta, comprueba si la propiedad Manager del componente LCCRenderer adjunto al GameObject LCCRenderer tiene asignado el componente LCCManager (en algunos casos la referencia puede perderse) y, si no es así, arrastra el GameObject LCCManager a esa propiedad.
Sintaxis de ruta para diferentes plataformas (ejemplos):
| Plataforma | Sintaxis de ruta | Ejemplo |
|---|---|---|
| Windows | Usa doble barra invertida \\o una barra invertida \ | G:\\GaussianSplat\\0315-art-center\\xxx.lcc2 |
| macOS | Usa barras / | /users/data/lcc/xxx.lcc2 |
| Servidor | Usa barras / | https://xgus1.blob.core.windows.net/lcc-pub/Tower/xxx.lcc2 |
Nota:
- El Transform del LCCRenderer debe coincidir con la imagen anterior, lo que lo alinea con el sistema de coordenadas de los datos. Si este GameObject se crea mediante código, configura su Rotation y Scale para que coincidan también con la imagen anterior.
- Debido al sistema de coordenadas de los datos, en Unity el Transform del GameObject que contiene el Renderer debe configurarse como se muestra arriba (esto también puede hacerse en tiempo de ejecución mediante código). Para más detalles sobre la alineación del sistema de coordenadas, consulta "Sistema de coordenadas de los datos LCC" en Introducción al SDK de Unity.
Paso 6: Ajustar la gestión de entrada
Unity 6.0 LTS y posterior usan Input System por defecto, mientras que la cámara de las Samples usa Input Manager, por lo que es necesario ajustar el modo de gestión de entrada.
Abre el panel de ajustes mediante Editar → Ajustes del proyecto → Player, busca Active Input Handling bajo la sección Other Settings y configúralo como Both.
Establecer Active Input Handling como Both
Paso 7: Ejecutar
Haz clic en el botón Ejecutar de Unity y verás la escena renderizada.
La escena 3DGS renderizada tras la ejecución