Erstellen Sie eine benutzerdefinierte Ansicht oder einen Raum.

Wählen Sie einen geführten Weg

Unterstützte Importe

Der Import von Complete Package v2 ist in Locus 1.2.1 und neuer verfügbar. Das 4K-Minimum für direkt importierte Panoramabilder, einschließlich Browserbilder, ist unabhängig vom Format ZIP. Complete-Pakete bewahren stabile IDs und aktualisieren die Semantik. Flache Kompatibilitäts-ZIPs und direkte Panoramabilder erhalten bei jedem Import ein neues UUID.

Probieren Sie drei vollständige Zimmer aus

Mit einem Locus-Build, der Room v5 unterstützt, laden Sie jeden ZIP herunter, speichern Sie ihn in den Dateien und wählen Sie dann Raum importieren. Zu diesen öffentlichen Beispielen gehören Schreibtischstühle und besuchergesteuerte Lichter. Sie entsprechen der am 5. September 2026 veröffentlichten Exportversion (Atrium Loft 1.0.14, Courtyard Gallery 1.0.16, Horizon Atelier 1.0.18).

Verwenden Sie einen älteren Build? Laden Sie eine vorherige kompatible Version herunter: Atrium Loft, Hofgalerie, Horizon Atelier.

Verwenden Sie diese Beispiele mit Locus unter dem Locus Vermögensrechte.

Versuchen Sie experimentelle Raumanimationen

Der Cloud Fan Pavilion ist ein kostenloser Raum, den Sie in Locus Places herunterladen können, in dem eine breitblättrige Pflanze kontinuierlich im Wind bewegt wird. Die Animationsmetadaten, Wiedergabe, Schnellsteuerung und Bewegungs-Einstellungen, Geschwindigkeit und Wiedergabeintervalle sind experimentell und können sich ändern.

Bringen Sie Ihr eigenes Zimmer mit

Verwenden Sie den Modellierungs-, Material- und Beleuchtungsworkflow, den Sie bereits kennen. Locus benötigt nur einen selbstständigen USDZ und explizite Metadaten für Öffnungen, Sitze, optionale Tischmappings und Wand- oder Dach-Entitätsreferenzen, optionale besuchergesteuerte Lichter, optionale Loungesitze und verdeckbare Schreibtischgruppen (Locus 1.1.5), optionale Sitzgruppen (Locus 1.2.0) und - wenn Sie sich entscheiden, zu experimentieren - Raumanimationen.

Kanonisches vollständiges Package v2

complete-place.zip
├── locusplace.json
└── catalog/
    ├── destinations/<destination-id>/destination.json
    ├── spaces/<space-id>/space.json
    └── experiences/<experience-id>/experience.json   # optional

Hineinsetzen locusplace.json Und catalog/ direkt am ZIP-Wurzelort – niemals innerhalb eines äußeren Wrapper-Ordners. Inhaltselemente bleiben unter ihrem übereinstimmenden Ziel-, Speicher- oder Erlebnisordner. Locus akzeptiert dieselben ZIP-Bytes mit einem .zip Oder .locusplace Dateiname.

Dieses Format bewahrt von Autoren erstellte stabile IDs, Medienansichten und Masken, sourceImage, Sichtbare USDZ im Besitz midground Landschaften und vom Renderer betriebene Wasserflächen, Sicht- und Raumklänge, Raumanimationen, Videoflächen und Sitzgruppen, Herkunft und unterstützte gebündelte Erlebnisse. Sein Manifest erklärt packageID, contentVersion, minimumAppVersion, Inhalt-IDs, Dateihässchlüssel und -größen und contentHash. Locus validiert das genaue Inventar, sichere Pfade, Hashes, Ressourcenlimits, Fähigkeiten und die Mindest-App-Version. Ein fehlerhaftes vollständiges Paket wird abgelehnt, anstatt als flaches ZIP erneut versucht zu werden.

Legacy/einfacher Raum ZIP Layout

my-room.zip
├── space.json
├── provenance.json
├── teleport-points.json
├── scene.usdz
├── thumbnail.jpg
├── sound.json         # optional, Locus 1.1.4
└── forest-air.m4a     # one or more, only with sound.json

In diesem Kompatibilitätsformat sind alle fünf Dateien am ZIP-Root erforderlich. space.json Enthält displayName; es enthält keine Asset-ID, und jeder Import erhält einen neuen UUID. Fügen Sie kein übergeordnetes Verzeichnis, eine bearbeitbare Quelle, GLB, Quelltexturen oder eine andere Datei hinzu. Locus generiert keinen Vorschaubild, wenn eines fehlt. Ein Raum kann auch seinen eigenen Sound enthalten: hinzufügen sound.json und seine Audiodateien am Stamm, beschrieben in der Formatreferenz. Jede Audiodatei muss von einer Quelle in benannt werden sound.json, und Audio ohne sie wird abgelehnt.

Legacy/einfache Ansicht ZIP Layout

my-view.zip
├── view.json
├── provenance.json
├── panorama.jpg
├── thumbnail.jpg
├── lighting.jpg       # optional
├── sound.json         # optional, Locus 1.1.4
└── waterfall.m4a      # one or more, only with sound.json

Das Panorama muss ein vollständiges 2:1-äquirektanguläres Bild sein. Eine verpackte Ansicht kann die Startrichtung, Helligkeit, Kontrast, Sättigung, Raumbeleuchtung, Horizonthöhe und optionales Sonnenlicht in view.json. Ein Benutzer kann diese später mit ändern Ansicht bearbeiten. Eine Ansicht kann auch ihren eigenen Klang auf denselben Begriffen wie ein Raum tragen, der in der beschrieben wird Formatreferenz.

Ansicht in Locus anpassen

Ansicht bearbeiten Bietet Ansichtshelligkeit, Kontrast, Farbe, Raumbeleuchtung, Sonnenlicht hinzufügen, Sonnenposition, Sonneinstrahlungskraft, und Die Ansicht drehen. Die Einstellungen werden für diese Ansicht gespeichert.

Anzeigefeld anzeigen

Herkunft

Jedes Zimmer und jeder Blick braucht provenance.json. Führen Sie den Urheber oder die Agentur, Rechte, angeforderte Nennung, Änderungen und die KI-Nutzung wahrheitsgemäß auf. Geben Sie genau einen der folgenden Angaben an license Oder rights, wie in der Formatreferenz beschrieben. Wenn aiGenerated Ist true, einschließen aiProvider; wenn falsch, lassen Sie es weg. Die Lizenz beschreibt Rechte an dem Vermögenswert; eine App Store EULA ist keine Vermögenswertlizenz. Siehe Locus Vermögensrechte für von Locus verfasste Beispiele.

Legen Sie ein Kompatibilitäts-ZIP zusammen und validieren Sie es

Die aktuellen öffentlichen Python-Tools erstellen und validieren nur das Legacy-/einfache Flachformat; sie validieren kein vollständiges Package v2. Halten Sie die fünf Room-Dateien oder die vier erforderlichen View-Dateien in einem Verzeichnis zusammen. Führen Sie die enthaltenen Tools auf macOS aus:

python3 tools/pack_locus_asset.py /absolute/path/to/asset /absolute/path/to/asset.zip
python3 tools/validate_locus_asset.py /absolute/path/to/asset.zip

Der Raum-Validator verwendet Xcode's usdchecker. Ein gültiges Ergebnis überprüft das Archiv und maschinenlesbare Assets; es ersetzt nicht das Importieren des genauen ZIP und das Ausprobieren jedes Sitzes.