Grundlagen bis Fortgeschritten · 30+ Minuten
Machen Sie Ihr eigenes Zimmer.
Ein Raum ist ein selbstständiger 3D-Raum mit mindestens einem Sitzplatz. Bauen und überprüfen Sie ihn in Ihrem bevorzugten 3D-Tool, verbinden Sie anschließend den fertigen USDZ mit Locus mit vier kleinen Begleitdateien.
Grundlegend
Baue den kleinsten funktionierenden Raum
Der öffentliche minimale Raumbaumeister startet mit einer leeren Blender-Szene. Er erstellt einen Schreibtisch, einen kalibrierten Sitz, zwei Wände, ein Dach, eine gesteuerte Pendelleuchte, ein Thumbnail und sitzende Review-Bilder.
Sie benötigen: macOS, Blender 5.2, Python 3 und eine lokale Kopie des öffentlichen Locus Support-Repository. Der Builder führt Blender im Hintergrund aus; keine Blender MCP-Verbindung ist erforderlich.
- Führen Sie den minimalen Raumbaumealer aus. Wählen Sie einen neuen Ausgabordner aus. Der Builder weigert sich, einen bestehenden zu überschreiben.
- Überprüfen Sie jedes Bild in der Überprüfung/. Prüfen Sie die Schreibtischhöhe, die Augenposition, den Freiraum, die Ausrichtung, die Materialien und das Licht vom tatsächlichen Sitzplatz.
- Packen und validieren Sie das Zimmer. Die aktuellen öffentlichen Tools erstellen einen Legacy/einfachen flachen Kompatibilitäts-ZIP und überprüfen seine Dateien, Metadaten, das Modell und die Grenzen.
- Importieren Sie das genaue ZIP. Wählen Sie in Locus Orte → Importieren → Einen Raum importieren → Dateien.
- Probieren Sie den Sitz auf Apple Vision Pro aus. Paare den Raum mit einem Ausblick, betrete den virtuellen Raum, setze dich an den Leseschreibtisch und teste die Raumbeleuchtung in den Schnellsteuerung.
blender --background --factory-startup --python-exit-code 1 \
--python tools/build_minimal_room.py -- \
--output /absolute/path/to/minimal-reading-room
python3 tools/pack_locus_asset.py \
/absolute/path/to/minimal-reading-room/room \
/absolute/path/to/minimal-reading-room.zip
python3 tools/validate_locus_asset.py \
/absolute/path/to/minimal-reading-room.zipVerwenden Sie den absoluten Pfad zu Blender, wenn die blender Befehl ist im Terminal nicht verfügbar.
Kompatibilitätsvertrag
Die fünf Dateien verstehen
my-room.zip
├── space.json
├── provenance.json
├── teleport-points.json
├── scene.usdz
└── thumbnail.jpg- scene.usdz enthält den selbstständigen, metermessbaren +Y-aufwärts Raum.
- space.json Benennt den Raum und verbindet optionale Öffnungen, Oberflächen, Beleuchtung, Renderungsrollen und Animationen.
- teleport-points.json Gibt Locus mindestens eine verwendbare Augenposition und Ausrichtung.
- provenance.json Aufrichtig Aufzeichnungen-Ersteller, Rechte, angeforderter Urheberrecht, Änderungen und KI-Nutzung.
- thumbnail.jpg zeigt den Raum in Places an. Locus erstellt ihn nicht für Sie.
Dies ist das Legacy/einfache Kompatibilitätslayout. Legen Sie alle fünf Dateien am Wurzelort ab. Fügen Sie kein übergeordnetes Verzeichnis, die Datei Blender, Quelltexturen, GLB, Caches oder Überprüfungsbilder hinzu. Jede Importdatei erhält einen neuen UUID.
Kanonische Lieferung in Locus 1.2.1 und später: Verwenden Sie das vollständige Package v2, wenn Sie stabile IDs, vor Ort-Updates, Sound, Animationen, Videooberflächen, Sitzgruppen, Herkunft oder gebündelte Erlebnisse benötigen. Sein ZIP-Wurzel enthält direkt
locusplace.json Und catalog/. Siehe die Kompletter Package v2-Guide.Fortgeschritten
Verwandeln Sie Ihre Architektur in einen Produktionsraum
- Design nach Gebrauch. Bieten Sie jedem offiziellen Sitzplatz einen nutzbaren Tisch oder Arbeitsflächen, ausreichend Platz zum Entspannen und eine gezielte Sichtlinie.
- Arbeiten in Metern und Export +Y hoch. Locus verwendet world -Z als Vordername. Halten Sie jeden metadatenreferenzierten Entitätsnamen stabil und einzigartig.
- Öffnungszeiten und Plätze angeben. Modellfenster und Öffnungen in der Geometrie; die Metadaten beschreiben, wie der fertige Raum mit der ausgewählten Ansicht verbunden ist.
- Fügen Sie nur die Steuerelemente hinzu, die der Raum benötigt. Optionales Metadaten kann Tablet-Oberflächen, besuchergesteuerte Lichter, weiche View-Reflektionen, UI-Fade-Berechtigungen und experimentelle Ambient-Animationen abbilden.
- Quellenprobleme in der Quelle beheben. Korrekte Geometrie, UVs, Materialien, Texturen, Skalierung und Lichtrichtung im bearbeitbaren Asset, dann erneut exportieren.
- Jeden deklarierten Sitzplatz validieren und testen. Ein gültiges ZIP kann sich immer noch zu groß, beengt, blockiert oder unangenehm anfühlen. Die endgültige Platzierung und Komfortprüfungen erfordern Apple Vision Pro.
Fortgeschrittener Leitfaden zur ZimmerintegrationSitze, Öffnungen, Oberflächen, Beleuchtung, Renderingssteuerung, Animation, Validierung und Gerätekontrollen.Optionales KI-Raumbau-FähigkeitswerkzeugGib einem Coding-Agenten den Vertrag, die Designsprache, den Blender-Workflow und die Lieferprüfungen.Raum und Ansicht ZIP ReferenzKomplettes Package v2, Kompatibilitäts-Eingaben, Beispiele, Herkunft und Verpackung.Vollständige FormatreferenzGenaue Felder, Koordinaten, Standardwerte, Grenzen und Migrationen.