← 返回

从录制到漫游的完整流程

一句话：手机负责录，Mac 负责训，链接负责看。训练这一步浏览器做不了（要 GPU），免费路线是用开源训练器在 Mac 本地跑。

📹手机录制
→
💻Brush 训练
→
🫧转 SOG+碰撞
→
🚶上线漫游
1

手机录制空间视频

用本站的录制页（Safari / Chrome 打开），绕空间慢走一圈，镜头从地面扫到天花板，30–60 秒即可。录完点「保存到手机」。

产出：一段视频（.mov / .webm）

2

传到 Mac，用 Brush 训练

AirDrop 把视频传到 Mac。装开源训练器 Brush（Apple Silicon 直接下 brush-app-aarch64-apple-darwin.tar.xz，Releases 页有现成包；没有再去源码构建，需 Rust 1.88+）。

打开 Brush → 导入视频 → 点训练（几分钟到几十分钟，看空间复杂度）→ 导出 .ply 文件。

产出：scene.ply（泼溅模型）

训练参数先用默认值跑通全流程，效果不满意再回头调。首次训练目标「能走进去不穿墙」，不是 perfection。
3

转换成网页格式 + 碰撞体

Mac 终端装一次官方转换工具，然后两条命令：

# 一次安装（已装可跳过）
npm install -g @playcanvas/splat-transform

# 网页交付格式：小、快、流式加载
splat-transform scene.ply scene.sog

# 碰撞体：步行走查不穿墙（.json + .bin 两个文件都要上线）
splat-transform scene.ply scene.voxel.json

不想装命令行也可以用网页版 superspl.at/convert 做同样的事。

产出：scene.sog · scene.voxel.json · scene.voxel.bin

4

上线到作品列表

把三个文件放进站点 assets/ 目录，再在 scenes.json 里加一条（照抄「公寓室内」那条改名字和文件名），重新部署就上线了——直接把这个项目文件夹丢给 AI 助手说「部署」即可。

// scenes.json 里新增一条：
{
  "id": "my-room",
  "title": "我的房间",
  "badge": "自制",
  "desc": "第一次自己录的空间",
  "size": "12.1 MB",
  "walk": true,
  "href": "viewer/?content=/assets/my-room.sog&collision=/assets/my-room.voxel.json&lang=zh-CN"
}
5

验收：手机打开走一圈

列表里点新作品 → 加载完点「步行」按钮 → 走查。卡顿就检查文件大小（建议 SOG 控制在 30 MB 内），穿墙就是碰撞体没配对。