Technische Referenz
Locus Package v2, Zimmer und Ansicht ZIP Formate
Complete Package v2 ist das kanonische featurereiche, reinedatenbasierte Importformat. Legacy/einfache flache Room- und View-ZIPs werden aus Kompatibilitätsgründen weiterhin unterstützt.
.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 # optionalBehalten 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.
Referenz und Werkzeuge
Legacy/einfache Zimmerdateien
room.zip
├── space.json
├── provenance.json
├── teleport-points.json
├── scene.usdz
└── thumbnail.jpgDieses 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 # optionalview.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.