Autorleitfaden
Erstellen Sie eine benutzerdefinierte Ansicht oder einen Raum.
Beginne mit einem Ansicht-Bild, folge dem KI-Raum-Leitfaden oder nutze Package v2, wenn du eine wiederverwendbare, funktionsvollständige Auslieferung brauchst.
Package v2 empfohlenWählen Sie einen geführten Weg
Unterstützte Importe
| Aktion | Eingabe | Quelle |
|---|---|---|
| Eine Ansicht importieren | Ein vollständiges 2:1 equirektanguläres JPEG-, PNG- oder HEIC-Bild; ein vollständiges Package v2 ZIP mit einer Ansicht; oder ein Legacy/einfaches flaches Ansicht ZIP | Fotos für Bilder; Dateien oder ein direkter öffentlicher HTTPS URL für Bilder und ZIPs |
| Raum importieren | Ein vollständiges Package v2 ZIP mit einem Zimmer; oder ein Legacy/simple Flat-Zimmer ZIP | Dateien oder ein direkter öffentlicher HTTPS URL |
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.
Ein importiertes Paket entfernen
Öffne das Menü eines Imports und wähle Import entfernen. Das Entfernen eines Imports entfernt immer das gesamte Paket. Wenn ein Paket mehr als einen Raum oder eine Ansicht enthält, führt die Bestätigung sie auf.
Wenn ein anderes installiertes Paket von diesem Paket abhängt, lässt Locus beide Pakete unverändert. Entferne zuerst das abhängige Paket. Andernfalls entfernt Locus seine installierten Paketdateien und gespeicherten Paketinhalte; dein ursprüngliches ZIP oder Bild in Dateien oder im Cloud-Speicher bleibt unverändert. Ein erneuter Import des ursprünglichen Pakets erstellt oder aktualisiert es unter seiner stabilen Identität und zählt seine Ansichten und Räume auf dein aktuelles Importkontingent an.
Paketiere Ansichten und Räume getrennt, wenn sie unabhängige Lebenszyklen benötigen. Kombinierte Package-v2-Archive bleiben unterstützt, aber Remove Import entfernt jede Ansicht und jeden Raum, die das kombinierte Archiv zusammen enthält.
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
Package v2 ist der aktuelle Auslieferungsweg. Diese früheren flachen Kompatibilitäts-ZIPs bleiben als Studienarchive mit Schreibtischsitzen und besuchergesteuerten Lichtern verfügbar.
Drei vollständige Räume ausprobieren (historische Archive)
Für das frühere Kompatibilitätslayout und die aktuellen Felder verwende die Formatreferenz, einschließlich Lounge-Sitze und Hide Desk und Sitzgruppen.
Frühere kompatible Downloads: 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.
Empfohlen: 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 # optionalHineinsetzen 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.
Um eine Ansicht und einen Raum zusammen zu teilen, nimm beide in ein vollständiges Paket auf. Füge ein experience.json wenn du die Öffnung, Ausrichtung, Belichtung, den Titel oder den unterstützten Modus dieses Paars erstellen möchtest. Das Erlebnis verweist per stabiler ID auf Ansicht und Raum; ohne es leitet Locus seine Standardpaarungen ab. Importiere die kombinierte Datei einmal über Places → Import → Eine Ansicht importieren oder Raum importieren, mit Dateien oder einer direkten öffentlichen HTTPS-URL. Der Einstiegspunkt muss zum Inhalt des Pakets passen; die kombinierten Inhalte werden zusammen installiert. Siehe die Leitfaden und Beispiel für vollständige Pakete für die Manifeste und Packbefehle.
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.jsonIn 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.jsonDas Panorama muss ein vollständiges äquirektangulares 2:1-Bild sein. Eine paketierte Ansicht kann 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, Ambient Light, Sonnenlicht hinzufügen, Sonnenposition, Sonneinstrahlungskraftund Die Ansicht drehen. Die Einstellungen werden für diese Ansicht gespeichert.
Anzeigefeld anzeigen
| Feld | Verwenden Sie |
|---|---|
panorama.initialYawDegrees | Startrichtung. |
environment.skyGainEV | Helligkeit der sichtbaren Ansicht. |
environment.exposureEV | Raumbeleuchtungsintensität. |
environment.horizonPitchDegrees | Horizontanpassung. |
environment.colorGrade.contrast | Kontrast von 0.5 Zu 2.0; 1.0 ist neutral. |
environment.colorGrade.saturation | Sättigung von 0 Zu 2.0; 1.0 ist neutral. |
environment.directSun | Optional Sonnenrichtung und Stärke. |
environment.condition | Sehen Sie sich die v2-Empfehlung für den Raumlichtschalter an: Tag, Dämmerung, Nacht oder bewölkt. |
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
Verwenden Sie für ein vollständiges Package-v2-Archiv die Anleitung für vollständige Pakete und seine pack_locusplace.py / validate_locusplace.py . Die folgenden Befehle gelten weiterhin ausschließlich für das ältere/einfache flache Format. Legen Sie die fünf Raumdateien oder vier erforderlichen Ansichtsdateien in einem Ordner ab und führen Sie die enthaltenen Werkzeuge unter 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.zipDer 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.