作者指南
建立自定義的景觀或房間。
可以從一張景觀圖片開始,按照 AI 房間教程建造房間,或使用 Package v2 來製作可復用、功能完整的內容包。
推薦使用 Package 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。
移除已匯入的包
開啟已匯入內容的菜單,然後選擇 移除匯入。移除匯入項會移除整個包。如果包內有多個房間或景觀,確認窗口會列出它們。
如果其他已安裝的包依賴此包,Locus 會保留這兩個包。請先移除依賴它的包。否則,Locus 會移除已安裝的包檔案及其保存的內容;“檔案”或雲端儲存中的原始 ZIP 或圖片不受影響。重新匯入原始包時,會按其固定標識創建或更新內容,其中的景觀和房間會計入當前匯入額度。
景觀和房間需要獨立管理時,請分別打包。仍支援同時包含兩者的 Package v2 包,但“移除匯入”會一起移除該包中的所有景觀和房間。
下載範例
免費 Room 和部分免費 View 可作為範例下載研究,其中一些附有 Blender 原始檔。 在藝廊中瀏覽範例。
程式設計代理可以讀取 place-examples.json 以取得每個下載的 URL、大小、SHA-256、功能和授權。
房間歷史示例包
當前請使用 Package v2 交付。以下早期的扁平兼容 ZIP 保留為學習用歷史示例,其中包含書桌座位和可由使用者控制的燈光。
使用以下例子,在Locus下 Locus資產權利.
嘗試實驗性房間動畫
雲扇亭是Locus 空間中可以下載的免費房間,裡面有寬葉植物在微風中不斷移動。動畫元資料、播放、快捷控制和運動設定、速度和重播間隔為實驗性,可能會發生變化。
帶自己的房間
使用您已經知道的模型、材料和照明工作流程。Locus只需要一個獨立的USDZ以及開口、座位、可選的桌面映射和牆壁或屋頂實體參考、可選的訪客控制燈、可選的休息椅和隱藏的辦公桌組(Locus 1.1.5)、可選的座位組(Locus 1.2.0),以及——當您選擇進行實驗時——房間動畫。
推薦:完整 Package 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 檔案名。
要一起分享景觀和房間,請將兩者放入一個完整內容包。添加一個 experience.json ,以設定該組合的開口、方向、曝光、標題或支援的模式。體驗通過固定 ID 引用景觀和房間;如果沒有體驗,Locus 會自動生成預設組合。通過以下入口一次性匯入合併的檔案: 空間 → 匯入 → 匯入景觀 或 匯入房間,通過“檔案”或直接的公共 HTTPS URL 匯入。入口必須與包內的內容類型相符;合併包中的內容會一起安裝。請參閱 完整內容包指南與示例 ,查看清單檔案和打包命令。
此格式保留了作者的穩定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
對於完整的 Package v2 歸檔,請使用 完整包指南 及其 pack_locusplace.py / validate_locusplace.py 工具。下方命令僅適用於舊版簡易扁平格式。將五個 Room 文件或四個必填 View 文件放在同一目錄。在 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並嘗試每個座位。