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 View-Medien und -Masken (einschließlich gepaarter media.dayNight -Karten), sourceImage, Sichtbare USDZ im Besitz midground Mittelgrund-Szenerie (mit Himmelsankern, Windbewegung, Texturfluss und Fließwasser), berechnete shore Brandung und Renderer-Wasser, Tag/Nacht- sunPath -Zyklen und gekoppelte panoramaBlend Panoramen, View- und Room-Sound, Room-Animationen, Videoflächen, beleuchtete Oberflächen, Partikeleffekte, gebackene Lichtebenen, Sitzgruppen, View-Boden-Grundrisspolygone, Room-Texturfluss und -Fließwasser, Herkunftsangaben sowie unterstützte Experiences. Locus prüft sichere Pfade, Dateiinventar, Hashes, Ressourcenlimits, erforderliche Fähigkeiten und Mindest-App-Version. Ein fehlerhaftes Archiv mit locusplace.json Wird abgelehnt und geht nie zurück zum Flachkompatibilitätsimporteur.

Fernseher im Raum erfordern Locus 1.4.9 oder neuer: Ein Raum kann bis zu vier flache Bildschirme in seinem Modell zu Fernsehern machen. TV-Anleitung lesen oder die Regeln für Room-Fernseher.

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 Werkzeuge

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.

Historische flache Raumbeispiele

Diese flachen Kompatibilitäts-ZIPs sind Studienarchive, keine Matrix aktueller Funktionen. Verwende Package v2 und die Feldreferenz für neue Arbeit.

Öffne die historischen Downloads und Kompatibilitätshinweise

Frühere kompatible Downloads: 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.

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.