PC-Schnellstartanleitung
Das LCC Unity SDK importieren und eine 3DGS-Szene in Unity von Grund auf rendern.
Voraussetzungen
Stellen Sie vor dem Beginn sicher, dass Ihr Entwicklungsrechner die Hardware- und Unity-Versionsanforderungen erfüllt und dass Sie das LCC Unity SDK-Paket bezogen haben. Details finden Sie unter Anforderungen an die Entwicklungsumgebung.
- Unity-Version: vollständig getestet und verifiziert auf Unity 2022.3.62f1, Unity 6000.0.69f1 und Unity 6000.5.9f1
- Render-Pipeline: getestet und verifiziert auf der Built-in-Pipeline und der Universal Render Pipeline (URP)
- Das LCC Unity SDK-Paket wurde heruntergeladen (SDK-Download).
Grundlegender Ablauf
Schritt 1: Ein URP-Projekt erstellen
Erstellen Sie am Beispiel von Unity 6.0 LTS ein Universal 3D-Projekt (URP).
Die Built-in-Version des LCC Unity SDK unterstützt Unity 2022.3 LTS (einschließlich Built-in- und URP-Pipeline); andere Versionen unterstützen nur die URP-Pipelines. Achten Sie beim Erstellen eines Projekts mit Unity 6.0 LTS oder neuer darauf, die Vorlage „Universal 3D“ auszuwählen.
Ein Universal-3D-Projekt (URP) mit Unity 6.0 LTS erstellen
Schritt 2: Das LCC SDK-Paket importieren
- Öffnen Sie in Unity den Paket-Manager über Fenster → Paket-Manager.
- Klicken Sie oben links auf die Schaltfläche ＋ und wählen Sie Paket von Datenträger installieren.
Im Paket-Manager „Paket von Datenträger installieren“ auswählen
- Navigieren Sie im erscheinenden Dateidialog zum Speicherort des LCC SDK-Pakets, wählen Sie dessen Datei
package.jsonund klicken Sie auf Öffnen, um das Paket zu importieren.
Die Datei package.json im zu importierenden Paket auswählen
- Unity beginnt mit dem Import des LCC SDK-Pakets. Wählen Sie nach Abschluss des Imports im Paket-Importbereich Samples, um die Nutzungsbeispiele zu importieren.
Die Samples im Paket-Importbereich importieren
Damit ist der Import des LCC SDK-Pakets abgeschlossen.
Schritt 3: Die Grafik-API konfigurieren
Öffnen Sie das Einstellungsfenster über Bearbeiten → Projekteinstellungen → Player, wählen Sie im Tab der jeweiligen Plattform den Eintrag Weitere Einstellungen und konfigurieren Sie die Grafik-API pro Plattform:
| Plattform | Aktion |
|---|---|
| Windows | Automatische Grafik-API für Windows deaktivieren und DirectX12, Vulkan und DirectX11 hinzufügen |
| macOS | Automatische Grafik-API für Mac deaktivieren und Metal beibehalten |
| Linux | Automatische Grafik-API für Linux deaktivieren und Vulkan beibehalten |
Die Grafik-API für jede Plattform in den Player-Einstellungen konfigurieren
Hinweis: Bevorzugen Sie Gamma als Farbraum.
Schritt 4: Die Beispielszene öffnen
Öffnen Sie die importierte Beispielszene; sie befindet sich standardmäßig unter Projekt → Samples/LCC SDK/X.X.X/LCC SDK/LCCViewer (X.X.X ist die Paketversionsnummer).
Die Szene LCCViewer im Sample öffnen
Hinweis:
Wählen Sie in der geöffneten Szene das GameObject LCCManager im Fenster Hierarchie aus; prüfen Sie im Fenster Inspektor, ob die Komponente LCCManager angehängt ist (in manchen Fällen kann die Komponente verloren gehen), und fügen Sie sie andernfalls über Komponente hinzufügen hinzu.
Schritt 5: Den Datenpfad festlegen
Wählen Sie in der geöffneten Szene das GameObject LCCRenderer im Fenster Hierarchie aus; richten Sie im Fenster Inspektor die Eigenschaft File Path des LCC Renderer-Skripts auf das Datenverzeichnis. Beachten Sie, dass sie direkt auf die Datei xxx.lcc2 zeigen muss.
Den File Path des LCC Renderer im Inspektor festlegen
Hinweis:
Prüfen Sie in der geöffneten Szene, ob die Eigenschaft Manager der am GameObject LCCRenderer angehängten Komponente LCCRenderer mit der Komponente LCCManager belegt ist (in manchen Fällen kann die Referenz verloren gehen), und ziehen Sie andernfalls das GameObject LCCManager auf diese Eigenschaft.
Pfadsyntax für die verschiedenen Plattformen (Beispiele):
| Plattform | Pfadsyntax | Beispiel |
|---|---|---|
| Windows | Doppelte Backslashes \\oder einen einzelnen Backslash \ verwenden | G:\\GaussianSplat\\0315-art-center\\xxx.lcc2 |
| macOS | Schrägstriche / verwenden | /users/data/lcc/xxx.lcc2 |
| Server | Schrägstriche / verwenden | https://xgus1.blob.core.windows.net/lcc-pub/Tower/xxx.lcc2 |
Hinweis:
- Die Transform des LCCRenderer muss dem obigen Bild entsprechen, wodurch sie am Daten-Koordinatensystem ausgerichtet wird. Wird dieses GameObject per Code erstellt, müssen Rotation und Scale ebenfalls dem obigen Bild entsprechen.
- Aufgrund des Daten-Koordinatensystems muss in Unity die Transform des GameObjects, das den Renderer trägt, wie oben dargestellt gesetzt werden (dies kann zur Laufzeit auch per Code erfolgen). Details zur Ausrichtung am Koordinatensystem finden Sie unter „LCC-Daten-Koordinatensystem“ in Einführung in das Unity SDK.
Schritt 6: Die Eingabeverarbeitung anpassen
Unity 6.0 LTS und neuer verwenden standardmäßig das Eingabesystem (Input System), während die Kamera in den Samples den Input Manager verwendet; daher muss der Modus der Eingabeverarbeitung angepasst werden.
Öffnen Sie das Einstellungsfenster über Bearbeiten → Projekteinstellungen → Player, suchen Sie im Abschnitt Weitere Einstellungen die Option Aktive Eingabeverarbeitung und stellen Sie sie auf Beides.
Aktive Eingabeverarbeitung auf „Beides“ einstellen
Schritt 7: Ausführen
Klicken Sie in Unity auf die Schaltfläche Play, und Sie sehen die gerenderte Szene.
Die gerenderte 3DGS-Szene nach dem Ausführen