# 它是如何工作的？

01Spatial 先把真实空间转换为一张可长期复用的**空间地图**，再让两类角色基于同一张地图完成不同任务：空间使用者在现场获得定位、导航或 AR / MR 体验；空间运营方管理地图与内容，并持续运营场所、设备和服务。

[![01Spatial 工作方式：四类空间扫描数据经过公有云或私有环境中的建图服务生成空间地图；空间使用者获得视觉定位、导航与已发布内容，空间运营方负责地图、内容与空间运营](/media/docs/platform-workflow-v2.en.svg)](/media/docs/platform-workflow-v2.en.svg)

图中的两条角色路径不是先后两个处理阶段。空间使用者与空间运营方拥有不同的目标、入口和权限；他们共享同一张空间地图，但以不同方式使用它。点击图片可以查看原尺寸。

## 1. 扫描真实空间

首先根据已有数据选择对应的输入类型：

- **普通相机视频**：手机、运动相机或其他普通相机录制的连续视频。
- **全景相机视频**：360° 相机录制并由厂商软件拼接成 2:1 画面的全景视频。
- **移动端三维扫描**：[Polycam](https://poly.cam/) 或 [KIRI Engine](https://www.kiriengine.app/) 等第三方三维重建 App 的扫描导出数据。
- **LiDAR 扫描（最推荐）**：专业的静态式或手持式 LiDAR 实景三维扫描仪的导出数据；它通常能提供最稳定、最完整的空间几何基础。

普通相机视频和全景相机视频都必须补充真实大小与坐标基准：扫描时放置 **01Spatial 空间基准板**，或在视频解析后使用 **Map Configurator** 标记现场测量的 GCP（Ground Control Point，地面控制点）。移动端三维扫描和 LiDAR 数据已经包含相机位置、朝向或空间几何信息，因此使用各自的数据准备流程。

## 2. 建图：生成空间地图

建图服务可以运行在 01Spatial 托管的公有云，也可以部署在企业的私有环境中。无论选择哪种部署方式，输入数据最终都会被转换为同一种核心资产：空间地图。

空间地图不只是可观看的三维模型。它包含：

- 一套持久、稳定的空间坐标系。
- 客户端进行视觉定位所需的地图资产。
- 空间内容、设备轨迹和运营数据共同使用的坐标基准。

地图进入就绪状态后，才能用于 Space Studio 定位测试、定位 API、AR 客户端或场所运营功能。扫描覆盖范围、画面质量和空间基准的准确性会直接影响后续结果。

## 3. 两类角色拥有不同职责

| 角色 | 谁属于这个角色 | 主要目标 | 典型入口 |
| --- | --- | --- | --- |
| **空间使用者** | 使用 AR 导航、导览或互动体验的人类，以及需要定位或导航的机器人 | 在现场确定自身位置，并使用导航、内容或任务服务 | WebXR、App Clip、微信小程序、移动 App、AR 设备、机器人客户端 |
| **空间运营方** | 博物馆、体育场、商场、工厂等场所的运营组织及其管理员；不一定是场地的产权所有人 | 管理地图、创作并发布内容、管理设备、分析空间运行情况 | Spatial Maps、Space Studio、运营系统与管理 API |

二者最重要的关系是：**空间运营方创建并发布空间服务，空间使用者在定位成功后使用这些服务。** 对人类而言，服务可以是 AR 导览、导航或互动内容；对机器人而言，服务主要是定位、导航和任务所需的空间坐标。即使同一个人在小型演示中同时扮演两种角色，产品流程和权限仍会将它们作为两种独立身份管理。

## 4. 空间使用者：定位并使用空间

空间使用者既可以是使用 AR 导航、导览或互动体验的人类用户，也可以是需要视觉定位和导航的机器人。两者都不需要进入地图管理后台，而是通过各自的客户端使用空间地图：

1. 人类用户的手机、AR 设备或机器人的摄像头发送相机画面及对应的相机内参。
2. 01Spatial 返回设备在空间地图坐标系中的 6 自由度（6-DoF）位置和朝向。
3. 人类用户的客户端根据定位结果显示空间运营方发布的 AR 内容或导航路线；机器人则利用定位结果进行导航和任务执行。

视觉定位与已发布内容结合后，可以形成 AR / MR、室内导航、导览、现场说明或空间交互体验。接入前应先使用 Space Studio 内置工具验证定位，再根据产品形态选择 Android WebXR、iOS App Clip、微信小程序、定位 API、Unity 模板或微信小程序模板。

机器人属于空间使用者的一种。机器人通过视觉定位获得自身位姿并完成导航；空间运营方则负责集中查看和管理机器人的位置、路线及历史轨迹。

## 5. 空间运营方：创作并运营空间

空间运营方维护地图和业务内容，并决定空间使用者在现场能够使用哪些服务：

- **Spatial Maps**：新建地图、查看建图状态、移动或转移地图，并进入后续操作。
- **Map Panel**：在 Space Studio 中查看和切换地图，检查点云、网格、原点和相机位置。
- **Content Panel**：添加、编辑和发布 3D 模型、文字说明、导航节点或交互热点。
- **Robot Tracking**：在统一地图坐标系中查看机器人或其他受管理设备的位置与路线。
- **Space Analytics**：记录并分析定位会话、轨迹与空间使用情况，为运营决策提供依据。

地图和内容具有不同生命周期。地图定义真实空间及其坐标系；内容描述业务应用需要在这个坐标系中显示或管理的对象。因此，大多数内容更新可以直接发布，无需重新扫描或建图。

## 三个核心对象

| 对象 | 作用 |
| --- | --- |
| **Map** | 一处真实空间的坐标系、建图结果和定位所需的数据 |
| **Project** | 组织多张 Map，让客户端能够在更大范围内定位 |
| **Content** | 由空间运营方创作并发布、由空间使用者在 Map 坐标系中使用的空间内容 |

这三个对象相互关联，但可以分别更新：地图可以长期复用，Project 可以增加或移除 Map，内容也可以独立更新和发布。