碰撞
默认高斯泼溅没有物理体积,相机可穿过。Studio 的 Collision 将场景体素表示附加到作品,供查看器碰撞,使其可行走,而非只能环绕或飞行。探索也可通过 walkable 筛选。
将泼溅缩放到真实世界单位
添加前将比例调整为 1 单位 = 1 米。行走固定头高 1.8 米,比例错误会让空间过大或过小。
什么是体素碰撞?
它是低分辨率盒状场景重建,表示可站立、接触或阻挡的表面。与视觉数据分离,可独立按物理性能优化。

通常每场景生成一次,仅底层数据显著变化时重建。
生成碰撞
推荐在 Studio 直接生成。Assets 的 Collision 有 Generate,服务器对已发布数据体素化,无需准备上传文件。

- 通过管理页 Open in Studio 或场景页 Edit in Studio 打开 Studio。点缩略图只会观看。进入 Assets → Collision。
- 点击 Generate。
- 选 Scene type:Indoor、默认 Outdoor 或 Object,按空间类型调整。
- 设置 Seed position XYZ,体素器从这里向外洪水填充可导航空间,应位于访客可站立处。默认当前视口相机位置,可先构图或手输。
- 点击 Generate。
服务器通常处理几分钟,显示“Generation in progress. Reload to refresh status.”。Studio 不轮询,需刷新获取结果。完成后出现 scene.voxel.json 与 scene.voxel.bin,下次重载查看器即可行走。失败显示“Generation failed.”。
已有碰撞时按钮为 Regenerate,Delete 移除当前体素资源。
体素尺寸
默认体素 5 厘米,适合多数场景。需要其他尺寸时,用 splat-transform 生成再上传,见自定义碰撞。
上传自定义碰撞
生成结果不符合要求,或自行制作调整时,可上传自定义文件。可用浏览器 Convert,或支持脚本批处理的 CLI。
- Assets → Collision → Upload,打开 Upload Voxel Collision Pair。
- 拖入或选择 .voxel.json 与对应 .voxel.bin,可一起或分两次。
- 点击 Upload Voxel Pair;已有时为 Upload Override,替换原数据。
立即上传,下次查看器重载后可行走。