技術參考
Locus 軟體包v2、房間和景觀 ZIP 格式
完整 Package v2 是具備完整功能的規範匯入格式,只包含資料。為兼容舊內容,仍支援舊版/簡易平面結構的房間和景觀 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 電視規則。
參考與工具
舊版/簡易房間檔案
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 # optionalview.json 可以設定方向、可見亮度、房間照明強度、地平線高度、對比度、飽和度以及可選的陽光。全景是一張完整的2:1等角矩形圖像。
歷史扁平 Room 示例
這些扁平兼容 ZIP 是歷史學習示例,並不代表當前功能範圍。請使用 Package v2,以及 字段參考 來製作新內容。
實驗室動畫樣品
Cloud Fan Pavilion 是可以在 Locus 空間 下載的免費房間,展示實驗動畫元資料和播放。其連續的 Plant Breeze、動畫切換、速度控制和重播間隔行為可能會發生變化。
房間集成指南
那個 房間集成指南 解釋USDZ、實體、座位、桌子、安全、材料、可選照明和實驗動畫合同,但不規定建模工作流程。在分享之前匯入並輸入精確結果。
來源和許可
發佈這些文檔、示例技能和驗證工具不會發佈私有的 Locus 應用源代碼,也不會更改應用的許可證。由 Locus 編寫的示例資產使用所描述的條款。 資產權利頁面.