Guida rapida per PC
Importa l'LCC Unity SDK ed esegui il rendering di una scena 3DGS in Unity partendo da zero.
Prerequisiti
Prima di iniziare, assicurati che il tuo computer di sviluppo soddisfi i requisiti hardware e di versione di Unity e di aver ottenuto il pacchetto LCC Unity SDK. Per i dettagli, consulta Requisiti dell'ambiente di sviluppo.
- Versione di Unity: completamente testata e verificata su Unity 2022.3.62f1, Unity 6000.0.69f1 e Unity 6000.5.9f1
- Pipeline di rendering: testata e verificata su Built-in Pipeline e Universal Render Pipeline (URP)
- Il pacchetto LCC Unity SDK è stato scaricato (Scarica l'SDK).
Flusso di lavoro di base
Passaggio 1: crea un progetto URP
Usando Unity 6.0 LTS come esempio, crea un progetto Universal 3D (URP).
La versione Built-in dell'LCC Unity SDK supporta Unity 2022.3 LTS (incluse le pipeline Built-in e URP); le altre versioni supportano solo le pipeline URP. Quando crei un progetto con Unity 6.0 LTS o versioni successive, assicurati di selezionare il modello Universal 3D.
Crea un progetto Universal 3D (URP) con Unity 6.0 LTS
Passaggio 2: importa il pacchetto LCC SDK
- In Unity, apri Gestione pacchetti tramite Finestra → Gestione pacchetti.
- Fai clic sul pulsante ＋ nell'angolo in alto a sinistra e seleziona Installa pacchetto da disco.
Seleziona Installa pacchetto da disco in Gestione pacchetti
- Nella finestra di dialogo del file che appare, vai alla posizione del pacchetto LCC SDK, seleziona il suo file
package.jsone fai clic su Apri per importare il pacchetto.
Seleziona il file package.json nel pacchetto da importare
- Unity inizia a importare il pacchetto LCC SDK. Al termine dell'importazione, seleziona Samples nel pannello di importazione del pacchetto per importare gli esempi di utilizzo.
Importa i Samples nel pannello di importazione del pacchetto
A questo punto, l'importazione del pacchetto LCC SDK è completa.
Passaggio 3: configura l'API grafica
Apri il pannello delle impostazioni tramite Modifica → Impostazioni progetto → Player, seleziona la voce Altro nella scheda della piattaforma corrispondente e configura l'API grafica per ciascuna piattaforma:
| Piattaforma | Azione |
|---|---|
| Windows | Deseleziona API grafiche automatiche per Windows e aggiungi DirectX12, Vulkan e DirectX11 |
| macOS | Deseleziona API grafiche automatiche per Mac e mantieni Metal |
| Linux | Deseleziona API grafiche automatiche per Linux e mantieni Vulkan |
Configura l'API grafica per ciascuna piattaforma nelle impostazioni Player
Nota: preferisci Gamma per lo spazio colore.
Passaggio 4: apri la scena di esempio
Apri la scena di esempio importata, situata per impostazione predefinita in Project → Samples/LCC SDK/X.X.X/LCC SDK/LCCViewer (X.X.X è il numero di versione del pacchetto).
Apri la scena LCCViewer nell'esempio
Nota:
Nella scena aperta, seleziona il GameObject LCCManager nel pannello Gerarchia; verifica nella finestra Inspector se il componente LCCManager è collegato (in alcuni casi il componente potrebbe andare perso) e, in caso contrario, aggiungilo tramite Aggiungi componente.
Passaggio 5: imposta il percorso dei dati
Nella scena aperta, seleziona il GameObject LCCRenderer nel pannello Gerarchia; nel pannello Inspector, imposta il File Path dello script LCC Renderer sulla directory dei dati. Nota che deve puntare direttamente al file xxx.lcc2.
Imposta il File Path di LCC Renderer nell'Inspector
Nota:
Nella scena aperta, verifica se la proprietà Manager del componente LCCRenderer collegato al GameObject LCCRenderer ha assegnato il componente LCCManager (in alcuni casi il riferimento potrebbe andare perso) e, in caso contrario, trascina il GameObject LCCManager su tale proprietà.
Sintassi dei percorsi per le diverse piattaforme (esempi):
| Piattaforma | Sintassi del percorso | Esempio |
|---|---|---|
| Windows | Usa doppie barre rovesciate \\oppure una singola barra rovesciata \ | G:\\GaussianSplat\\0315-art-center\\xxx.lcc2 |
| macOS | Usa barre oblique / | /users/data/lcc/xxx.lcc2 |
| Server | Usa barre oblique / | https://xgus1.blob.core.windows.net/lcc-pub/Tower/xxx.lcc2 |
Nota:
- Il Transform di LCCRenderer deve corrispondere all'immagine sopra, il che lo allinea al sistema di coordinate dei dati. Se questo GameObject viene creato tramite codice, imposta anche Rotation e Scale in modo che corrispondano all'immagine sopra.
- A causa del sistema di coordinate dei dati, in Unity il Transform del GameObject che contiene il Renderer deve essere impostato come mostrato sopra (questo può essere fatto anche in fase di esecuzione tramite codice). Per i dettagli sull'allineamento del sistema di coordinate, consulta "Sistema di coordinate dei dati LCC" in Introduzione all'Unity SDK.
Passaggio 6: regola la gestione dell'input
Unity 6.0 LTS e versioni successive utilizzano Input System per impostazione predefinita, mentre la camera nei Samples utilizza Input Manager, quindi è necessario regolare la modalità di gestione dell'input.
Apri il pannello delle impostazioni tramite Modifica → Impostazioni progetto → Player, trova Gestione input attiva nella sezione Altre impostazioni e impostala su Both.
Imposta Gestione input attiva su Both
Passaggio 7: esegui
Fai clic sul pulsante Run in Unity e vedrai la scena renderizzata.
La scena 3DGS renderizzata dopo l'esecuzione