基礎到高級 · 30分鐘以上
創造你自己的房間。
一個房間是一個獨立的3D空間，至少有一個可以坐的地方。在您喜歡的3D工具中構建和審查它，然後使用四個小型輔助檔案將完成的USDZ連接到Locus。
基本的
建造最小的工作室
公共最小化房間構建器從一個空曠的Blender場景開始。它建立了一個書桌、一個調校好的座位、兩堵牆、一個屋頂、一個可控制的吊燈、一個縮略圖和坐著的評論圖像。
你需要： macOS、Blender 5.2、Python 3，以及公共的本地副本 Locus支援儲存庫。建築師在後台運行Blender；不需要Blender MCP連接。
- 運行最小的房間構建器。 選擇一個新的輸出檔案夾。構建器拒絕覆蓋現有檔案夾。
- 逐張檢查 review/ 中的圖像。 檢查實際座椅的高度、眼睛位置、間隙、方向、材料和光線。
- 打包並驗證房間。 目前的公開工具建立一個舊版／簡易平面結構兼容 ZIP，並檢查其檔案、元資料、模型和限制。
- 匯入確切的ZIP。 在Locus中，選擇 空間 → 匯入 → 匯入一個房間 → 檔案.
- 嘗試Apple Vision Pro上的座位。 將“帶景房間”與房間配對，進入虛擬空間，坐在閱讀台，並在快捷控制中測試房間燈光。
blender --background --factory-startup --python-exit-code 1 \
--python tools/build_minimal_room.py -- \
--output /absolute/path/to/minimal-reading-room
python3 tools/pack_locus_asset.py \
/absolute/path/to/minimal-reading-room/room \
/absolute/path/to/minimal-reading-room.zip
python3 tools/validate_locus_asset.py \
/absolute/path/to/minimal-reading-room.zip如果使用絕對路徑到Blender， blender Terminal中沒有可用命令。
兼容性合同
理解五個檔案
my-room.zip
├── space.json
├── provenance.json
├── teleport-points.json
├── scene.usdz
└── thumbnail.jpg- scene.usdz 包含自contained、米級、+Y-up房間。
- space.json 命名房間並連接可選的開口、表面、燈光、渲染角色和動畫。
- teleport-points.json 為Locus提供至少一個可用的眼睛位置和面部方向。
- provenance.json 記錄建立者、權利、請求的署名、更改和AI使用均真實。
- thumbnail.jpg 顯示“空間中的房間”。Locus不會為您建立它。
這是舊版／簡易格式的兼容佈局。 將所有五個檔案放在其根目錄下。不要包含父檔案夾、Blender檔案、源紋理、GLB、緩存或審查圖像。每個匯入都會收到一個新的UUID。
Locus 1.2.1 及更高版本的標準交付方式： 當您需要穩定的ID、本地更新、聲音、動畫、影片表面、座位組、來源或捆綁式體驗時，請使用完整的Package v2。它的ZIP根直接包含
locusplace.json 和 catalog/。看 完整包 v2 教程.先進的
將你的建築轉化為生產室
- 設計以使用為中心。 為每個正式座位提供可用的桌子或台面表面、舒適的間隙和有意的視野。
- 以米為單位工作，並向上出口+Y。 Locus使用world-Z作為前綴。保持每個元資料參考的實體名稱穩定且唯一。
- 宣佈開放時間和座位。 幾何模型中的視窗和開口；元資料描述了完成的房間如何連接到所選的景觀。
- 只添加房間需要的控制。 可選元資料可以映射平板電腦、訪客控制的燈光、柔和的景觀反射、UI淡出權限和實驗性環境動畫。
- 修復源中的問題。 在可編輯的資產中正確設定幾何形狀、UVs、材料、紋理、比例和光照方向，然後再次導出。
- 驗證並測試每個聲明的座位。 有效的 ZIP 仍然可能會感覺太大、擁擠、被阻塞或不舒服。最終放置和舒適度檢查需要 Apple Vision Pro。