Raum und Ansicht ZIP Referenz

Locus 1.2.1 und später. Importieren Sie das vollständige Package v2 aus Dateien oder einen direkten öffentlichen HTTPS URL über den View- oder Raum-Eintrittspunkt. Locus akzeptiert dieselben ZIP-Bytes mit einem .zip Oder .locusplace Dateiname.

Komplettes Package v2

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

Behalten locusplace.json Und catalog/ Direkt am ZIP-Wurzelverzeichnis, ohne äußeres Umhüllungsordner. Die verschachtelten catalog/destinations/, catalog/spaces/, und optional catalog/experiences/ Pfade sind erforderlich. Eine View-Importierung muss eine angeforderte View enthalten; eine Room-Importierung muss einen angeforderten Raum enthalten. Unterstützte Erlebnisse können mit diesem Inhalt gebündelt werden.

Das Umschlagbewahrungsdokument bewahrt stabile InhaltseIDs und erklärt packageID, contentVersion, minimumAppVersion, das Inhaltsinventar, die Byte-Zählung jedes Datensatzes und SHA-256, und contentHash. Das erneute Importieren unveränderter Inhalte ist idempotent; veränderte Inhalte unter derselben Paket-ID benötigen eine neuere Inhaltsversion und dieselben deklarierten Inhalts-IDs.

Unterstützte vollständige Pakete bewahren Medien und Maskenansichten, sourceImage, Sichtbare USDZ im Besitz midground Landschaften und vom Renderer betriebenes Wasser (einschließlich windverwirbelter Requisiten und flachwasserbasiertem Surfen), Sicht- und Raumklänge, Raumanimationen, Videoflächen, beleuchtete Flächen, Teilcheneffekte, gebackene Lichtschichten, Sitzgruppen, Herkunft und unterstützte Erlebnisse. Locus verifiziert sichere Pfade, das genaue Dateiminventar, Hash-Codes, Ressourcenlimits, erforderliche Fähigkeiten und die Mindest-App-Version. Ein fehlerhaftes Archiv, das enthält locusplace.json Wird abgelehnt und geht nie zurück zum Flachkompatibilitätsimporteur.

Ein reiner Datenvertrag. In derselben Locus-Binärdatei haben unterstützte Raum- und Ansichtsdaten denselben Renderingsinn, unabhängig davon, ob sie gebündelt, aus der Bibliothek heruntergeladen oder von einem vollständigen öffentlichen ZIP installiert werden. Pakete können getippte Medien und USD/USDZ-Assets enthalten, aber niemals Skripte, Plugins, dynamische Bibliotheken oder ausführbare Erweiterungen. Zukünftige Inhaltsfunktionen werden stattdessen in diesen gemeinsamen Vertrag aufgenommen, anstatt einer separaten öffentlichen Importerlaubnisliste. Lesen Sie die Grenz- und Ausdehnungsregel.

Referenz- und Kompatibilitätswerkzeuge

Komplette und KompatibilitätsformatreferenzPackage-v2-Struktur, Identität und Updates, Legacy/einfache Layouts, JSON-Felder, Grenzen und Prüfungen.Flache KompatibilitätsvalidatorPrüft einen Legacy-/einfachen Raum oder Ansicht ZIP; es validiert das vollständige Package v2 nicht.FlachkompatibilitätspackerErstellt ein deterministisches Legacy/einfaches ZIP und validiert es.HerkunftsschemaUrheber, Rechte, Urheberrecht, Änderungen und KI-Offenlegung.

Legacy/einfache Zimmerdateien

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

Dieses Flat-Kompatibilitätsformat erhält bei jedem Import ein neues UUID. Jede Datei ist erforderlich. Ein Raum muss mindestens einen nutzbaren Eingangsplatz enthalten. Der Mini-Thumbnail wird vom Autor bereitgestellt; Locus erfasst keinen während des Imports.

Legacy-/Einfachansicht-Dateien

view.zip
├── view.json
├── provenance.json
├── panorama.jpg
├── thumbnail.jpg
└── lighting.jpg       # optional

view.json kann die Richtung, die sichtbare Helligkeit, die Raumbeleuchtungintensität, den Horizontwinkel, den Kontrast, die Sättigung und optionales Sonnenlicht einstellen. Das Panorama ist ein vollständiges 2:1-äquirektanguläres Bild.

Beispiele für vollständige Zimmer

Alle drei Downloads verwenden Room v5, mit expliziten Renderingsrollen und Lichtstrahlrichtungen. Aktualisiert am 5. September 2026.

Benötigt Raum v5-Unterstützung. Frühe Locus 1.1.0-Builds (1–3) unterstützen diese ZIPs nicht. Room v5 wird ab dem Locus 1.1.0-Build 4 unterstützt, einschließlich Locus 1.1.1. Überprüfen Sie Ihren Build in Einstellungen → Hilfe & Über → Über Locus.

Nicht die in der App enthaltenen 1.1.5- oder 1.2.0-Räume. Die im App Store integrierten Inhalte und Bibliotheksrevisionen für Locus 1.1.5 fügen Sofa- und Lounge-Sitzplätze sowie ausblendbare Schreibtischgruppen hinzu; Locus 1.2.0 gruppiert verwandte Sitzplätze im Sitzplätze-Auswahlmenü zusätzlich nach von Autor:innen definierten Sitzgruppen. Diese herunterladbaren ZIPs bleiben bei den Schreibtisch-Sitzplatzpaketen vom 5. September, damit Autor:innen den Basisvertrag für Room v5 ohne Lounge-Sitzplätze, Hide Desk oder Sitzgruppen studieren können. Informationen zu Lounge-Sitzplätzen und Hide Desk finden Sie in der Formatreferenz; für Sitzgruppen siehe die Referenz für Sitzgruppen.

Atrium Loft2 Schreibtischplätze · 10,1 MB.Hofgalerie3 Schreibtischplätze · 10,7 MB.Horizon Atelier3 Schreibtischplätze · 12,9 MB.

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

Beispiel für die Animation des Experimentierraums

Cloud Fan Pavilion ist ein kostenloser Raum, den Sie in Locus Places herunterladen können und der experimentelle Animationsmetadaten und Wiedergabe demonstriert. Sein kontinuierliches Plant Breeze, Animationswechsel, Geschwindigkeitskontrolle und Wiedergabeintervallverhalten können sich ändern.

Probieren Sie den Cloud Fan Pavilion ausAnweisungen, Rechtehinweise und die 22,2 MB Download.

Finden Sie es kostenlos in LocusÖffne Orte, wähle Räume und lade den Cloud Fan Pavilion herunter.

Raumintegrationsleitfaden

Die Raumintegrationsleitfaden Erklärt die USDZ-Verträge für Entität, Sitzplatz, Schreibtisch, Sicherheit, Material, optionale Beleuchtung und experimentelle Animation, ohne einen Modellierungsprozess vorzuschreiben. Importieren und geben Sie das genaue Ergebnis ein, bevor Sie es teilen.

Quelle und Lizenzierung

Die Veröffentlichung dieser Dokumentation, der Beispieldienste und der Validierungstools veröffentlicht nicht die private Locus-App-Quelle oder ändert die Lizenz der App. Die vom Locus erstellten Beispieldateien verwenden die auf den beschriebenen Begriffen. Seite zu Vermögensrechten.