基础到高级 · 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。