Erstelle aus einer Idee eine passende View mit dem Tutorial für statische Skyboxen.

Mit Package v2 beginnen

Verwende für einen aktuellen Raum vollständiges Package v2. Es gibt einem Raum stabile Identität, Aktualisierungen und aktuell unterstützte Funktionen. Packe einen Raum und seine zugehörige Ansicht standardmäßig getrennt, damit beide unabhängig ausgeliefert, ersetzt oder entfernt werden können.

Einen vollständigen Package-v2-Raum erstellen und validieren.

Beispiele herunterladen

Kostenlose Räume und ausgewählte kostenlose Views kannst du als Beispiele zum Lernen herunterladen, einige mit ihrer Blender-Quelldatei. Beispiele in der Galerie ansehen.

Coding-Agents können in place-examples.json URL, Größe, SHA-256, Funktionen und Lizenz jedes Downloads nachlesen.

Historische Studienarchive für Räume

Diese flachen Kompatibilitäts-ZIPs bleiben verfügbar, um ihre Materialien und öffentlichen Metadaten neben dem fertigen USDZ zu studieren. Sie sind kein Leitfaden für aktuelle Package-v2-Funktionen.

Öffne die historischen Downloads und Kompatibilitätshinweise

Frühere kompatible Downloads: Atrium Loft, Hofgalerie, Horizon Atelier.

Die von Locus geschriebenen Teile sind unter CC BY 4.0 wiederverwendbar; eingebettete Poly Haven-Texturen bleiben CC0. Siehe die Credits und Lizenzdetails.

Wählen Sie den Liefervertrag

Vollständiges Package v2 ist ab Locus 1.2.1 das empfohlene vollständige Importformat. Direkt in der ZIP-Wurzel liegen locusplace.json und catalog/, und ein Zimmer lebt unter catalog/spaces/<space-id>/. Verwenden Sie es für stabile IDs und direkte Updates, Ton, Animationen, Videoflächen, Sitzgruppen, übersetzte Anzeigetexte, Herkunftsangaben, unterstützte Raum-/Ansichtskombinationen und gebündelte Experiences. Erstellen Sie es mit tools/pack_locusplace.py; prüfen Sie es mit tools/validate_locusplace.py, führen Sie dann check_room.py mit der Zielversion und einem ausdrücklich leeren Render-Verzeichnis aus; prüfen Sie das Kontaktblatt der Sitz-Renderings.

Für normales Authoring paketiere einen Raum und seine zugehörige Ansicht getrennt: Beide erhalten ihr eigenes Archiv und eine stabile packageID, damit er unabhängig ausgeliefert, ersetzt und entfernt werden kann. Ein kombiniertes Package-v2-Archiv bleibt für Inhalte unterstützt, die absichtlich einen Lebenszyklus teilen, ist aber nicht der Standard-Workflow für Räume.

Der vorhandene Raumbuilder und das Gerüstwerkzeug erzeugen absichtlich das unten beschriebene ältere/einfache flache Kompatibilitätsformat. Packer und Validator bleiben für einfache Importe nützlich; ein flaches Archiv kann jedoch keine Felder enthalten, die vollständige Pakete voraussetzen. Jeder flache Import erhält eine neue UUID.

Legacy/einfacher Liefervertrag

Liefern Sie einen flachen Kompatibilitäts-ZIP mit genau fünf Stammdateien:

my-room.zip
├── space.json
├── provenance.json
├── teleport-points.json
├── scene.usdz
└── thumbnail.jpg

Behalten Sie bearbeitbare Quellen, Texturen, Caches und Austauschdateien außerhalb des ZIP. Jede durch Metadaten referenzierte Entität muss einen stabilen, eindeutigen Namen im gelieferten USDZ haben.

Öffnungszeiten und Plätze

Vor Locus 1.4.5 deklariert jeder Room genau einen viewOpenings -Eintrag; ab 1.4.5 (formatVersion: 11 in flachen ZIPs oder destinationOpenings , in Package v2 über [x, y, z, w] Bestellung.

Jeder Teleportationspunkt definiert eine Augenposition und eine Blickrichtung. anchorXZ wird in die exportierten Raumgrenzen normalisiert; sourceFloorOffset Identifiziert sein Niveau; eyeHeight Wird von diesem Boden aus gemessen. Sitzplatz-IDs sind Teil der Zimmer-Oberfläche, daher halten Sie sie bei Überarbeitungen konsistent.

Autor für die Nutzung, nicht nur für die Vorschau. Importieren Sie genau die ZIP-Datei, die Sie ausliefern, und setzen Sie sich auf Apple Vision Pro auf jeden Sitzplatz. Auch ein strukturell gültiger Raum kann eine unangenehme Augenhöhe, eine versperrte Sicht, einen falschen Maßstab oder zu wenig Freiraum haben.

Optionaler räumlicher Anpassung

spatialAdaptation Verbindet semantische Teile Ihres USDZ mit den Funktionen von Locus:

FeldVertrag
wallEntitiesValidierte Wandreferenzen; diese verbergen keine virtuellen Wände oder öffnen das Raumportal.
roofEntitiesValidierte Dach- oder Deckenreferenzen; diese verbergen das virtuelle Dach nicht.
deskEntitiesByTeleportIDVerwaltet eine Sitzplatz-ID mit der exakten Entität für die Tischoberfläche. Ein Sitzplatz, der aus dieser Karte ausgeschlossen ist, ist ein erstklassiger Loungesitz (Sofa, Tagesbett, Bank): Er wird auf seiner vom Autor festgelegten Bodenhöhe und Augenhöhe geladen und erhält niemals Maße, Ausrichtung oder Durchgangsbreite für den Schreibtisch – zeichne keinen nahen Couchtisch ein, nur um ihm einen Schreibtisch zu geben.
deskGroupEntitiesByTeleportIDOptional, 1.1.5+. Namen, für einen tischgestützten Sitzplatz, der bereits einen hat deskEntitiesByTeleportID Eintrag, die einzige Entität, deren gesamter Unterbaum dieser Sitzes verdeckbarer Schreibtisch ist, sodass Locus einen Besucher-Schreibtisch-Kontrollbefehl anbieten kann. Die benannte Entität muss eindeutig aufgelöst werden und ein Vorfahre der Schreibtischoberflächenentität sein, sonst lädt sich der Raum nicht. Ältere Leser ignorieren dieses Feld.

Eine kartierte Schreibtischentität sollte der Tisch selbst oder eine eng umgrenzte Platte sein. Beziehen Sie keine Stühle, Lampen, Beine, Computer oder lose Requisiten darunter ein; Locus verwendet die Grenzen der Entität, um die Oberflächenhöhe, den Fußabdruck und die Ausrichtung abzuleiten.

Optionales Beleuchtungsinformatik-Interface

Die Beleuchtungsmetadaten geben Locus an, welche exportierten emissiven Mesh- und begrenzten Laufzeitquellen zu jeder besucherorientierten Kontrolle gehören. Sie legen nicht fest, wie das Zimmer modelliert, schattiert oder gebacken werden soll.

FeldLocus Verhalten
luminaireGroupsEine Gruppe ist ein logischer Schalter und ein Satz von Helligkeits-/Farbeinstellungen.
entitiesBenennt die emissiven Befestigungsgehäuse. Ein aktivierter Befestigungskörper bleibt von jedem Sitz aus sichtbar emissiv.
proxy / proxiesDeklarieren Sie begrenzte Punkt- oder Spotquellen. Verwenden Sie proxies Im Raum v3, wenn ein Schalter mehrere physische Emittoren antreibt.
nearTeleportIDsEs begrenzt nur die direkten Proxy-Quellen auf ausgewählte Sitze; es verbirgt oder verdunkelt den Halterungskörper anderswo nicht.
bakedIndirect.entitiesRaum v3 Empfänger-Unterzweige für niederfrequentes indirektes Licht, das vom Raumlicht-Master und dem Gesamtraum EV gesteuert wird.
bakedIndirect.layersDer direkte und indirekte Beitrag einer Leuchtengruppe zum gemeinsamen Receiver-Atlas, damit Schalter, EV und Farbe dieser Gruppe die umgebenden Flächen beeinflussen.

Die ältere/einfache flache Raumfunktion verwendet formatVersion: 10. Im bevorzugten Package v2, space.json muss bleiben formatVersion: 2; lege lighting.bakedIndirect.layers dort und kopiere niemals die ältere Versionsnummer.

Verwende pro Gruppe gebackene Ebenen, wenn eine unabhängig steuerbare Lampe Wände, Böden, Tische oder Decken sichtbar beleuchten soll. Backe jede Gruppe einzeln und bewahre die Basis-UV plus LocusIndirectUV für den Receiver-Atlas und komponiere den gemeinsamen Atlas mit allen eingeschalteten Gruppen in linearem Licht. Lege das Licht einer schaltbaren Lampe nicht in einen statischen, immer eingeschalteten gemeinsamen Atlas und zähle ihre gebackene Lichtfläche nicht doppelt mit einem Proxy.

Die gemeinsame indirekte Schicht wird mit skaliert 2^overallEV. Einzelne Lichtschalter, Temperatur, Farbe und Helligkeit bleiben lokale Steuerelemente und färben diesen schlichten gemeinsamen Bounce nicht um. Halte Glas, Wasser, durchlässige Materialien, Leucht-Meshes von Leuchten und erkennbare leuchtenspezifische Halos aus dem gemeinsamen indirekten Receiver-Teilbaum heraus; direkte Proxys besitzen lokale Lichtflächen.

Room v3 legt ein Maximum von 12 autorisierten Proxys, 4 aktiven Proxys an jedem Sitzplatz, 1 Schattenwurfproxys, 10.000 Lumen pro Proxy und einen Helligkeitsbereich von -4…+1 EV fest. Dies sind Sicherheitsgrenzen, keine Zielwerte.

Die Beleuchtung ist optional. Auslassen lighting für einen Raum ohne besuchergesteuerte Leuchten. Verwende Room v2 für grundlegende Lichtgruppen, Room v3 für aggregiertes, dem Raum gehörendes gebackenes indirektes Licht und gebackene Ebenen, wenn eine Gruppe ihre Empfangsflächen ändern muss.

Optionale Fernseher

Erfordert Locus 1.4.9 oder neuer und vollständiges Package v2; das flache Kompatibilitätsformat kann keine Fernseher enthalten.

Ein Raum kann bis zu vier Fernseher deklarieren. Jeder benennt einen Bildschirm in der USDZ: ein eigenes, flaches 16:9-Viereck mit eigenen UVs, das nicht unter einer anderen benannten Entität verschachtelt ist. Sein Material ist der ausgeschaltete Zustand des Fernsehers, etwa dunkles Glas oder ein Kunstwerk, und sollte nicht leuchten. Schaltet ein Besucher den Fernseher ein, spielt Locus eine Webseite innerhalb der Grenzen dieses Vierecks ab.

TV-Anleitung lesen oder die Regeln für Room-Fernseher.

Bewahren Sie Ihr Materialdesign auf

Locus verwendet die unterstützten PBR-Materialien, Texturen, UVs und Transformationen in Ihrem exportierten USDZ. Namen wie glass, Möbelgröße und importierte Raumidentität wählen keine Materialvoreinstellungen aus. Korrigieren Sie Material- und Exportprobleme im bearbeitbaren Quellcode und erstellen Sie dann den Raum ZIP neu.

Raum v5 fügt explizit hinzu rendering.softenedReflectionEntities und rendering.uiFadeEntities. Verwenden Sie die erste nur, wenn Sie eine Ansicht mit entferntem horizontalem Szenen-Detail wünschen; sie spiegelt den Innenraum des Raums nicht wider. Verwenden Sie die zweite, um zu ermöglichen, dass ausgewählte Möbel verblassen, während ein Besucherfenster blockiert wird. Ausgelassene Rollen gewähren weder dieses Verhalten.

Jede v5 Spotlight erklärt eine Einheit direction In exportierten Zimmerkoordinaten, wie z.B. [0.6, -0.8, 0]. Es liefert nur die Position des Ankers. Diese Felder erfordern einen v5-fähigen Locus-Build. Verwenden Sie die optionales USD-Modellaudit Um exportierte Referenzen und unterstützte Shader zu überprüfen. Lesen Sie die Unterstützte Materialien, Standardeinstellungen und Migrationsregeln Bevor Sie exportieren.

Experimentelle Ambient-Animationen

Raum v4 kann Animationstipps verbinden, die bereits in den USDZ eingebettet sind, mit benannten Besuchersteuerungen. Jede ambientAnimations Der Eintrag identifiziert eine Entität und eine Animation sowie deren anfänglichen Wechsel, Geschwindigkeitsbereich und Wiedergabeintervallbereich.

Besucher können alle experimentellen Animationen eines Raums mit dem ein- oder ausschalten Raumbewegung Fliese in Schnellsteuerung. In Einstellungen → Bewegung → Raum Sie können jede Animation wechseln, ihre experimentelle Geschwindigkeit und Intervalle ändern und diese Werte dann für diesen Raum auf dem aktuellen Gerät speichern. Ein Intervall von 0–0 Wiederholt sich sofort; unterschiedliche Mindest- und Maximalwerte wählen nach jedem abgeschlossenen Spiel eine frische zufällige Pause aus.

Die Animationsunterstützung ist experimentell. Die Metadaten, das Wiedergabeverhalten, die Steuerelemente, die Geschwindigkeit und die Intervalle können sich ändern. Vermeiden Sie Animationsmetadaten, es sei denn, Sie akzeptieren dieses Risiko absichtlich; dies gilt auch für Animationen in Room v5.

Erweiterte Room-Anleitungen

Sobald Basis-USDZ, Öffnungen und Sitze funktionieren, springen Sie direkt zu den Anleitungen und Referenzen für neuere Package-v2-Room-Funktionen:

Baue den kleinsten funktionierenden Raum

Die Minimalraum-Builder Es startet mit einer leeren Blender-Szene und erstellt einen Schreibtisch, einen kalibrierten Sitzplatz, zwei Wände, ein Dach und eine gesteuerte Pendelleuchte. Es benötigt Blender 5.2 und Python 3 auf macOS. Klonieren oder laden Sie dieses Repository herunter, damit der Builder den gebündelten Metadaten-Stack verwenden kann; keine externen Modelle, Texturen oder MCP-Verbindung sind erforderlich.

  1. Führen Sie vom Stammverzeichnis des Repositors den Builder mit einem Ausgabepfad aus, der bereits nicht existiert. Er speichert die bearbeitbare Blender-Datei, ein selbstständiges USDZ, ein Vorschaubild und sechs sitzende Überprüfungsmaterialien.
  2. Überprüfen Sie jedes Bild in review/. Korrigieren Sie die Quelle, wenn Skalierung, Sitzrichtung, Freigabe oder die Nutzbarkeit des Tisches falsch sind.
  3. Führen Sie den öffentlichen Packer und Validator aus, importieren Sie dann den genauen ZIP über Orte → Importieren → Einen Raum importieren → Dateien.
  4. Auswählen Minimales Lesezimmer In Places kombinieren Sie es mit einem Ansichtsbild und betreten Sie den virtuellen Raum. Probieren Sie den Lesetischsitz, die Raumlicht-Tile in Schnellsteuerung und Licht & Bild → Zimmer. Die Ausrichtung und der Komfort am Tisch erfordern Apple Vision Pro.
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.zip

Verwenden Sie den absoluten Pfad Ihrer Blender-Ausführbare Datei, wenn blender Ist nicht auf PATH. Der Bauherr und der Packer weigern sich, die vorhandenen Ausgaben zu überschreiben. Bewahren Sie den bearbeitbaren Quellcode bei und überprüfen Sie die Bilder außerhalb des fünfseitigen ZIP-Dateisystems. Die Komplette Laufzeitinteraktionsreferenz Erklärt, wie Sitzplätze, Sicherheit, Kollisionsbuchhaltung, gemessene Qualität, Schreibtischkartierung und Autorberechtigungen mit der App verbunden sind.

Verpacken, validieren und dann den Kompatibilitäts-ZIP importieren

Verwenden Sie für einen vollständigen Package-v2-Raum die Anleitung und Werkzeuge für vollständige Pakete. Legen Sie die fünf Quelldateien in einem Ordner ab und verwenden Sie unter macOS die weiterhin verfügbaren Werkzeuge für das flache Format:

python3 tools/pack_locus_asset.py /absolute/path/to/room /absolute/path/to/my-room.zip
python3 tools/validate_locus_asset.py /absolute/path/to/my-room.zip
  1. Lösen Sie jede Warnung oder jeden Fehler vom USDZ-Exporter und öffentlichen Validator.
  2. Wählen Sie in Locus Raum importieren und wählen Sie den exakten validierten ZIP aus.
  3. Paaren Sie das Zimmer mit einem Blick und geben Sie es mit Apple Vision Pro ein.
  4. Probieren Sie jeden Sitzplatz, die optionale Tischzuordnung, die Renderungsrolle und die Lichtsteuerung aus, die Sie angegeben haben.
  5. Korrigieren Sie die Quelle und erstellen Sie den ZIP neu; Patchen Sie das endgültige Archiv nicht manuell.

Mit einem KI-Assistenten bauen

Beginnen Sie mit einem Konzeptbild von ChatGPT, einem anderen Bildmodell oder Ihrer eigenen Referenz. Bitten Sie einen Agenten um einen Grundriss und eine Sitzplatzanordnung; lassen Sie ihn dann nach Bild und Plan modellieren, jeden Sitzplatz prüfen und das genaue Package v2-Archiv mit den öffentlichen Tools validieren. Importieren Sie es auf Apple Vision Pro und senden Sie dem Agenten konkretes Feedback zur Weiterentwicklung. Das Room-Tutorial in vier Schritten führt durch diesen Workflow, ohne Zugriff auf den Locus-Anwendungsquellcode oder einen Simulator zu benötigen.

Verwenden Sie einen Mac mit Blender und Xcode oder dessen Command Line Tools. Der Agent leitet Sitzplätze aus dem exportierten Modell ab und bewahrt stabile IDs für Revisionen. Jedes Bildmodell ist optional; kein API-Schlüssel ist erforderlich. Sie können weiterhin einen anderen professionellen 3D-Workflow verwenden, wenn Sie das bevorzugen.

Es ist kein Blender-Fenster oder eine MCP-Einrichtung erforderlich.

Der Agent speichert reproduzierbare Skripte und Renderings, prüft die Bilder und überarbeitet den Room. Er muss check_room.py mit einem ausdrücklich angegebenen Render-Verzeichnis ausführen, das Kontaktblatt prüfen und die SHA-256 des Archivs sowie verbleibende Geräteprüfungen berichten.

Headless-Authoring umfasst weiterhin eine visuelle Prüfung. Gespeicherte Renderings helfen dem Agenten, Modellierungs- und Materialprobleme zu finden, doch die abschließende Apple-Vision-Pro-Vorschau bestätigt, wie der Room in Locus aussieht und sich anfühlt. Importieren Sie das exakt geprüfte Archiv, verwenden Sie Vorschau in 3D, koppeln Sie es mit einer View und testen Sie dann jeden Sitz, jeden Lichtregler und Hide Desk. Kann der Agent kein geeignetes 3D-Werkzeug bedienen oder Bilder prüfen, muss er erklären, welche Arbeit unvollständig bleibt.