作者指南
建立自定義的景觀或房間。
使用完整 Package v2 交付完整功能和穩定更新，使用舊版／簡易平面結構 ZIP 保持兼容，或直接將完整全景圖匯入為景觀。
房間v1-v5 · 查看v1-v2選擇一個引導路徑
支援的進口
| 行動 | 輸入 | 來源 |
|---|---|---|
| 匯入景觀 | 完整的 2:1 等距柱狀投影 JPEG、PNG 或 HEIC 圖像；包含景觀的完整 Package v2 ZIP；或舊版／簡易平面結構的景觀 ZIP | 圖片可從「照片」匯入；圖片和 ZIP 可從「檔案」或直接公開的 HTTPS URL 匯入 |
| 匯入房間 | 包含房間的完整 Package v2 ZIP；或舊版／簡易平面結構的房間 ZIP | 檔案或直接公共HTTPS URL |
Locus 1.2.1 及更高版本支援匯入完整 Package v2 包。直接匯入的全景圖片（包括瀏覽器中的圖片）最低須達到 4K，這一要求與兩種 ZIP 格式各自的規則無關。完整包保留穩定 ID 和更新語義；扁平兼容 ZIP 及直接匯入的全景圖片每次匯入都會獲得新的 UUID。
嘗試三個完整的房間
使用支援房間 v5的Locus版本，下載任何ZIP，將其保存到檔案，然後選擇 匯入房間。這些公共示例包括書桌座位和訪客控制的燈光。它們與2026年9月5日發佈的導出版本（Atrium Loft 1.0.14、Courtyard Gallery 1.0.16、Horizon Atelier 1.0.18）相匹配。
使用較舊的版本？下載之前的兼容版本： 大廳頂層, 庭院畫廊, Horizon工作室.
使用以下例子，在Locus下 Locus資產權利.
嘗試實驗性房間動畫
雲扇亭是Locus 空間中可以下載的免費房間，裡面有寬葉植物在微風中不斷移動。動畫元資料、播放、快捷控制和運動設定、速度和重播間隔為實驗性，可能會發生變化。
帶自己的房間
使用您已經知道的模型、材料和照明工作流程。Locus只需要一個獨立的USDZ以及開口、座位、可選的桌面映射和牆壁或屋頂實體參考、可選的訪客控制燈、可選的休息椅和隱藏的辦公桌組（Locus 1.1.5）、可選的座位組（Locus 1.2.0），以及——當您選擇進行實驗時——房間動畫。
標準完整軟體包v2
complete-place.zip
├── locusplace.json
└── catalog/
├── destinations/<destination-id>/destination.json
├── spaces/<space-id>/space.json
└── experiences/<experience-id>/experience.json # optional放在 locusplace.json 和 catalog/ 直接位於ZIP根目錄下——永遠不在外包裝檔案夾內。內容資產將保留在其匹配的目的地、空間或體驗目錄下。Locus接受相同的ZIP字節，並帶有 .zip 或者 .locusplace 檔案名。
此格式保留了作者的穩定ID，查看媒體和遮擋， sourceImage，查看所有者USDZ midground 場景和渲染器擁有的水、景觀和房間聲音、房間動畫、影片表面和座位組、來源以及支援的捆綁式體驗。其manifest聲明 packageID, contentVersion, minimumAppVersion，內容ID，檔案哈希值和大小，以及 contentHash。Locus驗證確切的庫存、安全路徑、哈希值、資源限制、能力和最低應用版本。不完整的完整軟體包將被拒絕，而不是作為扁平的ZIP重新嘗試。
舊版／簡易房間 ZIP 結構
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在這種兼容格式中，ZIP的根目錄下需要所有五個檔案。 space.json 包含 displayName；它不包含資產ID，每個匯入都會接收一個新的UUID。不要添加父檔案夾、可編輯的源檔案、GLB、源紋理或任何其他檔案。Locus在缺少一個時不會生成縮略圖。一個房間也可以攜帶自己的聲音：添加 sound.json 以及其在根目錄中的音頻檔案，在 格式參考。每個音頻檔案都必須由來源命名為 sound.json，沒有音頻則會被拒絕。
舊版／簡易景觀 ZIP 結構
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全景必須是一張完整的2:1等角矩形圖像。包裝景觀可以設定起始方向、亮度、對比度、飽和度、房間照明、地平線高度，以及可選的陽光在 view.json。使用者可以在稍後使用這些進行更改 編輯景觀。一個景觀也可以在與房間相同的條件下攜帶自己的聲音，在描述中 格式參考.
在Locus中調整景觀
編輯景觀 提供 景觀亮度, 對比度, 顏色, 房間照明, 添加陽光, 太陽位置, 陽光強度，以及 轉動景觀。設定已保存到那個景觀。
查看外觀字段
| 領域 | 使用 |
|---|---|
panorama.initialYawDegrees | 起始方向。 |
environment.skyGainEV | 可見景觀亮度。 |
environment.exposureEV | 房間照明強度。 |
environment.horizonPitchDegrees | 地平線調整。 |
environment.colorGrade.contrast | 對比來自 0.5 到 2.0; 1.0 是中立的。 |
environment.colorGrade.saturation | 飽和度來自 0 到 2.0; 1.0 是中立的。 |
environment.directSun | 可選的太陽方向和強度。 |
environment.condition | 景觀 v2 對「房間燈光」開關的建議值：白天、黃昏、夜晚或陰天。 |
來源
每個房間和景觀都需要 provenance.json。如實記錄創作者或機構、權利、請求的署名、變更和AI使用情況。提供以下其中一個 license 或者 rights，如格式參考中所述。當 aiGenerated 是 true，包括 aiProvider；如果為虛假，請省略。許可證描述了資產中的權利；App Store EULA不是資產許可證。參見 Locus資產權利 對於Locus編寫的示例。
打包並驗證兼容性 ZIP
目前的公開 Python 工具只構建和驗證舊版／簡易平面結構格式，不驗證完整 Package v2。將房間的五個檔案或景觀的四個必需檔案放在同一目錄中。在 macOS 上運行附帶工具：
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房間驗證器使用Xcode的 usdchecker。有效的結果檢查存檔和可機器讀取的資產；它不替代匯入確切的ZIP並嘗試每個座位。