01Spatial Documentation

Machine-readable: manifest · index · 简体中文 Markdown

使用普通相机视频建图

完成扫描数据配置后,01Spatial 会把普通相机视频转化为可用于定位、内容编辑和 AR 发布的空间地图。建图在云端运行,关闭页面不会中断任务。

建图过程中发生什么

系统会从视频中选择清晰、连续且覆盖充分的画面,生成统一的空间地图,并应用配置阶段确定的真实大小、原点和方向。之后,01Spatial 会检查空间是否连续、目标区域是否被覆盖,以及定位所需文件是否完整。

通过检查的结果会成为 Space Studio、定位 API 和 AR 客户端可直接使用的地图。输入或约束不足时,任务会明确失败并给出原因,不会发布一张看似完成却无法可靠定位的地图。

启动建图

如果使用 Map Configurator,请完成页面中的必填检查,然后选择 Build

如果视频中拍到了合格的 01Spatial 空间基准板,并且解析报告确认观测质量通过,地图卡片会提供 Build with ChArUco。空间基准板自动建图与 Map Configurator 手工 GCP 配置二选一,不要混合提交两套坐标定义。

GCPGround Control Point(地面控制点) 的缩写,表示现场坐标已知、可在多个画面中准确确认的固定点。

理解地图状态

状态含义你需要做什么
排队中等待可用建图资源保持地图与源文件不变,稍后查看进度
建图中正在生成地图和定位资产不要重复启动;可以离开页面后再返回
已就绪地图和定位资产已通过自动检查在 Space Studio 中进行现场定位测试
失败输入、覆盖、配置或输出未通过检查阅读失败原因,修正后重新建图

就绪后验证定位

已就绪表示自动检查通过,不代表真实使用场景已经验收。发布前使用 Space Studio 执行定位测试,确认:

  • 路线起点、中部和终点都能成功定位;
  • 门口、转角和跨房间位置不会跳到错误区域;
  • 用户正常持机高度和方向下能够定位;
  • 预期照明条件下表现稳定;
  • 测试内容的位置、方向与距离正确。

失败时如何处理

区域未连接

检查门口、转角和走廊是否从多个方向连续拍摄。如果相邻区域的画面中确实能看到同一个固定角点,可以添加 Tie Point;如果完全没有重叠画面,则必须重新扫描。

画面质量或覆盖不足

回看原视频,检查运动模糊、弱光、长时间对着白墙或玻璃、快速转动以及移动人群。针对根因改善光线、速度或路线后重新扫描。

GCP 或 Scale Bar 误差过大

核对单位、WORLD UP、XYZ 数值和每个观测的物理位置。不要添加更多不准确的点来抵消错误。

建图完成但现场定位不稳定

在 Space Studio 中记录失败区域、持机方向和光照。局部失败通常需要补充该区域的视角覆盖;全局位置或大小不正确时优先检查 GCP 坐标。

重建与源视频变更

可以修正 GCP、Tie Point 或 Scale Bar 后重新建图。若要更换视频或重新解析,请创建一张新地图,避免新的输入意外替换正在使用的地图。