Locus

技術參考

Locus 軟體包v2、房間和景觀 ZIP 格式

完整 Package v2 是具備完整功能的規範匯入格式，只包含資料。為兼容舊內容，仍支援舊版／簡易平面結構的房間和景觀 ZIP。

Locus 1.2.1及更高版本。 通過景觀或房間入口點從檔案中或直接通過公共 HTTPS URL 匯入完整的 Package v2。Locus 接受相同的 ZIP 字節，並帶有 .zip 或者 .locusplace 檔案名。

完整套餐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的根目錄下，沒有外包裝檔案夾。嵌套的 catalog/destinations/, catalog/spaces/，並且可選 catalog/experiences/ 需要路徑結構。景觀匯入必須包含請求的景觀；房間匯入必須包含請求的房間。支援的體驗可能與該內容捆綁在一起。

信封保留穩定的內容ID並聲明 packageID, contentVersion, minimumAppVersion，內容庫存，每個檔案的字節數和SHA-256，以及 contentHash。重復匯入不變的內容是等效的；同一軟體包ID下的更改的內容需要更新的內容版本和相同的聲明的內容ID。

支援完整軟體包，保留查看媒體和遮罩， sourceImage，查看所有者USDZ midground 場景和渲染器擁有的水（包括隨風搖曳的道具和淺水衝浪），景觀和房間聲音，房間動畫，影片表面，照明表面，粒子效果，預處理光層，座位組，來源以及支援的體驗。Locus 驗證安全路徑、精確的檔案庫存、哈希值、資源限制、所需能力和最低應用程序版本。一個包含不完整的存檔 locusplace.json 被拒絕，並且永遠不會回到平坦兼容的進口商。

一份純資料合同。 在同一個 Locus 應用版本中，受支援的房間和景觀資料具有相同的渲染含義，無論它是內置內容、從資源庫下載，還是從完整的公開 ZIP 安裝。包可以包含特定類型的媒體和 USD/USDZ 資產，但絕不能包含腳本、插件、動態庫或可執行擴展。未來的內容能力會加入這一共同契約，而非使用單獨的公開匯入白名單。 閱讀邊界和延伸規則。

參考和兼容性工具

完整和兼容格式參考Package v2 的結構、身份與更新、舊版／簡易格式佈局、JSON 字段、限制和檢查。平坦兼容性驗證器檢查舊版／簡易房間或景觀 ZIP；不驗證完整 Package v2。平裝兼容包裝器建立可復現的舊版／簡易 ZIP，並進行驗證。來源模式創作者、權利、署名、變更和AI披露。

舊版／簡易房間檔案

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

此平坦兼容格式每次匯入時都會接收一個新的 UUID。每個檔案都必須包含。一個房間必須至少包含一個可用的入口座位。縮略圖由作者提供；Locus 在匯入時不會捕捉一個。

舊版／簡易景觀檔案

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

view.json 可以設定方向、可見亮度、房間照明強度、地平線高度、對比度、飽和度以及可選的陽光。全景是一張完整的2:1等角矩形圖像。

完整的房間示例

所有三個下載均使用 房間 v5，並明確設定了渲染角色和光斑方向。更新於 2026 年 9 月 5 日。

需要 房間 v5 支援。 早期 Locus 1.1.0 構建（1–3）不支援這些 ZIP。自 Locus 1.1.0 構建 4 起支援房間 v5，包括 Locus 1.1.1。請在「設定 → 幫助與關於 → 關於 Locus」中查看構建版本。
不是應用程序中的1.1.5或1.2.0房間。 App Store 內置內容及資源庫中針對 Locus 1.1.5 的修訂增加了沙發和休閒座位，以及可隱藏的桌面組；Locus 1.2.0 又加入了作者定義的座位組，將相關座位在座位選擇器中分組。這些可下載的 ZIP 仍採用9 月 5 日的桌面座位包，方便創作者研究基礎的房間 v5 契約；不包含休閒座位、隱藏桌面或座位組。如需瞭解休閒座位和隱藏桌面，請參閱 格式參考；對於座位組，請參見 座位組參考.
大廳頂層2個辦公椅·10.1 MB。庭院畫廊3個辦公桌座位·10.7 MB。Horizon工作室3個辦公椅·12.9 MB。

使用較舊的版本？下載之前的兼容版本： 大廳頂層, 庭院畫廊, Horizon工作室.

實驗室動畫樣品

Cloud Fan Pavilion 是可以在 Locus 空間 下載的免費房間，展示實驗動畫元資料和播放。其連續的 Plant Breeze、動畫切換、速度控制和重播間隔行為可能會發生變化。

嘗試雲風會堂說明、權利聲明和22.2 MB的下載。
在Locus中免費找到它打開“開放空間”，選擇“房間”，下載“雲風扇會堂”。

房間集成指南

那個 房間集成指南 解釋USDZ、實體、座位、桌子、安全、材料、可選照明和實驗動畫合同，但不規定建模工作流程。在分享之前匯入並輸入精確結果。

來源和許可

發佈這些文檔、示例技能和驗證工具不會發佈私有的 Locus 應用源代碼，也不會更改應用的許可證。由 Locus 編寫的示例資產使用所描述的條款。 資產權利頁面.