選擇一個引導路徑

支援的進口

行動輸入來源
匯入景觀完整的 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 保留為學習用歷史示例,其中包含書桌座位和可由使用者控制的燈光。

體驗三個完整房間(歷史示例包)

較早的兼容佈局和當前字段請參閱 格式參考,包括 休閒座位與“隱藏書桌” 和 座位分組.

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

使用以下例子,在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重新嘗試。

這個包裹是資料,而不是代碼。 在相同的 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並嘗試每個座位。