# 快速开始

## 认识 01Spatial：Space-as-a-Service

01Spatial 是一个基于我们独特的 **UX-first VPS（以用户体验为先的视觉定位技术）** 打造的 **Space-as-a-Service（空间即服务）平台**。**Space-as-a-Service 是 01Spatial 提出的创新性概念**：利用视觉定位技术，把博物馆、体育场、商场、工厂等真实空间转化为可定位、可编程、可运营的高价值空间商品。也就是说，同一个场所可以像软件一样持续增加功能、发布体验并创造运营价值。

传统 VPS 通常只回答“设备在哪里”。01Spatial 进一步把扫描建图、视觉定位、无代码 AR 内容、室内外导航、机器人定位和空间运营分析整合到同一平台，并提供**厘米级精度、Campus-scale（园区级）大空间视觉定位**，让空间从静态场所升级为可以持续提供数字体验与运营服务的资产。

[![空间运营方查看平板中的实时摄像头画面和醒目的黄色导航路线，一名人类空间使用者与一台机器人空间使用者在同一场所中沿路径移动；不规则的亮青色特征点分布在稳定角点上，机器人摄像头发出的细青色射线连接到其中若干环境特征，表示机器人正在进行视觉定位](/media/docs/overview-spatial-operating-system-hero-v6.jpg)](/media/docs/overview-spatial-operating-system-hero-v6.jpg)

*亮青色点表示视觉特征点：它们来自真实画面中可重复识别的稳定角点，不会均匀铺满物体表面。细青色射线表示机器人摄像头正在观测其中若干环境特征；机器人结合连续画面估计自身位置，再沿黄色路线导航。一张空间地图连接空间运营方与空间使用者。空间使用者既可以是使用 AR 导航、导览和互动体验的人类，也可以是依靠视觉定位完成导航或任务执行的机器人。*

## Space-as-a-Service 服务谁？

Space-as-a-Service 围绕两类角色建立完整的空间服务闭环：

- **空间运营方**：博物馆、体育场、商场、工厂等场所的运营组织。他们负责把场所构建为空间地图，管理地图和空间内容，发布 AR 与导航体验，并查看机器人轨迹和空间运营数据。
- **空间使用者**：进入并使用空间的人类或机器人。人类使用者可以是博物馆游客、商场访客或现场员工，主要获得 AR 导览、导航和互动体验；机器人则通过定位与导航能力在工厂、园区或公共场所中执行巡检、配送等任务。

空间运营方持续提供和管理空间服务，空间使用者按需使用这些服务。二者共享同一张 **空间地图（Spatial Map）** 和持久坐标系，但拥有不同的入口、权限和目标。

## 从空间扫描到持续运营

01Spatial 不是一个孤立的定位接口。从扫描到上线和运营，完整能力由同一套平台承载：

- **从扫描到地图（Scan-to-map）：** 使用普通相机、全景相机、移动端三维扫描 App 或专业 LiDAR 设备构建空间地图。
- **定位与导航：** 为手机、AR 设备和机器人提供同一坐标系下的定位，以及室内外连续导航能力。
- **无代码内容编辑：** 在 Space Studio 中把文字、图片、三维模型和交互内容放到真实位置，无需重新建图即可持续更新。
- **空间运营：** 支持移动轨迹分析与回放，让空间不再只是一份一次性交付的三维资产，而成为可持续管理的数字基础设施。
- **灵活部署：** 根据项目需要使用云端服务或私有化部署。

这就是 01Spatial 与只提供 VPS 能力的方案之间最重要的区别：我们交付覆盖**空间扫描、地图构建、定位、内容编辑、导航和运营分析**的完整闭环，让你的空间真正成为可供 AR 应用和机器人使用的可编程环境。

下面从完成第一张空间地图开始。

## 1. 选择输入类型

扫描与建图根据源数据分为四类：

| 你已经拥有 | 选择的文档路径 |
| --- | --- |
| 手机、运动相机或普通相机录制的视频 | **普通相机视频** |
| 360° 全景相机录制的视频 | **全景相机视频** |
| [Polycam](https://poly.cam/) 或 [KIRI Engine](https://www.kiriengine.app/) 等第三方三维重建 App 的扫描导出数据 | **移动端三维扫描** |
| 专业的静态或手持式带激光雷达的实景三维扫描仪导出数据 | **LiDAR 扫描** |

不要通过修改文件名来切换输入类型。每条路径依赖的数据结构和建图方法不同。

## 2. 完成一张空间地图

1. 在 Portal 中创建 Map，并选择与源数据一致的输入类型。
2. 按对应指南采集或准备数据，然后上传。
3. 普通相机视频和全景相机视频都必须补充真实大小与坐标基准。扫描时可以放置 **01Spatial 空间基准板**；也可以在视频解析后，使用 **Map Configurator** 标记现场测量的 GCP（Ground Control Point，地面控制点）。这里的“地面”是测绘术语，控制点也可以位于门框、墙角或其他固定构件上。
4. 启动建图并等待 Map 进入就绪状态。

Polycam、KIRI Engine 和 LiDAR 路径会直接使用源数据提供的相机位置、朝向或三维结构信息，不再需要 Map Configurator 流程。

## 3. 管理地图与编辑内容

地图就绪后，在 **Spatial Maps** 页面管理地图。进入 **Space Studio** 后，使用该后台的用户（通常是空间运营方）可以在左侧 **Map Panel** 查看点云、网格、原点、建图相机等地图属性，并直接针对当前地图执行定位测试；同一页面的右侧 **Content Panel** 可以基于地图添加内容，既支持立方体、球体等基础三维对象，也支持导入复杂的 GLB / glTF 三维模型。

对于空间运营方，**Analytics** 面板用于监控和追踪空间中发生的定位记录与移动轨迹。例如，工厂可以回看机器人在厂房中的巡检路线与执行记录；商场、景区或博物馆可以分析访客使用导航时的热点区域、常见路径与停留分布，为内容更新、导览设计和现场运营提供依据。

地图和内容作为独立资源管理。更新文字、模型或交互内容时，通常不需要重新建图。

## 4. 验证定位并开启 AR

先使用 Space Studio 内置的定位测试工具验证地图，再选择交付方式：

- Android 设备使用 WebXR 客户端。
- iOS 设备使用 App Clip 客户端。
- 微信环境使用微信小程序。
- 通用客户端直接接入定位 API。
- Unity 或微信小程序项目可以从模板开始开发。

## 接下来阅读

| 目标 | 推荐文档 |
| --- | --- |
| 先理解完整产品链路 | [它是如何工作的？](/tutorials/concepts/platform-workflow) |
| 使用手机或普通相机开始空间扫描 | [使用普通相机进行空间扫描](/tutorials/mapping/standard-camera-video/capture) |
| 在接入客户端前验证地图 | [使用 Space Studio 执行定位测试](/tutorials/localization/space-studio-test) |
| 在通用客户端中接入定位 | [定位 API 与 AR 集成](/tutorials/localization/localization-api) |

> **建议：** 第一次使用时先完成一张小范围测试地图，完整走通采集、建图和定位流程，再扩大到整个场地。