Machine-readable: manifest · index · 简体中文 Markdown
使用普通相机视频建图
完成扫描数据配置后,01Spatial 会把普通相机视频转化为可用于定位、内容编辑和 AR 发布的空间地图。建图在云端运行,关闭页面不会中断任务。
建图过程中发生什么
系统会从视频中选择清晰、连续且覆盖充分的画面,生成统一的空间地图,并应用配置阶段确定的真实大小、原点和方向。之后,01Spatial 会检查空间是否连续、目标区域是否被覆盖,以及定位所需文件是否完整。
通过检查的结果会成为 Space Studio、定位 API 和 AR 客户端可直接使用的地图。输入或约束不足时,任务会明确失败并给出原因,不会发布一张看似完成却无法可靠定位的地图。
启动建图
如果使用 Map Configurator,请完成页面中的必填检查,然后选择 Build。
如果视频中拍到了合格的 01Spatial 空间基准板,并且解析报告确认观测质量通过,地图卡片会提供 Build with ChArUco。空间基准板自动建图与 Map Configurator 手工 GCP 配置二选一,不要混合提交两套坐标定义。
GCP 是 Ground Control Point(地面控制点) 的缩写,表示现场坐标已知、可在多个画面中准确确认的固定点。
理解地图状态
| 状态 | 含义 | 你需要做什么 |
|---|---|---|
| 排队中 | 等待可用建图资源 | 保持地图与源文件不变,稍后查看进度 |
| 建图中 | 正在生成地图和定位资产 | 不要重复启动;可以离开页面后再返回 |
| 已就绪 | 地图和定位资产已通过自动检查 | 在 Space Studio 中进行现场定位测试 |
| 失败 | 输入、覆盖、配置或输出未通过检查 | 阅读失败原因,修正后重新建图 |
就绪后验证定位
已就绪表示自动检查通过,不代表真实使用场景已经验收。发布前使用 Space Studio 执行定位测试,确认:
- 路线起点、中部和终点都能成功定位;
- 门口、转角和跨房间位置不会跳到错误区域;
- 用户正常持机高度和方向下能够定位;
- 预期照明条件下表现稳定;
- 测试内容的位置、方向与距离正确。
失败时如何处理
区域未连接
检查门口、转角和走廊是否从多个方向连续拍摄。如果相邻区域的画面中确实能看到同一个固定角点,可以添加 Tie Point;如果完全没有重叠画面,则必须重新扫描。
画面质量或覆盖不足
回看原视频,检查运动模糊、弱光、长时间对着白墙或玻璃、快速转动以及移动人群。针对根因改善光线、速度或路线后重新扫描。
GCP 或 Scale Bar 误差过大
核对单位、WORLD UP、XYZ 数值和每个观测的物理位置。不要添加更多不准确的点来抵消错误。
建图完成但现场定位不稳定
在 Space Studio 中记录失败区域、持机方向和光照。局部失败通常需要补充该区域的视角覆盖;全局位置或大小不正确时优先检查 GCP 坐标。
重建与源视频变更
可以修正 GCP、Tie Point 或 Scale Bar 后重新建图。若要更换视频或重新解析,请创建一张新地图,避免新的输入意外替换正在使用的地图。