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。

受支援的完整壓縮檔可保留 View 媒體與遮罩(包括配對的 media.dayNight 貼圖), sourceImage,查看所有者USDZ midground 中景(含天空錨點、風擺、紋理流動與流水)、即時計算 shore 海岸碎浪與引擎水體、日夜 sunPath 循環與配對的 panoramaBlend 全景、View 與 Room 音訊、Room 動畫、影片表面、受光表面、粒子效果、烘焙光照層、座位分組、View 地面輪廓多邊形、Room 紋理流動與流水、版權聲明及受支援的 Experience。Locus 會校驗安全路徑、精確檔案清單、雜湊、資源上限、所需能力與最低 App 版本。包含以下檔案的畸形壓縮檔會被拒絕,而不會退回到扁平相容匯入器: locusplace.json 被拒絕,並且永遠不會回到平坦兼容的進口商。

房間電視需要 Locus 1.4.9 或更新版本:一個房間可以把模型中最多四個平面螢幕變成電視。 閱讀電視教學 或 閱讀 Room 電視規則。

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

參考與工具

舊版/簡易房間檔案

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等角矩形圖像。

歷史扁平 Room 示例

這些扁平兼容 ZIP 是歷史學習示例,並不代表當前功能範圍。請使用 Package v2,以及 字段參考 來製作新內容。

展開歷史下載與兼容性說明

更早的兼容版本下載: 大廳頂層, 庭院畫廊, Horizon工作室.

實驗室動畫樣品

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

房間集成指南

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

來源和許可

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