{ "schemaVersion": 2, "product": "01Spatial", "documentSet": "01Spatial Documentation", "basePath": "/tutorials", "defaultPolicy": { "cn": "zh-Hans", "globalRequested": "en", "globalActive": "zh-Hans", "fallback": "zh-Hans", "rule": "Explicit language paths always win. A regional default can only select a published locale." }, "languages": [ { "code": "en", "label": "English", "status": "draft", "preferredOrigin": "https://portal.01spatial.ai" }, { "code": "zh-Hans", "label": "简体中文", "status": "published", "preferredOrigin": "https://portal.01spatial.cn" } ], "machineEntrypoints": { "index": "/llms.txt", "fullText": "/llms-full.txt", "manifest": "/docs-manifest.json", "sitemap": "/sitemap.xml", "markdownRoot": "/ai-docs/{language}/" }, "documents": [ { "id": "overview", "slug": "", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en", "zh-Hans": "/tutorials/zh-Hans" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans" }, "previous": { "en": null, "zh-Hans": null }, "next": { "en": "/tutorials/en/concepts/platform-workflow", "zh-Hans": "/tutorials/zh-Hans/concepts/platform-workflow" }, "title": { "en": "Get Started", "zh-Hans": "快速开始" }, "description": { "en": "01Spatial is a Space-as-a-Service platform built on our distinctive UX-first visual positioning technology (UX-first VPS). Space-as-a-Service is an innovative concept introduced by 01Spatial: visual positioning turns a museum, stadium, mall, factory, or other real venue into a locatable, programmable, and operable high-value spatial product.", "zh-Hans": "01Spatial 是一个基于我们独特的 UX-first VPS（以用户体验为先的视觉定位技术） 打造的 Space-as-a-Service（空间即服务）平台。Space-as-a-Service 是 01Spatial 提出的创新性概念：利用视觉定位技术，把博物馆、体育场、商场、工厂等真实空间转化为可定位、可编程、可运营的高价值空间商品。也就是说，同一个场所可以像软件一样持续增加功能、发布体验并创造运营价值。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/overview.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/overview.md" }, "contentHash": { "en": "sha256:bed4245755bd24c144d873db420a1e86e8a99fcefb6dcbead51934064cd32635", "zh-Hans": "sha256:ee30f902bc743101dc0553b5236e7fe8ab8ff3a4e178e1973a8300f88f3b4294" }, "headings": { "en": [ { "level": 1, "text": "Get Started", "id": "get-started" }, { "level": 2, "text": "Meet 01Spatial: Space-as-a-Service", "id": "meet-01spatial-space-as-a-service" }, { "level": 2, "text": "Who uses Space-as-a-Service?", "id": "who-uses-space-as-a-service" }, { "level": 2, "text": "From spatial capture to continuous operations", "id": "from-spatial-capture-to-continuous-operations" }, { "level": 2, "text": "1. Choose an input type", "id": "1-choose-an-input-type" }, { "level": 2, "text": "2. Build a spatial map", "id": "2-build-a-spatial-map" }, { "level": 2, "text": "3. Manage maps and author content", "id": "3-manage-maps-and-author-content" }, { "level": 2, "text": "4. Validate localization and launch AR", "id": "4-validate-localization-and-launch-ar" }, { "level": 2, "text": "Read next", "id": "read-next" } ], "zh-Hans": [ { "level": 1, "text": "快速开始", "id": "快速开始" }, { "level": 2, "text": "认识 01Spatial：Space-as-a-Service", "id": "认识-01spatial-space-as-a-service" }, { "level": 2, "text": "Space-as-a-Service 服务谁？", "id": "space-as-a-service-服务谁" }, { "level": 2, "text": "从空间扫描到持续运营", "id": "从空间扫描到持续运营" }, { "level": 2, "text": "1. 选择输入类型", "id": "1-选择输入类型" }, { "level": 2, "text": "2. 完成一张空间地图", "id": "2-完成一张空间地图" }, { "level": 2, "text": "3. 管理地图与编辑内容", "id": "3-管理地图与编辑内容" }, { "level": 2, "text": "4. 验证定位并开启 AR", "id": "4-验证定位并开启-ar" }, { "level": 2, "text": "接下来阅读", "id": "接下来阅读" } ] } }, { "id": "concepts/platform-workflow", "slug": "concepts/platform-workflow", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/concepts/platform-workflow", "zh-Hans": "/tutorials/zh-Hans/concepts/platform-workflow" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/concepts/platform-workflow", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/concepts/platform-workflow" }, "previous": { "en": "/tutorials/en", "zh-Hans": "/tutorials/zh-Hans" }, "next": { "en": "/tutorials/en/concepts/for-ar-developers", "zh-Hans": "/tutorials/zh-Hans/concepts/for-ar-developers" }, "title": { "en": "How it works", "zh-Hans": "它是如何工作的？" }, "description": { "en": "01Spatial first turns a real place into a persistent Spatial Map. Two roles then use that map for different jobs: a Space User obtains positioning, navigation, or AR / MR experiences, while a Space Owner manages maps, content, and venue operations. A Space User can be a person or a robot.", "zh-Hans": "01Spatial 先把真实空间转换为一张可长期复用的空间地图，再让两类角色基于同一张地图完成不同任务：空间使用者在现场获得定位、导航或 AR / MR 体验；空间运营方管理地图与内容，并持续运营场所、设备和服务。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/concepts/platform-workflow.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/concepts/platform-workflow.md" }, "contentHash": { "en": "sha256:45b15a47c1fee8f6767b880b209652d1daa7d6daa89d84b86861bb9dd60feab8", "zh-Hans": "sha256:594063ef9bf5239dc0c9fb31b5ae4ac48c59d8fe92c62027c09777103ea29ef1" }, "headings": { "en": [ { "level": 1, "text": "How it works", "id": "how-it-works" }, { "level": 2, "text": "1. Scan the real space", "id": "1-scan-the-real-space" }, { "level": 2, "text": "2. Build a Spatial Map", "id": "2-build-a-spatial-map" }, { "level": 2, "text": "3. Two roles, different responsibilities", "id": "3-two-roles-different-responsibilities" }, { "level": 2, "text": "4. Space User: localize and experience the venue", "id": "4-space-user-localize-and-experience-the-venue" }, { "level": 2, "text": "5. Space Owner: author and operate the venue", "id": "5-space-owner-author-and-operate-the-venue" }, { "level": 2, "text": "Three core objects", "id": "three-core-objects" } ], "zh-Hans": [ { "level": 1, "text": "它是如何工作的？", "id": "它是如何工作的" }, { "level": 2, "text": "1. 扫描真实空间", "id": "1-扫描真实空间" }, { "level": 2, "text": "2. 建图：生成空间地图", "id": "2-建图-生成空间地图" }, { "level": 2, "text": "3. 两类角色拥有不同职责", "id": "3-两类角色拥有不同职责" }, { "level": 2, "text": "4. 空间使用者：定位并使用空间", "id": "4-空间使用者-定位并使用空间" }, { "level": 2, "text": "5. 空间运营方：创作并运营空间", "id": "5-空间运营方-创作并运营空间" }, { "level": 2, "text": "三个核心对象", "id": "三个核心对象" } ] } }, { "id": "concepts/for-ar-developers", "slug": "concepts/for-ar-developers", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/concepts/for-ar-developers", "zh-Hans": "/tutorials/zh-Hans/concepts/for-ar-developers" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/concepts/for-ar-developers", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/concepts/for-ar-developers" }, "previous": { "en": "/tutorials/en/concepts/platform-workflow", "zh-Hans": "/tutorials/zh-Hans/concepts/platform-workflow" }, "next": { "en": "/tutorials/en/concepts/for-robotics-developers", "zh-Hans": "/tutorials/zh-Hans/concepts/for-robotics-developers" }, "title": { "en": "For AR developers", "zh-Hans": "写给 AR 开发者" }, "description": { "en": "AR projects span table-scale, room-scale, building-scale, campus-scale, and city-scale environments. Device SLAM can track motion at 30–60 FPS and is usually sufficient for table- and room-scale experiences. Over longer routes, small frame-to-frame errors accumulate into visible drift, so building- and campus-scale projects need VPS.", "zh-Hans": "AR 项目的技术难度首先由空间尺度决定：" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/concepts/for-ar-developers.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/concepts/for-ar-developers.md" }, "contentHash": { "en": "sha256:a77282fad85795bd84c99a8800290b9a686feb75719cd1cd4ce12fc92cfc50e8", "zh-Hans": "sha256:2588d4293165d3f3cb236196e50441de5be3e410c36b8f151ae219096772ca2f" }, "headings": { "en": [ { "level": 1, "text": "For AR developers", "id": "for-ar-developers" }, { "level": 2, "text": "Start with project scale", "id": "start-with-project-scale" }, { "level": 2, "text": "Design for changing light", "id": "design-for-changing-light" }, { "level": 2, "text": "Build an operable AR product", "id": "build-an-operable-ar-product" }, { "level": 2, "text": "Recommended sequence", "id": "recommended-sequence" } ], "zh-Hans": [ { "level": 1, "text": "写给 AR 开发者", "id": "写给-ar-开发者" }, { "level": 2, "text": "先按空间尺度理解 AR 项目", "id": "先按空间尺度理解-ar-项目" }, { "level": 2, "text": "光照变化是第二个核心挑战", "id": "光照变化是第二个核心挑战" }, { "level": 2, "text": "从定位能力到可运营的 AR 产品", "id": "从定位能力到可运营的-ar-产品" }, { "level": 2, "text": "推荐的开发顺序", "id": "推荐的开发顺序" } ] } }, { "id": "concepts/for-robotics-developers", "slug": "concepts/for-robotics-developers", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/concepts/for-robotics-developers", "zh-Hans": "/tutorials/zh-Hans/concepts/for-robotics-developers" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/concepts/for-robotics-developers", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/concepts/for-robotics-developers" }, "previous": { "en": "/tutorials/en/concepts/for-ar-developers", "zh-Hans": "/tutorials/zh-Hans/concepts/for-ar-developers" }, "next": { "en": "/tutorials/en/mapping/standard-camera-video/capture", "zh-Hans": "/tutorials/zh-Hans/mapping/standard-camera-video/capture" }, "title": { "en": "For robotics developers", "zh-Hans": "写给机器人开发者" }, "description": { "en": "Robotics projects usually focus on localization and monitoring rather than AR rendering. A robot can use an onboard camera or an externally mounted camera. With the intrinsics that correspond to the submitted pixels, 01Spatial returns a 6-DoF pose in the Spatial Map coordinate system.", "zh-Hans": "机器人项目的重点通常不是显示 AR 内容，而是让设备在大空间中持续知道“我在哪里、朝向哪里、刚才经过哪里”。01Spatial 为机器人提供统一空间地图中的视觉定位，并为运营方保留定位记录与运动轨迹，用于导航、任务执行、监控和复盘。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/concepts/for-robotics-developers.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/concepts/for-robotics-developers.md" }, "contentHash": { "en": "sha256:2cf544cbdcaf8bd022c7bc29cde1aed5ebc214ef0879673c64fea4ca24574abc", "zh-Hans": "sha256:b6afe2c985bcb1c3bbb4bc9767c9d9f04474e179e1c02f609cecbdefd7037eaa" }, "headings": { "en": [ { "level": 1, "text": "For robotics developers", "id": "for-robotics-developers" }, { "level": 2, "text": "Reliable positioning comes first", "id": "reliable-positioning-comes-first" }, { "level": 2, "text": "One map connects robots and operations", "id": "one-map-connects-robots-and-operations" }, { "level": 2, "text": "Private deployment and industrial security", "id": "private-deployment-and-industrial-security" }, { "level": 2, "text": "Recommended sequence", "id": "recommended-sequence" } ], "zh-Hans": [ { "level": 1, "text": "写给机器人开发者", "id": "写给机器人开发者" }, { "level": 2, "text": "机器人项目首先需要可靠定位", "id": "机器人项目首先需要可靠定位" }, { "level": 2, "text": "一套地图连接机器人端与运营端", "id": "一套地图连接机器人端与运营端" }, { "level": 2, "text": "私有化部署与工业数据安全", "id": "私有化部署与工业数据安全" }, { "level": 2, "text": "推荐的集成顺序", "id": "推荐的集成顺序" } ] } }, { "id": "mapping/standard-camera-video/capture", "slug": "mapping/standard-camera-video/capture", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/mapping/standard-camera-video/capture", "zh-Hans": "/tutorials/zh-Hans/mapping/standard-camera-video/capture" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/mapping/standard-camera-video/capture", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/mapping/standard-camera-video/capture" }, "previous": { "en": "/tutorials/en/concepts/for-robotics-developers", "zh-Hans": "/tutorials/zh-Hans/concepts/for-robotics-developers" }, "next": { "en": "/tutorials/en/mapping/standard-camera-video/map-configurator", "zh-Hans": "/tutorials/zh-Hans/mapping/standard-camera-video/map-configurator" }, "title": { "en": "Scan a space with a standard camera", "zh-Hans": "使用普通相机进行空间扫描" }, "description": { "en": "Standard camera video is a fast way to scan a space with a phone, action camera, or pinhole camera. The goal is not to make a polished walk-through video; it is to give the mapping system a continuous sequence of sharp, overlapping views.", "zh-Hans": "普通相机视频适合使用手机、运动相机或其他非全景相机快速扫描空间。目标不是拍摄一段好看的参观视频，而是让建图系统持续看到清晰、连续且相互重叠的视角。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/mapping/standard-camera-video/capture.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/mapping/standard-camera-video/capture.md" }, "contentHash": { "en": "sha256:f372771b664251a42dd8fcc44c249c3018b18f291313dceea4d949e168b19f86", "zh-Hans": "sha256:4af0b1fbe34c632108619c1b32685dc0bff518408fd48c6de2ea2bf8f75d4972" }, "headings": { "en": [ { "level": 1, "text": "Scan a space with a standard camera", "id": "scan-a-space-with-a-standard-camera" }, { "level": 2, "text": "When to use this path", "id": "when-to-use-this-path" }, { "level": 2, "text": "Prepare before recording", "id": "prepare-before-recording" }, { "level": 2, "text": "Plan the route", "id": "plan-the-route" }, { "level": 2, "text": "Record the video", "id": "record-the-video" }, { "level": 2, "text": "Create a map and upload the video in Portal", "id": "create-a-map-and-upload-the-video-in-portal" }, { "level": 2, "text": "Continue after upload", "id": "continue-after-upload" } ], "zh-Hans": [ { "level": 1, "text": "使用普通相机进行空间扫描", "id": "使用普通相机进行空间扫描" }, { "level": 2, "text": "适用范围", "id": "适用范围" }, { "level": 2, "text": "开始前准备", "id": "开始前准备" }, { "level": 2, "text": "规划扫描路线", "id": "规划扫描路线" }, { "level": 2, "text": "录制视频", "id": "录制视频" }, { "level": 2, "text": "在 Portal 创建地图并上传视频", "id": "在-portal-创建地图并上传视频" }, { "level": 2, "text": "上传后的下一步", "id": "上传后的下一步" } ] } }, { "id": "mapping/standard-camera-video/map-configurator", "slug": "mapping/standard-camera-video/map-configurator", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/mapping/standard-camera-video/map-configurator", "zh-Hans": "/tutorials/zh-Hans/mapping/standard-camera-video/map-configurator" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/mapping/standard-camera-video/map-configurator", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/mapping/standard-camera-video/map-configurator" }, "previous": { "en": "/tutorials/en/mapping/standard-camera-video/capture", "zh-Hans": "/tutorials/zh-Hans/mapping/standard-camera-video/capture" }, "next": { "en": "/tutorials/en/mapping/standard-camera-video/build", "zh-Hans": "/tutorials/zh-Hans/mapping/standard-camera-video/build" }, "title": { "en": "Configure standard-camera scan data", "zh-Hans": "配置普通相机扫描数据" }, "description": { "en": "Map Configurator loads frames extracted from the video and preserves their recorded orientation. Mark surveyed, fixed corners across several frames to give the map the correct real-world size, origin, and orientation. The video does not need to be uploaded again.", "zh-Hans": "Map Configurator 会直接加载从视频中解析出的画面，竖屏和横屏视频都会保留原始方向。你需要在多个画面中标记现场测量的固定角点，让地图获得正确的真实大小、原点和方向。视频不需要再次上传。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/mapping/standard-camera-video/map-configurator.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/mapping/standard-camera-video/map-configurator.md" }, "contentHash": { "en": "sha256:4a9683f287cd12b8dde5c81cbd01fece9079a4019c2e8a4d20b6ad252c13545a", "zh-Hans": "sha256:593a16e13301ce0ae90e9006b15a38d6befb83a7f6d04b09ee5a9191ec49a07c" }, "headings": { "en": [ { "level": 1, "text": "Configure standard-camera scan data", "id": "configure-standard-camera-scan-data" }, { "level": 2, "text": "Understand the three constraint types", "id": "understand-the-three-constraint-types" }, { "level": 2, "text": "1. Open the configuration and choose the world frame", "id": "1-open-the-configuration-and-choose-the-world-frame" }, { "level": 2, "text": "2. Add the first GCP", "id": "2-add-the-first-gcp" }, { "level": 3, "text": "Add observations in more frames", "id": "add-observations-in-more-frames" }, { "level": 2, "text": "3. Span the 3D space with GCPs", "id": "3-span-the-3d-space-with-gcps" }, { "level": 2, "text": "4. Add Tie Points where needed", "id": "4-add-tie-points-where-needed" }, { "level": 2, "text": "5. Add a Scale Bar where needed", "id": "5-add-a-scale-bar-where-needed" }, { "level": 2, "text": "6. Check before building", "id": "6-check-before-building" } ], "zh-Hans": [ { "level": 1, "text": "配置普通相机扫描数据", "id": "配置普通相机扫描数据" }, { "level": 2, "text": "先理解三类配置", "id": "先理解三类配置" }, { "level": 2, "text": "1. 打开配置并选择坐标约定", "id": "1-打开配置并选择坐标约定" }, { "level": 2, "text": "2. 添加第一个 GCP", "id": "2-添加第一个-gcp" }, { "level": 3, "text": "添加多画面观测", "id": "添加多画面观测" }, { "level": 2, "text": "3. 用 GCP 覆盖三维空间", "id": "3-用-gcp-覆盖三维空间" }, { "level": 2, "text": "4. 按需添加 Tie Point", "id": "4-按需添加-tie-point" }, { "level": 2, "text": "5. 按需添加 Scale Bar", "id": "5-按需添加-scale-bar" }, { "level": 2, "text": "6. 建图前检查", "id": "6-建图前检查" } ] } }, { "id": "mapping/standard-camera-video/build", "slug": "mapping/standard-camera-video/build", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/mapping/standard-camera-video/build", "zh-Hans": "/tutorials/zh-Hans/mapping/standard-camera-video/build" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/mapping/standard-camera-video/build", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/mapping/standard-camera-video/build" }, "previous": { "en": "/tutorials/en/mapping/standard-camera-video/map-configurator", "zh-Hans": "/tutorials/zh-Hans/mapping/standard-camera-video/map-configurator" }, "next": { "en": "/tutorials/en/mapping/panorama-camera-video/capture", "zh-Hans": "/tutorials/zh-Hans/mapping/panorama-camera-video/capture" }, "title": { "en": "Build a map from standard-camera video", "zh-Hans": "使用普通相机视频建图" }, "description": { "en": "After configuration, 01Spatial turns the standard-camera video into a spatial map for localization, content authoring, and AR delivery. The cloud build continues after you leave the page.", "zh-Hans": "完成扫描数据配置后，01Spatial 会把普通相机视频转化为可用于定位、内容编辑和 AR 发布的空间地图。建图在云端运行，关闭页面不会中断任务。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/mapping/standard-camera-video/build.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/mapping/standard-camera-video/build.md" }, "contentHash": { "en": "sha256:d0e5081e397f393466274e0e768a65e9ea9a8fa487c1d8f1c798ca25d1a636bf", "zh-Hans": "sha256:893749abbbf2e1417fedc4f5331519da023c5b48efb74eb9e7fafc71d1a7ef7d" }, "headings": { "en": [ { "level": 1, "text": "Build a map from standard-camera video", "id": "build-a-map-from-standard-camera-video" }, { "level": 2, "text": "What happens during a build", "id": "what-happens-during-a-build" }, { "level": 2, "text": "Start the build", "id": "start-the-build" }, { "level": 2, "text": "Understand map states", "id": "understand-map-states" }, { "level": 2, "text": "Validate localization after Ready", "id": "validate-localization-after-ready" }, { "level": 2, "text": "Respond to failures", "id": "respond-to-failures" }, { "level": 3, "text": "Disconnected area", "id": "disconnected-area" }, { "level": 3, "text": "Insufficient image quality or coverage", "id": "insufficient-image-quality-or-coverage" }, { "level": 3, "text": "Abnormal GCP or Scale Bar residuals", "id": "abnormal-gcp-or-scale-bar-residuals" }, { "level": 3, "text": "Build succeeds but field localization is unstable", "id": "build-succeeds-but-field-localization-is-unstable" }, { "level": 2, "text": "Rebuilds and source changes", "id": "rebuilds-and-source-changes" } ], "zh-Hans": [ { "level": 1, "text": "使用普通相机视频建图", "id": "使用普通相机视频建图" }, { "level": 2, "text": "建图过程中发生什么", "id": "建图过程中发生什么" }, { "level": 2, "text": "启动建图", "id": "启动建图" }, { "level": 2, "text": "理解地图状态", "id": "理解地图状态" }, { "level": 2, "text": "就绪后验证定位", "id": "就绪后验证定位" }, { "level": 2, "text": "失败时如何处理", "id": "失败时如何处理" }, { "level": 3, "text": "区域未连接", "id": "区域未连接" }, { "level": 3, "text": "画面质量或覆盖不足", "id": "画面质量或覆盖不足" }, { "level": 3, "text": "GCP 或 Scale Bar 误差过大", "id": "gcp-或-scale-bar-误差过大" }, { "level": 3, "text": "建图完成但现场定位不稳定", "id": "建图完成但现场定位不稳定" }, { "level": 2, "text": "重建与源视频变更", "id": "重建与源视频变更" } ] } }, { "id": "mapping/panorama-camera-video/capture", "slug": "mapping/panorama-camera-video/capture", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/mapping/panorama-camera-video/capture", "zh-Hans": "/tutorials/zh-Hans/mapping/panorama-camera-video/capture" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/mapping/panorama-camera-video/capture", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/mapping/panorama-camera-video/capture" }, "previous": { "en": "/tutorials/en/mapping/standard-camera-video/build", "zh-Hans": "/tutorials/zh-Hans/mapping/standard-camera-video/build" }, "next": { "en": "/tutorials/en/mapping/panorama-camera-video/spatial-reference-board", "zh-Hans": "/tutorials/zh-Hans/mapping/panorama-camera-video/spatial-reference-board" }, "title": { "en": "Scan a space with a 360° camera", "zh-Hans": "使用全景相机进行空间扫描" }, "description": { "en": "01Spatial is not tied to a dedicated brand or model. Any 360° camera that can export a standard 2:1 equirectangular video through its vendor software can be used, including any Insta360 model, any GoPro MAX model, any RICOH THETA model, and cameras from other brands.", "zh-Hans": "01Spatial 不绑定专用品牌或型号。只要相机能够通过厂商软件导出标准的 2:1 等距柱状投影视频，即可用于空间扫描。支持范围包括 Insta360 任意型号、GoPro MAX 任意型号、RICOH THETA 任意型号，以及其他品牌的全景相机。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/mapping/panorama-camera-video/capture.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/mapping/panorama-camera-video/capture.md" }, "contentHash": { "en": "sha256:f6850c15cf57e87da8f6081e1243e0f94eabe61cfadb36568ebca8f1bffb60b2", "zh-Hans": "sha256:4a0fef1b5c7a88fa667cb0cfcbc847978cb315736b4a4984dae675599b1de1a0" }, "headings": { "en": [ { "level": 1, "text": "Scan a space with a 360° camera", "id": "scan-a-space-with-a-360-camera" }, { "level": 2, "text": "Define a successful scan first", "id": "define-a-successful-scan-first" }, { "level": 2, "text": "Prepare the camera and site", "id": "prepare-the-camera-and-site" }, { "level": 3, "text": "Prefer 8K and remove every lens cover", "id": "prefer-8k-and-remove-every-lens-cover" }, { "level": 3, "text": "Prepare storage, power, and the site", "id": "prepare-storage-power-and-the-site" }, { "level": 2, "text": "Plan a scan route with loop closure", "id": "plan-a-scan-route-with-loop-closure" }, { "level": 3, "text": "Small room", "id": "small-room" }, { "level": 3, "text": "Long corridor", "id": "long-corridor" }, { "level": 3, "text": "Connected rooms", "id": "connected-rooms" }, { "level": 3, "text": "Large open area", "id": "large-open-area" }, { "level": 3, "text": "Very large or multi-floor site", "id": "very-large-or-multi-floor-site" }, { "level": 2, "text": "Record the video", "id": "record-the-video" }, { "level": 2, "text": "Preserve reliable observations for a spatial reference", "id": "preserve-reliable-observations-for-a-spatial-reference" }, { "level": 2, "text": "Export and upload", "id": "export-and-upload" }, { "level": 2, "text": "Pre-upload checklist", "id": "pre-upload-checklist" } ], "zh-Hans": [ { "level": 1, "text": "使用全景相机进行空间扫描", "id": "使用全景相机进行空间扫描" }, { "level": 2, "text": "什么样的扫描可以用于建图", "id": "什么样的扫描可以用于建图" }, { "level": 2, "text": "准备相机与现场", "id": "准备相机与现场" }, { "level": 3, "text": "首选 8K，并拆除所有镜头保护盖", "id": "首选-8k-并拆除所有镜头保护盖" }, { "level": 3, "text": "准备存储、供电和现场", "id": "准备存储-供电和现场" }, { "level": 2, "text": "规划一条有闭环的扫描路线", "id": "规划一条有闭环的扫描路线" }, { "level": 3, "text": "小房间", "id": "小房间" }, { "level": 3, "text": "长走廊", "id": "长走廊" }, { "level": 3, "text": "相互连通的房间", "id": "相互连通的房间" }, { "level": 3, "text": "大型开放空间", "id": "大型开放空间" }, { "level": 3, "text": "超大或多楼层空间", "id": "超大或多楼层空间" }, { "level": 2, "text": "录制视频", "id": "录制视频" }, { "level": 2, "text": "提前准备真实大小和坐标基准", "id": "提前准备真实大小和坐标基准" }, { "level": 2, "text": "导出并上传", "id": "导出并上传" }, { "level": 2, "text": "上传前检查清单", "id": "上传前检查清单" } ] } }, { "id": "mapping/panorama-camera-video/spatial-reference-board", "slug": "mapping/panorama-camera-video/spatial-reference-board", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/mapping/panorama-camera-video/spatial-reference-board", "zh-Hans": "/tutorials/zh-Hans/mapping/panorama-camera-video/spatial-reference-board" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/mapping/panorama-camera-video/spatial-reference-board", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/mapping/panorama-camera-video/spatial-reference-board" }, "previous": { "en": "/tutorials/en/mapping/panorama-camera-video/capture", "zh-Hans": "/tutorials/zh-Hans/mapping/panorama-camera-video/capture" }, "next": { "en": "/tutorials/en/mapping/panorama-camera-video/map-configurator", "zh-Hans": "/tutorials/zh-Hans/mapping/panorama-camera-video/map-configurator" }, "title": { "en": "Use 01Spatial Reference Boards", "zh-Hans": "使用 01Spatial 空间基准板" }, "description": { "en": "The 01Spatial Reference Board is a printable ChArUco pattern. It tells the system how long one meter is in the real site, where the map origin is, and which direction is up. You may use no boards or place several according to the space; the current official kit contains ten uniquely numbered boards. If boards cannot be placed, scan normally and configure surveyed GCPs (Ground Control Points) in Map Configurator after parsing. Despite the name, a GCP does not have to be on the floor.", "zh-Hans": "01Spatial 空间基准板（01Spatial Reference Board） 是一套可打印的定位图案，由棋盘格角点和唯一编码组合而成，技术名称为 ChArUco。它帮助系统确定地图的真实大小、原点和朝上方向。扫描前可以不放置，也可以按空间规模放置多张；当前官方套件包含 10 张唯一编号的板。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/mapping/panorama-camera-video/spatial-reference-board.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/mapping/panorama-camera-video/spatial-reference-board.md" }, "contentHash": { "en": "sha256:40c3120f3104b24006be28ba6ed7bf0243b3fa3a1eea55d613d9574785d6c405", "zh-Hans": "sha256:d2c14847650a0de498cb7609db7123d63a1f42ed66f3e2e64166daf9e6f7d30e" }, "headings": { "en": [ { "level": 1, "text": "Use 01Spatial Reference Boards", "id": "use-01spatial-reference-boards" }, { "level": 2, "text": "Why a physical reference is required", "id": "why-a-physical-reference-is-required" }, { "level": 2, "text": "Choose how many boards to prepare", "id": "choose-how-many-boards-to-prepare" }, { "level": 2, "text": "Download the official print files", "id": "download-the-official-print-files" }, { "level": 2, "text": "Print at true physical size", "id": "print-at-true-physical-size" }, { "level": 2, "text": "Place the boards on site", "id": "place-the-boards-on-site" }, { "level": 3, "text": "Place datum board #0", "id": "place-datum-board-0" }, { "level": 3, "text": "Place helper boards", "id": "place-helper-boards" }, { "level": 2, "text": "Capture every board clearly", "id": "capture-every-board-clearly" }, { "level": 2, "text": "Confirm the route after upload", "id": "confirm-the-route-after-upload" }, { "level": 2, "text": "Pre-scan checklist", "id": "pre-scan-checklist" } ], "zh-Hans": [ { "level": 1, "text": "使用 01Spatial 空间基准板", "id": "使用-01spatial-空间基准板" }, { "level": 2, "text": "为什么需要空间基准", "id": "为什么需要空间基准" }, { "level": 2, "text": "决定准备多少张", "id": "决定准备多少张" }, { "level": 2, "text": "下载官方打印文件", "id": "下载官方打印文件" }, { "level": 2, "text": "按真实尺寸打印", "id": "按真实尺寸打印" }, { "level": 2, "text": "在现场放置", "id": "在现场放置" }, { "level": 3, "text": "放置 #0 基准板", "id": "放置-0-基准板" }, { "level": 3, "text": "放置辅助板", "id": "放置辅助板" }, { "level": 2, "text": "扫描时让系统看清每块板", "id": "扫描时让系统看清每块板" }, { "level": 2, "text": "上传后确认采用哪条路线", "id": "上传后确认采用哪条路线" }, { "level": 2, "text": "扫描前检查清单", "id": "扫描前检查清单" } ] } }, { "id": "mapping/panorama-camera-video/map-configurator", "slug": "mapping/panorama-camera-video/map-configurator", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/mapping/panorama-camera-video/map-configurator", "zh-Hans": "/tutorials/zh-Hans/mapping/panorama-camera-video/map-configurator" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/mapping/panorama-camera-video/map-configurator", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/mapping/panorama-camera-video/map-configurator" }, "previous": { "en": "/tutorials/en/mapping/panorama-camera-video/spatial-reference-board", "zh-Hans": "/tutorials/zh-Hans/mapping/panorama-camera-video/spatial-reference-board" }, "next": { "en": "/tutorials/en/mapping/panorama-camera-video/build", "zh-Hans": "/tutorials/zh-Hans/mapping/panorama-camera-video/build" }, "title": { "en": "Configure scan data", "zh-Hans": "配置扫描数据" }, "description": { "en": "Map Configurator associates visual observations from the scan video with measured site data, giving the map a trustworthy real-world size, origin, and axis orientation. Portal loads the parsed panorama frames directly; the video is not uploaded again.", "zh-Hans": "Map Configurator 用现场实测坐标标记视频中的固定角点，从而确定地图的真实大小、原点和坐标方向。Portal 会直接加载已经解析好的全景画面，不需要再次上传视频。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/mapping/panorama-camera-video/map-configurator.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/mapping/panorama-camera-video/map-configurator.md" }, "contentHash": { "en": "sha256:ae1dcfafe9bbb56c6c13ca98cc2abeaa53c4269db48db45da70bac1b668be4e0", "zh-Hans": "sha256:439be6c85f7e0fac08064047bc1fec1cd514209f7443d65d927eb04d84d00806" }, "headings": { "en": [ { "level": 1, "text": "Configure scan data", "id": "configure-scan-data" }, { "level": 2, "text": "Understand the three constraint types", "id": "understand-the-three-constraint-types" }, { "level": 2, "text": "1. Open configuration and choose the coordinate frame", "id": "1-open-configuration-and-choose-the-coordinate-frame" }, { "level": 2, "text": "2. Add the first GCP", "id": "2-add-the-first-gcp" }, { "level": 3, "text": "Create the point", "id": "create-the-point" }, { "level": 3, "text": "Enter a name and coordinates", "id": "enter-a-name-and-coordinates" }, { "level": 3, "text": "Add observations in multiple frames", "id": "add-observations-in-multiple-frames" }, { "level": 2, "text": "3. Build a complete GCP coordinate skeleton", "id": "3-build-a-complete-gcp-coordinate-skeleton" }, { "level": 2, "text": "4. Add a Tie Point", "id": "4-add-a-tie-point" }, { "level": 2, "text": "5. Add a Scale Bar", "id": "5-add-a-scale-bar" }, { "level": 2, "text": "6. Pass the build-readiness check", "id": "6-pass-the-build-readiness-check" }, { "level": 2, "text": "Common questions", "id": "common-questions" }, { "level": 3, "text": "There are enough GCPs, but Build is still disabled", "id": "there-are-enough-gcps-but-build-is-still-disabled" }, { "level": 3, "text": "The same point is difficult to confirm in another frame", "id": "the-same-point-is-difficult-to-confirm-in-another-frame" }, { "level": 3, "text": "How many Tie Points should I add", "id": "how-many-tie-points-should-i-add" } ], "zh-Hans": [ { "level": 1, "text": "配置扫描数据", "id": "配置扫描数据" }, { "level": 2, "text": "先理解三类配置", "id": "先理解三类配置" }, { "level": 2, "text": "1. 打开配置并确定坐标系", "id": "1-打开配置并确定坐标系" }, { "level": 2, "text": "2. 添加第一个 GCP", "id": "2-添加第一个-gcp" }, { "level": 3, "text": "创建点", "id": "创建点" }, { "level": 3, "text": "填写名称和坐标", "id": "填写名称和坐标" }, { "level": 3, "text": "添加多帧观测", "id": "添加多帧观测" }, { "level": 2, "text": "3. 用 GCP 定义三维坐标系", "id": "3-用-gcp-定义三维坐标系" }, { "level": 2, "text": "4. 添加 Tie Point", "id": "4-添加-tie-point" }, { "level": 2, "text": "5. 添加 Scale Bar", "id": "5-添加-scale-bar" }, { "level": 2, "text": "6. 提交建图前检查", "id": "6-提交建图前检查" }, { "level": 2, "text": "常见问题", "id": "常见问题" }, { "level": 3, "text": "GCP 数量够了，Build 仍然不可用", "id": "gcp-数量够了-build-仍然不可用" }, { "level": 3, "text": "同一个点在其他帧中很难确认", "id": "同一个点在其他帧中很难确认" }, { "level": 3, "text": "应该添加多少 Tie Point", "id": "应该添加多少-tie-point" } ] } }, { "id": "mapping/panorama-camera-video/build", "slug": "mapping/panorama-camera-video/build", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/mapping/panorama-camera-video/build", "zh-Hans": "/tutorials/zh-Hans/mapping/panorama-camera-video/build" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/mapping/panorama-camera-video/build", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/mapping/panorama-camera-video/build" }, "previous": { "en": "/tutorials/en/mapping/panorama-camera-video/map-configurator", "zh-Hans": "/tutorials/zh-Hans/mapping/panorama-camera-video/map-configurator" }, "next": { "en": "/tutorials/en/mapping/mobile-3d-scanning/polycam", "zh-Hans": "/tutorials/zh-Hans/mapping/mobile-3d-scanning/polycam" }, "title": { "en": "Build a map from 360° video", "zh-Hans": "使用全景视频建图" }, "description": { "en": "After scan data and spatial constraints are configured, 01Spatial turns the 360° video into a spatial map for localization, content authoring, and AR delivery. The process runs in the cloud and continues even after you leave the page.", "zh-Hans": "当扫描数据、真实大小和坐标基准准备完成后，01Spatial 会将全景视频转化为可用于定位、内容编辑和 AR 发布的空间地图。整个过程在云端完成，关闭页面不会中断任务。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/mapping/panorama-camera-video/build.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/mapping/panorama-camera-video/build.md" }, "contentHash": { "en": "sha256:588080f561a866a2672562fbb4c78830c3571a74d7e6097b4eda476e2ceee103", "zh-Hans": "sha256:900195fea1535297f661b1222f2dda5f9e6ba417614f2ca1b6f4bb63179c0344" }, "headings": { "en": [ { "level": 1, "text": "Build a map from 360° video", "id": "build-a-map-from-360-video" }, { "level": 2, "text": "What happens during a build", "id": "what-happens-during-a-build" }, { "level": 2, "text": "Start the build", "id": "start-the-build" }, { "level": 2, "text": "Understand map states", "id": "understand-map-states" }, { "level": 2, "text": "Validate localization after Ready", "id": "validate-localization-after-ready" }, { "level": 2, "text": "Respond to failures", "id": "respond-to-failures" }, { "level": 3, "text": "Disconnected area", "id": "disconnected-area" }, { "level": 3, "text": "Insufficient image quality or coverage", "id": "insufficient-image-quality-or-coverage" }, { "level": 3, "text": "Abnormal GCP or scale residuals", "id": "abnormal-gcp-or-scale-residuals" }, { "level": 3, "text": "Build succeeds but field localization is unstable", "id": "build-succeeds-but-field-localization-is-unstable" }, { "level": 2, "text": "Rebuilds and source-video changes", "id": "rebuilds-and-source-video-changes" } ], "zh-Hans": [ { "level": 1, "text": "使用全景视频建图", "id": "使用全景视频建图" }, { "level": 2, "text": "建图过程中发生什么", "id": "建图过程中发生什么" }, { "level": 2, "text": "启动建图", "id": "启动建图" }, { "level": 2, "text": "理解地图状态", "id": "理解地图状态" }, { "level": 2, "text": "就绪后必须验证定位", "id": "就绪后必须验证定位" }, { "level": 2, "text": "失败时如何处理", "id": "失败时如何处理" }, { "level": 3, "text": "区域未连接", "id": "区域未连接" }, { "level": 3, "text": "画面质量或覆盖不足", "id": "画面质量或覆盖不足" }, { "level": 3, "text": "GCP 或 Scale Bar 误差过大", "id": "gcp-或-scale-bar-误差过大" }, { "level": 3, "text": "建图完成但现场定位不稳定", "id": "建图完成但现场定位不稳定" }, { "level": 2, "text": "重建与源视频变更", "id": "重建与源视频变更" } ] } }, { "id": "mapping/mobile-3d-scanning/polycam", "slug": "mapping/mobile-3d-scanning/polycam", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/mapping/mobile-3d-scanning/polycam", "zh-Hans": "/tutorials/zh-Hans/mapping/mobile-3d-scanning/polycam" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/mapping/mobile-3d-scanning/polycam", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/mapping/mobile-3d-scanning/polycam" }, "previous": { "en": "/tutorials/en/mapping/panorama-camera-video/build", "zh-Hans": "/tutorials/zh-Hans/mapping/panorama-camera-video/build" }, "next": { "en": "/tutorials/en/mapping/mobile-3d-scanning/kiri-engine", "zh-Hans": "/tutorials/zh-Hans/mapping/mobile-3d-scanning/kiri-engine" }, "title": { "en": "Scan with Polycam", "zh-Hans": "使用 Polycam 扫描" }, "description": { "en": "Polycam records both spatial imagery and device motion on a phone or tablet. 01Spatial builds a high-quality visual map from the complete Raw Data package and further refines the recorded camera trajectory. You do not need to configure GCPs manually, and a surface-model file alone is not sufficient.", "zh-Hans": "Polycam 可以在手机或平板上同时记录空间画面与设备的移动路径（相机轨迹）。01Spatial 使用完整的 Raw Data（原始数据） 数据包建立高质量视觉地图，并进一步优化这条轨迹。你不需要手工设置控制点，也不要只上传一个三维模型文件。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/mapping/mobile-3d-scanning/polycam.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/mapping/mobile-3d-scanning/polycam.md" }, "contentHash": { "en": "sha256:2a2267174f4de15b8383ba2c719712b08e0ac2b2cbd74c6cc87b8824cc7b96ba", "zh-Hans": "sha256:d40cbe4d852503b5ceecec57eca42558f2db9714cce7a3d900071bc47e5e9095" }, "headings": { "en": [ { "level": 1, "text": "Scan with Polycam", "id": "scan-with-polycam" }, { "level": 2, "text": "1. Confirm the device and output", "id": "1-confirm-the-device-and-output" }, { "level": 2, "text": "2. Enable Developer Mode before scanning", "id": "2-enable-developer-mode-before-scanning" }, { "level": 2, "text": "3. Prepare the space", "id": "3-prepare-the-space" }, { "level": 2, "text": "4. Scan in Space Mode", "id": "4-scan-in-space-mode" }, { "level": 3, "text": "Large spaces", "id": "large-spaces" }, { "level": 2, "text": "5. Check before finishing", "id": "5-check-before-finishing" }, { "level": 2, "text": "6. Export Raw Data", "id": "6-export-raw-data" }, { "level": 2, "text": "7. Upload to 01Spatial", "id": "7-upload-to-01spatial" }, { "level": 2, "text": "Validate after building", "id": "validate-after-building" } ], "zh-Hans": [ { "level": 1, "text": "使用 Polycam 扫描", "id": "使用-polycam-扫描" }, { "level": 2, "text": "1. 确认设备与输出", "id": "1-确认设备与输出" }, { "level": 2, "text": "2. 扫描前开启 Developer Mode", "id": "2-扫描前开启-developer-mode" }, { "level": 2, "text": "3. 准备空间", "id": "3-准备空间" }, { "level": 2, "text": "4. 在 Space Mode 中扫描", "id": "4-在-space-mode-中扫描" }, { "level": 3, "text": "大空间建议", "id": "大空间建议" }, { "level": 2, "text": "5. 完成前检查", "id": "5-完成前检查" }, { "level": 2, "text": "6. 导出 Raw Data", "id": "6-导出-raw-data" }, { "level": 2, "text": "7. 上传到 01Spatial", "id": "7-上传到-01spatial" }, { "level": 2, "text": "建图后验收", "id": "建图后验收" } ] } }, { "id": "mapping/mobile-3d-scanning/kiri-engine", "slug": "mapping/mobile-3d-scanning/kiri-engine", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/mapping/mobile-3d-scanning/kiri-engine", "zh-Hans": "/tutorials/zh-Hans/mapping/mobile-3d-scanning/kiri-engine" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/mapping/mobile-3d-scanning/kiri-engine", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/mapping/mobile-3d-scanning/kiri-engine" }, "previous": { "en": "/tutorials/en/mapping/mobile-3d-scanning/polycam", "zh-Hans": "/tutorials/zh-Hans/mapping/mobile-3d-scanning/polycam" }, "next": { "en": "/tutorials/en/mapping/lidar", "zh-Hans": "/tutorials/zh-Hans/mapping/lidar" }, "title": { "en": "Scan with KIRI Engine", "zh-Hans": "使用 KIRI Engine 扫描" }, "description": { "en": "KIRI Engine can record scene images, camera positions, and depth information on a LiDAR-equipped iPhone or iPad. 01Spatial builds a visual map from the complete Scene Scan Raw Data ZIP and further refines the camera trajectory recorded by KIRI Engine.", "zh-Hans": "KIRI Engine 可以在支持 LiDAR 的 iPhone 或 iPad 上记录空间画面、设备的移动路径（相机轨迹）和深度信息。01Spatial 使用 Scene Scan 的 Raw Data（原始数据）ZIP 建立视觉地图，并在建图过程中进一步优化这条轨迹。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/mapping/mobile-3d-scanning/kiri-engine.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/mapping/mobile-3d-scanning/kiri-engine.md" }, "contentHash": { "en": "sha256:85c42b1732b99cbc414d47d315b96beaa4f64493202d0951e5c7640eb3a1aa1f", "zh-Hans": "sha256:3743ad7917bb9ce3b02518e6160023f72d89d01742556e8886ef7ff087032793" }, "headings": { "en": [ { "level": 1, "text": "Scan with KIRI Engine", "id": "scan-with-kiri-engine" }, { "level": 2, "text": "1. Confirm the device and output", "id": "1-confirm-the-device-and-output" }, { "level": 2, "text": "2. Enable Developer Mode before scanning", "id": "2-enable-developer-mode-before-scanning" }, { "level": 2, "text": "3. Prepare the space", "id": "3-prepare-the-space" }, { "level": 2, "text": "4. Start a Scene Scan", "id": "4-start-a-scene-scan" }, { "level": 2, "text": "5. Scan the full route", "id": "5-scan-the-full-route" }, { "level": 2, "text": "6. Check before finishing", "id": "6-check-before-finishing" }, { "level": 2, "text": "7. Process on the device and export Raw Data", "id": "7-process-on-the-device-and-export-raw-data" }, { "level": 3, "text": "Finish the project with Local Processing", "id": "finish-the-project-with-local-processing" }, { "level": 3, "text": "Export the Raw Data ZIP", "id": "export-the-raw-data-zip" }, { "level": 2, "text": "8. Upload to 01Spatial", "id": "8-upload-to-01spatial" }, { "level": 2, "text": "Validate after building", "id": "validate-after-building" } ], "zh-Hans": [ { "level": 1, "text": "使用 KIRI Engine 扫描", "id": "使用-kiri-engine-扫描" }, { "level": 2, "text": "1. 确认设备与输出", "id": "1-确认设备与输出" }, { "level": 2, "text": "2. 扫描前开启 Developer Mode", "id": "2-扫描前开启-developer-mode" }, { "level": 2, "text": "3. 准备空间", "id": "3-准备空间" }, { "level": 2, "text": "4. 开始 Scene Scan", "id": "4-开始-scene-scan" }, { "level": 2, "text": "5. 扫描完整路线", "id": "5-扫描完整路线" }, { "level": 2, "text": "6. 完成前检查", "id": "6-完成前检查" }, { "level": 2, "text": "7. 在设备上处理并导出 Raw Data", "id": "7-在设备上处理并导出-raw-data" }, { "level": 3, "text": "使用 Local Processing 完成项目", "id": "使用-local-processing-完成项目" }, { "level": 3, "text": "导出 Raw Data ZIP", "id": "导出-raw-data-zip" }, { "level": 2, "text": "8. 上传到 01Spatial", "id": "8-上传到-01spatial" }, { "level": 2, "text": "建图后验收", "id": "建图后验收" } ] } }, { "id": "mapping/lidar", "slug": "mapping/lidar", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/mapping/lidar", "zh-Hans": "/tutorials/zh-Hans/mapping/lidar" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/mapping/lidar", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/mapping/lidar" }, "previous": { "en": "/tutorials/en/mapping/mobile-3d-scanning/kiri-engine", "zh-Hans": "/tutorials/zh-Hans/mapping/mobile-3d-scanning/kiri-engine" }, "next": { "en": "/tutorials/en/mapping/lidar/matterport", "zh-Hans": "/tutorials/zh-Hans/mapping/lidar/matterport" }, "title": { "en": "LiDAR scanning overview", "zh-Hans": "LiDAR 扫描概述" }, "description": { "en": "A valid input must include visual panoramas, camera positions and orientations, and metric 3D geometry. A point cloud without imagery cannot produce a visual-localization map. Register and clean the project in the vendor software before export.", "zh-Hans": "与只依赖普通视频的扫描相比，LiDAR 数据通常具备更稳定的尺度、更完整的几何和更可靠的设备轨迹。它尤其适合：" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/mapping/lidar.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/mapping/lidar.md" }, "contentHash": { "en": "sha256:fd1f43a9de11680b8fa3ca08b4674f28e57934b0b486520387354236fa9ce7f2", "zh-Hans": "sha256:46ead42de835bcb17f9e753bfaad257ef315b45795a0acfe537ca188b4e16a9c" }, "headings": { "en": [ { "level": 1, "text": "LiDAR scanning overview", "id": "lidar-scanning-overview" }, { "level": 2, "text": "Required data", "id": "required-data" }, { "level": 2, "text": "No additional spatial-reference configuration", "id": "no-additional-spatial-reference-configuration" }, { "level": 2, "text": "Capture principles", "id": "capture-principles" }, { "level": 2, "text": "Upload", "id": "upload" } ], "zh-Hans": [ { "level": 1, "text": "LiDAR 扫描概述", "id": "lidar-扫描概述" }, { "level": 2, "text": "为什么优先选择 LiDAR", "id": "为什么优先选择-lidar" }, { "level": 2, "text": "01Spatial 需要什么数据", "id": "01spatial-需要什么数据" }, { "level": 2, "text": "不需要额外配置空间基准", "id": "不需要额外配置空间基准" }, { "level": 2, "text": "通用采集原则", "id": "通用采集原则" }, { "level": 2, "text": "上传方式", "id": "上传方式" }, { "level": 2, "text": "选择设备指南", "id": "选择设备指南" } ] } }, { "id": "mapping/lidar/matterport", "slug": "mapping/lidar/matterport", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/mapping/lidar/matterport", "zh-Hans": "/tutorials/zh-Hans/mapping/lidar/matterport" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/mapping/lidar/matterport", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/mapping/lidar/matterport" }, "previous": { "en": "/tutorials/en/mapping/lidar", "zh-Hans": "/tutorials/zh-Hans/mapping/lidar" }, "next": { "en": "/tutorials/en/mapping/lidar/faro", "zh-Hans": "/tutorials/zh-Hans/mapping/lidar/faro" }, "title": { "en": "Scan with Matterport", "zh-Hans": "使用 Matterport 扫描" }, "description": { "en": "01Spatial converts a self-contained Matterport E57—scan panoramas, camera poses, and 3D data—into a localizable spatial map.", "zh-Hans": "01Spatial 可以直接读取 Matterport 导出的自包含 E57。E57 是扫描设备常用的交换文件，可以在一个文件中保存扫描站图像、位置和三维点云；01Spatial 会把这些数据转换为可定位的空间地图。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/mapping/lidar/matterport.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/mapping/lidar/matterport.md" }, "contentHash": { "en": "sha256:24b22a86e02ac23240a92812f5cfa1786489025b36a6a93568bb449a0d699a90", "zh-Hans": "sha256:131cb10c77ebc85c75e7396b93f8bbcd1c099ef0f0c1464df9fb6108fb577131" }, "headings": { "en": [ { "level": 1, "text": "Scan with Matterport", "id": "scan-with-matterport" }, { "level": 2, "text": "Capture", "id": "capture" }, { "level": 2, "text": "Export", "id": "export" }, { "level": 2, "text": "Upload and build", "id": "upload-and-build" } ], "zh-Hans": [ { "level": 1, "text": "使用 Matterport 扫描", "id": "使用-matterport-扫描" }, { "level": 2, "text": "采集", "id": "采集" }, { "level": 2, "text": "导出", "id": "导出" }, { "level": 2, "text": "上传与建图", "id": "上传与建图" } ] } }, { "id": "mapping/lidar/faro", "slug": "mapping/lidar/faro", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/mapping/lidar/faro", "zh-Hans": "/tutorials/zh-Hans/mapping/lidar/faro" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/mapping/lidar/faro", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/mapping/lidar/faro" }, "previous": { "en": "/tutorials/en/mapping/lidar/matterport", "zh-Hans": "/tutorials/zh-Hans/mapping/lidar/matterport" }, "next": { "en": "/tutorials/en/mapping/lidar/navvis", "zh-Hans": "/tutorials/zh-Hans/mapping/lidar/navvis" }, "title": { "en": "Scan with FARO", "zh-Hans": "使用 FARO 扫描" }, "description": { "en": "FARO projects commonly contain multiple fixed stations. 01Spatial accepts a ZIP with one E57 per station and normalizes them into one spatial dataset.", "zh-Hans": "FARO 静态扫描项目通常包含多个扫描站。01Spatial 接受“每个扫描站一个 E57”的 ZIP，并在建图前把它们统一为同一空间数据集。E57 是扫描设备常用的交换文件，可保存站点图像、位置和三维点云。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/mapping/lidar/faro.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/mapping/lidar/faro.md" }, "contentHash": { "en": "sha256:f2d5f458d88b829baf409b226080774f46c247daf3aaa1e5918fc5a2b5d53955", "zh-Hans": "sha256:20ffda3faf4a1f77d6e641ca41e4f7245dfa48b292ee8c37b111a6e68f8eeeac" }, "headings": { "en": [ { "level": 1, "text": "Scan with FARO", "id": "scan-with-faro" }, { "level": 2, "text": "Capture and register", "id": "capture-and-register" }, { "level": 2, "text": "Package", "id": "package" }, { "level": 2, "text": "Upload and validate", "id": "upload-and-validate" } ], "zh-Hans": [ { "level": 1, "text": "使用 FARO 扫描", "id": "使用-faro-扫描" }, { "level": 2, "text": "采集与注册", "id": "采集与注册" }, { "level": 2, "text": "打包", "id": "打包" }, { "level": 2, "text": "上传与验收", "id": "上传与验收" } ] } }, { "id": "mapping/lidar/navvis", "slug": "mapping/lidar/navvis", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/mapping/lidar/navvis", "zh-Hans": "/tutorials/zh-Hans/mapping/lidar/navvis" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/mapping/lidar/navvis", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/mapping/lidar/navvis" }, "previous": { "en": "/tutorials/en/mapping/lidar/faro", "zh-Hans": "/tutorials/zh-Hans/mapping/lidar/faro" }, "next": { "en": "/tutorials/en/mapping/lidar/leica-rtc", "zh-Hans": "/tutorials/zh-Hans/mapping/lidar/leica-rtc" }, "title": { "en": "Scan with NavVis", "zh-Hans": "使用 NavVis 扫描" }, "description": { "en": "NavVis supports continuous capture over large indoor spaces. 01Spatial reads spherical imagery, poses, and point-cloud data from one self-contained E57.", "zh-Hans": "NavVis 适合连续采集大范围室内空间。01Spatial 从一个自包含 E57 中读取球面全景图、相机位置和点云，并生成视觉定位地图。E57 是扫描设备常用的交换文件，可在一个文件中保存图像、位置和三维点云。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/mapping/lidar/navvis.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/mapping/lidar/navvis.md" }, "contentHash": { "en": "sha256:2ebf2a1811243196bc8170e4925401894a9097052e4bc7f12b6752e9fbf7a232", "zh-Hans": "sha256:c722464b313072d251faef5588f43d4ed4fb12941f8ce6849191129e3999eb93" }, "headings": { "en": [ { "level": 1, "text": "Scan with NavVis", "id": "scan-with-navvis" }, { "level": 2, "text": "Capture", "id": "capture" }, { "level": 2, "text": "Export and upload", "id": "export-and-upload" }, { "level": 2, "text": "Validate", "id": "validate" } ], "zh-Hans": [ { "level": 1, "text": "使用 NavVis 扫描", "id": "使用-navvis-扫描" }, { "level": 2, "text": "采集", "id": "采集" }, { "level": 2, "text": "导出与上传", "id": "导出与上传" }, { "level": 2, "text": "Ready 后检查", "id": "ready-后检查" } ] } }, { "id": "mapping/lidar/leica-rtc", "slug": "mapping/lidar/leica-rtc", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/mapping/lidar/leica-rtc", "zh-Hans": "/tutorials/zh-Hans/mapping/lidar/leica-rtc" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/mapping/lidar/leica-rtc", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/mapping/lidar/leica-rtc" }, "previous": { "en": "/tutorials/en/mapping/lidar/navvis", "zh-Hans": "/tutorials/zh-Hans/mapping/lidar/navvis" }, "next": { "en": "/tutorials/en/mapping/lidar/hexagon-realslam", "zh-Hans": "/tutorials/zh-Hans/mapping/lidar/hexagon-realslam" }, "title": { "en": "Scan with Leica RTC", "zh-Hans": "使用 Leica RTC 扫描" }, "description": { "en": "The Leica path supports Leica RTC series projects that export a self-contained E57. 01Spatial converts each station's cube images into a panorama while preserving station poses and 3D data.", "zh-Hans": "01Spatial 的 Leica 路径面向 Leica RTC 系列 等能够导出自包含 E57 的静态扫描项目。E57 是扫描设备常用的交换文件；系统会把其中每个扫描站的立方体图像合成为全景图，并保留站点位置与三维数据。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/mapping/lidar/leica-rtc.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/mapping/lidar/leica-rtc.md" }, "contentHash": { "en": "sha256:bd20182f50f1af62f293b64051cae01f7e3dc6c6df81127fae3af8c2cf84f0d2", "zh-Hans": "sha256:42cf50cf0af6835bc812aed3f5b9bcd20dee0994914b1164976016f7aacb1648" }, "headings": { "en": [ { "level": 1, "text": "Scan with Leica RTC", "id": "scan-with-leica-rtc" }, { "level": 2, "text": "Capture and register", "id": "capture-and-register" }, { "level": 2, "text": "Export and upload", "id": "export-and-upload" } ], "zh-Hans": [ { "level": 1, "text": "使用 Leica RTC 扫描", "id": "使用-leica-rtc-扫描" }, { "level": 2, "text": "采集与注册", "id": "采集与注册" }, { "level": 2, "text": "导出", "id": "导出" }, { "level": 2, "text": "上传与检查", "id": "上传与检查" } ] } }, { "id": "mapping/lidar/hexagon-realslam", "slug": "mapping/lidar/hexagon-realslam", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/mapping/lidar/hexagon-realslam", "zh-Hans": "/tutorials/zh-Hans/mapping/lidar/hexagon-realslam" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/mapping/lidar/hexagon-realslam", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/mapping/lidar/hexagon-realslam" }, "previous": { "en": "/tutorials/en/mapping/lidar/leica-rtc", "zh-Hans": "/tutorials/zh-Hans/mapping/lidar/leica-rtc" }, "next": { "en": "/tutorials/en/mapping/lidar/xgrids", "zh-Hans": "/tutorials/zh-Hans/mapping/lidar/xgrids" }, "title": { "en": "Scan with Hexagon RealSLAM", "zh-Hans": "使用 Hexagon RealSLAM 扫描" }, "description": { "en": "Hexagon RealSLAM supports mobile capture across large spaces. 01Spatial reads panoramas, poses, and point-cloud data from E57 and produces localization assets through the same quality gates.", "zh-Hans": "Hexagon RealSLAM 适合移动式大范围采集。01Spatial 读取 E57 中的全景图、相机位置和点云，并使用同一套地图质量检查生成定位资产。E57 是扫描设备常用的交换文件，可在一个文件中保存图像、位置和三维点云。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/mapping/lidar/hexagon-realslam.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/mapping/lidar/hexagon-realslam.md" }, "contentHash": { "en": "sha256:cafc314a92c8a778b75940f0b9bf4b4fad238d47d47f68159a9a5546e40f5046", "zh-Hans": "sha256:3576d330667beb1bb1031ee3d904d533138e351f98fa5e4360c6cb7093dac4fd" }, "headings": { "en": [ { "level": 1, "text": "Scan with Hexagon RealSLAM", "id": "scan-with-hexagon-realslam" } ], "zh-Hans": [ { "level": 1, "text": "使用 Hexagon RealSLAM 扫描", "id": "使用-hexagon-realslam-扫描" }, { "level": 2, "text": "采集", "id": "采集" }, { "level": 2, "text": "导出与上传", "id": "导出与上传" }, { "level": 2, "text": "验收", "id": "验收" } ] } }, { "id": "mapping/lidar/xgrids", "slug": "mapping/lidar/xgrids", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/mapping/lidar/xgrids", "zh-Hans": "/tutorials/zh-Hans/mapping/lidar/xgrids" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/mapping/lidar/xgrids", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/mapping/lidar/xgrids" }, "previous": { "en": "/tutorials/en/mapping/lidar/hexagon-realslam", "zh-Hans": "/tutorials/zh-Hans/mapping/lidar/hexagon-realslam" }, "next": { "en": "/tutorials/en/mapping/lidar/fjd", "zh-Hans": "/tutorials/zh-Hans/mapping/lidar/fjd" }, "title": { "en": "Scan with XGRIDS", "zh-Hans": "使用 XGRIDS 扫描" }, "description": { "en": "01Spatial supports exported data from all XGRIDS handheld scanners, including K1, K2, and L2, and reads spherical images, poses, and point clouds from E57.", "zh-Hans": "01Spatial 支持 XGRIDS K1、K2、L2 等各类手持式扫描仪的导出数据，并从项目 E57 中读取球面图像、相机位置和点云，适合移动式扫描形成的大范围室内地图。E57 是扫描设备常用的交换文件，可在一个文件中保存图像、位置和三维点云。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/mapping/lidar/xgrids.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/mapping/lidar/xgrids.md" }, "contentHash": { "en": "sha256:cdd6983df8b0ab83fa57b422068071c61cabf9412a36dd4d8dc57ac89366f516", "zh-Hans": "sha256:6af25e78092f88b7eb98bdd787cded87563a4dbb17d90155fb23386ee2d960c4" }, "headings": { "en": [ { "level": 1, "text": "Scan with XGRIDS", "id": "scan-with-xgrids" } ], "zh-Hans": [ { "level": 1, "text": "使用 XGRIDS 扫描", "id": "使用-xgrids-扫描" }, { "level": 2, "text": "采集与导出", "id": "采集与导出" }, { "level": 2, "text": "上传与验收", "id": "上传与验收" } ] } }, { "id": "mapping/lidar/fjd", "slug": "mapping/lidar/fjd", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/mapping/lidar/fjd", "zh-Hans": "/tutorials/zh-Hans/mapping/lidar/fjd" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/mapping/lidar/fjd", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/mapping/lidar/fjd" }, "previous": { "en": "/tutorials/en/mapping/lidar/xgrids", "zh-Hans": "/tutorials/zh-Hans/mapping/lidar/xgrids" }, "next": { "en": "/tutorials/en/mapping/lidar/chcnav", "zh-Hans": "/tutorials/zh-Hans/mapping/lidar/chcnav" }, "title": { "en": "Scan with FJD", "zh-Hans": "使用 FJD 扫描" }, "description": { "en": "An FJD input uses panoramas plus pano-pose-info.csv, with an optional E57 point cloud. 01Spatial validates and normalizes them as one map input.", "zh-Hans": "FJD 项目使用全景图和 pano-pose-info.csv 描述扫描轨迹，并可附带 E57 点云。E57 是扫描设备常用的交换文件；在本流程中，它用于提供可选的三维点云。01Spatial 会在上传时校验这些文件，并将它们统一为一个地图输入。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/mapping/lidar/fjd.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/mapping/lidar/fjd.md" }, "contentHash": { "en": "sha256:f91e8eca2bad338cc12199622fbbd2d1214349d9ee5f863b875eeaa4f5717393", "zh-Hans": "sha256:d0852f79609e179e7915737bb06ca4cb130ddab6f412812d9ef076b53f575d07" }, "headings": { "en": [ { "level": 1, "text": "Scan with FJD", "id": "scan-with-fjd" } ], "zh-Hans": [ { "level": 1, "text": "使用 FJD 扫描", "id": "使用-fjd-扫描" }, { "level": 2, "text": "准备导出包", "id": "准备导出包" }, { "level": 2, "text": "采集与上传", "id": "采集与上传" } ] } }, { "id": "mapping/lidar/chcnav", "slug": "mapping/lidar/chcnav", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/mapping/lidar/chcnav", "zh-Hans": "/tutorials/zh-Hans/mapping/lidar/chcnav" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/mapping/lidar/chcnav", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/mapping/lidar/chcnav" }, "previous": { "en": "/tutorials/en/mapping/lidar/fjd", "zh-Hans": "/tutorials/zh-Hans/mapping/lidar/fjd" }, "next": { "en": "/tutorials/en/maps/manage", "zh-Hans": "/tutorials/zh-Hans/maps/manage" }, "title": { "en": "Scan with CHCNAV", "zh-Hans": "使用 CHCNAV 扫描" }, "description": { "en": "A CHCNAV input contains panoramas, one text pose table, and an optional LAS point cloud. Portal matches image filenames against pose records before mapping.", "zh-Hans": "CHCNAV 输入由全景图、一个记录每张图片位置和方向的文本表，以及可选的 LAS 点云文件组成。Portal 会核对图像文件名与位置记录，防止错配的数据进入建图。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/mapping/lidar/chcnav.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/mapping/lidar/chcnav.md" }, "contentHash": { "en": "sha256:80354df0cc9768ba1c6ea7775ad595ca9e421e0eb21a9f405e04776be697f902", "zh-Hans": "sha256:0c9077e14e5385f161c0c4fbbabd5d8f74e276b5e517f15abaefbd66fde98e0a" }, "headings": { "en": [ { "level": 1, "text": "Scan with CHCNAV", "id": "scan-with-chcnav" } ], "zh-Hans": [ { "level": 1, "text": "使用 CHCNAV 扫描", "id": "使用-chcnav-扫描" }, { "level": 2, "text": "准备文件", "id": "准备文件" }, { "level": 2, "text": "上传", "id": "上传" }, { "level": 2, "text": "验收", "id": "验收" } ] } }, { "id": "maps/manage", "slug": "maps/manage", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/maps/manage", "zh-Hans": "/tutorials/zh-Hans/maps/manage" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/maps/manage", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/maps/manage" }, "previous": { "en": "/tutorials/en/mapping/lidar/chcnav", "zh-Hans": "/tutorials/zh-Hans/mapping/lidar/chcnav" }, "next": { "en": "/tutorials/en/maps/explore", "zh-Hans": "/tutorials/zh-Hans/maps/explore" }, "title": { "en": "Manage maps", "zh-Hans": "管理地图" }, "description": { "en": "Spatial Maps is the control center for creating maps, uploading scan data, monitoring builds, and opening, moving, or transferring completed maps.", "zh-Hans": "Spatial Maps 是地图的管理入口。你可以在这里创建地图、上传扫描数据、查看建图进度，并在地图就绪后打开 Space Studio、移动或转让地图。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/maps/manage.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/maps/manage.md" }, "contentHash": { "en": "sha256:a681a1a8e2d0722164356dd2f52f1f4a3f14119af59f92b942d9f14b4bbd971d", "zh-Hans": "sha256:35a184f833fb937a1119dfd9ab0b866bb64696a04dbe55e6c1c092cbf83f71d7" }, "headings": { "en": [ { "level": 1, "text": "Manage maps", "id": "manage-maps" }, { "level": 2, "text": "Create a map", "id": "create-a-map" }, { "level": 2, "text": "Understand a map card", "id": "understand-a-map-card" }, { "level": 3, "text": "Created", "id": "created" }, { "level": 3, "text": "Parsing and configuration", "id": "parsing-and-configuration" }, { "level": 3, "text": "Queue and build", "id": "queue-and-build" }, { "level": 3, "text": "Ready", "id": "ready" }, { "level": 2, "text": "Move within your account", "id": "move-within-your-account" }, { "level": 2, "text": "Transfer ownership", "id": "transfer-ownership" }, { "level": 3, "text": "Sender", "id": "sender" }, { "level": 3, "text": "Recipient", "id": "recipient" }, { "level": 2, "text": "Next", "id": "next" } ], "zh-Hans": [ { "level": 1, "text": "管理地图", "id": "管理地图" }, { "level": 2, "text": "新建地图", "id": "新建地图" }, { "level": 2, "text": "读懂地图卡片", "id": "读懂地图卡片" }, { "level": 3, "text": "新建状态", "id": "新建状态" }, { "level": 3, "text": "解析与配置状态", "id": "解析与配置状态" }, { "level": 3, "text": "排队与建图状态", "id": "排队与建图状态" }, { "level": 3, "text": "Ready 状态", "id": "ready-状态" }, { "level": 2, "text": "Move：在自己的 Project 之间整理地图", "id": "move-在自己的-project-之间整理地图" }, { "level": 2, "text": "Transfer：把地图转让给另一个用户", "id": "transfer-把地图转让给另一个用户" }, { "level": 3, "text": "发送者会看到什么", "id": "发送者会看到什么" }, { "level": 3, "text": "接收者会看到什么", "id": "接收者会看到什么" }, { "level": 2, "text": "下一步", "id": "下一步" } ] } }, { "id": "maps/explore", "slug": "maps/explore", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/maps/explore", "zh-Hans": "/tutorials/zh-Hans/maps/explore" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/maps/explore", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/maps/explore" }, "previous": { "en": "/tutorials/en/maps/manage", "zh-Hans": "/tutorials/zh-Hans/maps/manage" }, "next": { "en": "/tutorials/en/maps/add-content", "zh-Hans": "/tutorials/zh-Hans/maps/add-content" }, "title": { "en": "Explore a map", "zh-Hans": "探索地图" }, "description": { "en": "The left Map Panel in Space Studio is for inspecting the map itself: points, mesh, origin, and mapping-camera poses. For query-image validation, continue to Run a localization test in Space Studio.", "zh-Hans": "Space Studio 左侧的地图面板用于查看地图本身，包括点云、网格、坐标原点，以及建图时相机的位置和方向。本篇只介绍地图浏览。定位验收请阅读使用 Space Studio 执行定位测试。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/maps/explore.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/maps/explore.md" }, "contentHash": { "en": "sha256:26ecd904553793aeab828178d31200233f1c624e1fddc9d42344cdecba5bfe85", "zh-Hans": "sha256:b1f492cf98edf4f56537c2e955473e91c4abebd037a7d80022fd026b79d21dd3" }, "headings": { "en": [ { "level": 1, "text": "Explore a map", "id": "explore-a-map" }, { "level": 2, "text": "Open the map", "id": "open-the-map" }, { "level": 2, "text": "MAP display controls", "id": "map-display-controls" }, { "level": 2, "text": "Origin", "id": "origin" }, { "level": 2, "text": "POSES", "id": "poses" }, { "level": 2, "text": "Panels", "id": "panels" }, { "level": 2, "text": "Review order", "id": "review-order" } ], "zh-Hans": [ { "level": 1, "text": "探索地图", "id": "探索地图" }, { "level": 2, "text": "打开地图", "id": "打开地图" }, { "level": 2, "text": "地图：控制显示内容", "id": "地图-控制显示内容" }, { "level": 2, "text": "原点：自定义空间坐标系", "id": "原点-自定义空间坐标系" }, { "level": 3, "text": "设置自定义原点", "id": "设置自定义原点" }, { "level": 2, "text": "位姿：检查建图视角", "id": "位姿-检查建图视角" }, { "level": 2, "text": "收起与调整面板", "id": "收起与调整面板" }, { "level": 2, "text": "建议的验收顺序", "id": "建议的验收顺序" } ] } }, { "id": "maps/add-content", "slug": "maps/add-content", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/maps/add-content", "zh-Hans": "/tutorials/zh-Hans/maps/add-content" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/maps/add-content", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/maps/add-content" }, "previous": { "en": "/tutorials/en/maps/explore", "zh-Hans": "/tutorials/zh-Hans/maps/explore" }, "next": { "en": "/tutorials/en/localization/space-studio-test", "zh-Hans": "/tutorials/zh-Hans/localization/space-studio-test" }, "title": { "en": "Add content", "zh-Hans": "添加内容" }, "description": { "en": "The right Content Panel in Space Studio places models, primitives, lights, and annotations in map coordinates. The map describes the physical space; Content describes the digital experience anchored to it.", "zh-Hans": "Space Studio 右侧的 Content Panel 用于把 3D 模型、基础几何、灯光和标注放入地图坐标系。地图负责描述真实空间，Content 描述用户将在这个空间中看到和交互的数字内容。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/maps/add-content.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/maps/add-content.md" }, "contentHash": { "en": "sha256:5dca7ac9952f8a2bf59c9098900b7b46505569eca3ab4572ca7286a03c2f0d63", "zh-Hans": "sha256:1265a0992b3610cb0ae0031ac6f786947fb50833ace9adb520ab30fdae1c0b17" }, "headings": { "en": [ { "level": 1, "text": "Add content", "id": "add-content" }, { "level": 2, "text": "Open the panel", "id": "open-the-panel" }, { "level": 2, "text": "Add objects", "id": "add-objects" }, { "level": 2, "text": "Place and edit", "id": "place-and-edit" }, { "level": 2, "text": "Scene management", "id": "scene-management" }, { "level": 2, "text": "Save and verify", "id": "save-and-verify" } ], "zh-Hans": [ { "level": 1, "text": "添加内容", "id": "添加内容" }, { "level": 2, "text": "打开 Content Panel", "id": "打开-content-panel" }, { "level": 2, "text": "添加对象", "id": "添加对象" }, { "level": 2, "text": "放置与编辑", "id": "放置与编辑" }, { "level": 2, "text": "管理 Scene", "id": "管理-scene" }, { "level": 2, "text": "保存", "id": "保存" } ] } }, { "id": "localization/space-studio-test", "slug": "localization/space-studio-test", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/localization/space-studio-test", "zh-Hans": "/tutorials/zh-Hans/localization/space-studio-test" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/localization/space-studio-test", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/localization/space-studio-test" }, "previous": { "en": "/tutorials/en/maps/add-content", "zh-Hans": "/tutorials/zh-Hans/maps/add-content" }, "next": { "en": "/tutorials/en/localization/launch-ar/android-webxr", "zh-Hans": "/tutorials/zh-Hans/localization/launch-ar/android-webxr" }, "title": { "en": "Run a localization test in Space Studio", "zh-Hans": "使用 Space Studio 执行定位测试" }, "description": { "en": "Use Space Studio to validate a ready map with representative camera images before integrating the localization API into an application. The test runs the same production localization service and visualizes each returned pose directly against the map.", "zh-Hans": "在应用接入定位 API 之前，可以先用 Space Studio 和现场测试照片验证已就绪地图。测试使用与 API 相同的定位服务，并将每次定位得到的相机位置和朝向直接显示在地图中。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/localization/space-studio-test.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/localization/space-studio-test.md" }, "contentHash": { "en": "sha256:1214c94b81494f7ce044a58a70600d169cd83d9769e46c091cc6f33168203b01", "zh-Hans": "sha256:cc46e28f8d5d5ce8b0de610c4ebdabf591241b1aa2cad9ee54d4e4582302a70d" }, "headings": { "en": [ { "level": 1, "text": "Run a localization test in Space Studio", "id": "run-a-localization-test-in-space-studio" }, { "level": 2, "text": "Before you start", "id": "before-you-start" }, { "level": 2, "text": "1. Open the map in Space Studio", "id": "1-open-the-map-in-space-studio" }, { "level": 2, "text": "2. Switch to Localization", "id": "2-switch-to-localization" }, { "level": 2, "text": "3. Add representative images", "id": "3-add-representative-images" }, { "level": 2, "text": "4. Enter camera intrinsics", "id": "4-enter-camera-intrinsics" }, { "level": 2, "text": "5. Run and inspect the results", "id": "5-run-and-inspect-the-results" }, { "level": 2, "text": "6. Decide whether the map is ready", "id": "6-decide-whether-the-map-is-ready" } ], "zh-Hans": [ { "level": 1, "text": "使用 Space Studio 执行定位测试", "id": "使用-space-studio-执行定位测试" }, { "level": 2, "text": "开始前需要准备", "id": "开始前需要准备" }, { "level": 2, "text": "1. 在 Space Studio 中打开地图", "id": "1-在-space-studio-中打开地图" }, { "level": 2, "text": "2. 切换到定位模式", "id": "2-切换到定位模式" }, { "level": 2, "text": "3. 添加覆盖实际场景的测试照片", "id": "3-添加覆盖实际场景的测试照片" }, { "level": 2, "text": "4. 输入相机内参", "id": "4-输入相机内参" }, { "level": 2, "text": "5. 运行并检查结果", "id": "5-运行并检查结果" }, { "level": 2, "text": "6. 判断地图是否可以使用", "id": "6-判断地图是否可以使用" } ] } }, { "id": "localization/launch-ar/android-webxr", "slug": "localization/launch-ar/android-webxr", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/localization/launch-ar/android-webxr", "zh-Hans": "/tutorials/zh-Hans/localization/launch-ar/android-webxr" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/localization/launch-ar/android-webxr", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/localization/launch-ar/android-webxr" }, "previous": { "en": "/tutorials/en/localization/space-studio-test", "zh-Hans": "/tutorials/zh-Hans/localization/space-studio-test" }, "next": { "en": "/tutorials/en/localization/launch-ar/ios-app-clip", "zh-Hans": "/tutorials/zh-Hans/localization/launch-ar/ios-app-clip" }, "title": { "en": "Launch AR on Android", "zh-Hans": "在 Android 设备开启 AR" }, "description": { "en": "The Android client uses Chrome WebXR and on-device ARCore, so no separate app is required. Space Studio generates an AR link for the current map and Content.", "zh-Hans": "01Spatial 的 Android 客户端使用 Chrome 的 WebXR 能力和设备上的 ARCore，不需要安装独立 App。Space Studio 会为当前地图和 Content 生成可直接打开的 AR 链接。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/localization/launch-ar/android-webxr.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/localization/launch-ar/android-webxr.md" }, "contentHash": { "en": "sha256:1d0949273d211871080ef30392002f87344902f9bdbdf7b39120647bc2418c35", "zh-Hans": "sha256:006c94f1b16e906eda5f3f38f5aaaab112c26871fd708a6a09283a4f6db440a4" }, "headings": { "en": [ { "level": 1, "text": "Launch AR on Android", "id": "launch-ar-on-android" } ], "zh-Hans": [ { "level": 1, "text": "在 Android 设备开启 AR", "id": "在-android-设备开启-ar" }, { "level": 2, "text": "设备要求", "id": "设备要求" }, { "level": 2, "text": "从 Space Studio 启动", "id": "从-space-studio-启动" }, { "level": 2, "text": "验收", "id": "验收" } ] } }, { "id": "localization/launch-ar/ios-app-clip", "slug": "localization/launch-ar/ios-app-clip", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/localization/launch-ar/ios-app-clip", "zh-Hans": "/tutorials/zh-Hans/localization/launch-ar/ios-app-clip" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/localization/launch-ar/ios-app-clip", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/localization/launch-ar/ios-app-clip" }, "previous": { "en": "/tutorials/en/localization/launch-ar/android-webxr", "zh-Hans": "/tutorials/zh-Hans/localization/launch-ar/android-webxr" }, "next": { "en": "/tutorials/en/localization/launch-ar/wechat-mini-program", "zh-Hans": "/tutorials/zh-Hans/localization/launch-ar/wechat-mini-program" }, "title": { "en": "Launch AR on iOS", "zh-Hans": "在 iOS 设备开启 AR" }, "description": { "en": "01Spatial uses an App Clip on iPhone. Scanning the QR code launches a lightweight ARKit client without requiring the full app, and loads the current map's web Content.", "zh-Hans": "iPhone 上的 01Spatial AR 体验通过 App Clip 启动。用户扫描二维码后无需先安装完整 App；App Clip 使用 ARKit 跟踪设备，并加载当前地图的 Web 内容。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/localization/launch-ar/ios-app-clip.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/localization/launch-ar/ios-app-clip.md" }, "contentHash": { "en": "sha256:43b350a164f2560a809e2568b37c56627e9e2aba457ac4bb9cafe6100fe0a49e", "zh-Hans": "sha256:112fe59e62e2664e1200ed38c837054f7ba45c87762314cdac3206ed9e2ccbeb" }, "headings": { "en": [ { "level": 1, "text": "Launch AR on iOS", "id": "launch-ar-on-ios" } ], "zh-Hans": [ { "level": 1, "text": "在 iOS 设备开启 AR", "id": "在-ios-设备开启-ar" }, { "level": 2, "text": "设备要求", "id": "设备要求" }, { "level": 2, "text": "启动", "id": "启动" }, { "level": 2, "text": "验收与排查", "id": "验收与排查" } ] } }, { "id": "localization/launch-ar/wechat-mini-program", "slug": "localization/launch-ar/wechat-mini-program", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/localization/launch-ar/wechat-mini-program", "zh-Hans": "/tutorials/zh-Hans/localization/launch-ar/wechat-mini-program" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/localization/launch-ar/wechat-mini-program", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/localization/launch-ar/wechat-mini-program" }, "previous": { "en": "/tutorials/en/localization/launch-ar/ios-app-clip", "zh-Hans": "/tutorials/zh-Hans/localization/launch-ar/ios-app-clip" }, "next": { "en": "/tutorials/en/localization/localization-api", "zh-Hans": "/tutorials/zh-Hans/localization/localization-api" }, "title": { "en": "Launch AR in WeChat", "zh-Hans": "在微信小程序开启 AR" }, "description": { "en": "The WeChat Mini Program entry is intended for users in mainland China. Space Studio asks the server to generate a Mini Program code for the current map.", "zh-Hans": "微信小程序入口适合中国大陆用户。Space Studio 会通过服务器生成当前地图的小程序码，用户用微信扫码后直接进入对应的 AR 场景。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/localization/launch-ar/wechat-mini-program.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/localization/launch-ar/wechat-mini-program.md" }, "contentHash": { "en": "sha256:d5ff60396caba262706c605948a87c52145f694bcd8ccaeff31f1cc806993fa9", "zh-Hans": "sha256:ca59b667cd9e5fc3cf4090343385f3e764e2f78cd2a365c550325f3d95966632" }, "headings": { "en": [ { "level": 1, "text": "Launch AR in WeChat", "id": "launch-ar-in-wechat" } ], "zh-Hans": [ { "level": 1, "text": "在微信小程序开启 AR", "id": "在微信小程序开启-ar" }, { "level": 2, "text": "启动", "id": "启动" }, { "level": 2, "text": "现场使用建议", "id": "现场使用建议" } ] } }, { "id": "localization/localization-api", "slug": "localization/localization-api", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/localization/localization-api", "zh-Hans": "/tutorials/zh-Hans/localization/localization-api" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/localization/localization-api", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/localization/localization-api" }, "previous": { "en": "/tutorials/en/localization/launch-ar/wechat-mini-program", "zh-Hans": "/tutorials/zh-Hans/localization/launch-ar/wechat-mini-program" }, "next": { "en": "/tutorials/en/localization/templates/unity", "zh-Hans": "/tutorials/zh-Hans/localization/templates/unity" }, "title": { "en": "Localization Guide for AR Apps", "zh-Hans": "AR 应用定位指南" }, "description": { "en": "This tutorial shows how to send one camera image—or a coherent Rig.v2 frame set—to 01Spatial, read the returned camera pose, and use that pose to align AR content with the real world.", "zh-Hans": "这篇教程介绍如何把一张相机图片，或一组来自同一段连续 AR 跟踪过程的 Rig.v2 相机帧（下文简称“帧”）发送给 01Spatial。系统会返回相机位姿，也就是相机在地图中的位置和朝向；应用再用这个结果把 AR 内容对齐到真实世界。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/localization/localization-api.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/localization/localization-api.md" }, "contentHash": { "en": "sha256:fd5ab539c5407e855ef1f3c343b902b43f3359653437f9755dd257e2df6e4836", "zh-Hans": "sha256:d60a98e1df6d90a323645f70275b156329ef752a3b298ae5ccea40fa25e2aac0" }, "headings": { "en": [ { "level": 1, "text": "Localization Guide for AR Apps", "id": "localization-guide-for-ar-apps" }, { "level": 2, "text": "1. Understand the result", "id": "1-understand-the-result" }, { "level": 2, "text": "2. Before you start", "id": "2-before-you-start" }, { "level": 2, "text": "3. Capture one synchronized camera sample", "id": "3-capture-one-synchronized-camera-sample" }, { "level": 2, "text": "4. Send the localization request", "id": "4-send-the-localization-request" }, { "level": 2, "text": "5. Read the pose and confidence", "id": "5-read-the-pose-and-confidence" }, { "level": 2, "text": "6. Use Rig.v2 for multi-frame localization", "id": "6-use-rig-v2-for-multi-frame-localization" }, { "level": 3, "text": "6.1 Capture one coherent frame set", "id": "6-1-capture-one-coherent-frame-set" }, { "level": 3, "text": "6.2 Compute the relative camera poses", "id": "6-2-compute-the-relative-camera-poses" }, { "level": 3, "text": "6.3 Build the Rig.v2 header", "id": "6-3-build-the-rig-v2-header" }, { "level": 3, "text": "6.4 Send the length-prefixed body", "id": "6-4-send-the-length-prefixed-body" }, { "level": 3, "text": "6.5 Apply the returned pose", "id": "6-5-apply-the-returned-pose" }, { "level": 2, "text": "7. Understand the coordinate systems", "id": "7-understand-the-coordinate-systems" }, { "level": 2, "text": "8. Align Map content with the AR Session", "id": "8-align-map-content-with-the-ar-session" }, { "level": 2, "text": "9. Three.js and WebXR example", "id": "9-three-js-and-webxr-example" }, { "level": 2, "text": "10. Common problems", "id": "10-common-problems" }, { "level": 2, "text": "11. Integration checklist", "id": "11-integration-checklist" } ], "zh-Hans": [ { "level": 1, "text": "AR 应用定位指南", "id": "ar-应用定位指南" }, { "level": 2, "text": "1. 先理解定位结果", "id": "1-先理解定位结果" }, { "level": 2, "text": "2. 开始前需要准备什么", "id": "2-开始前需要准备什么" }, { "level": 2, "text": "3. 获取同一帧的图片、内参和 AR 位姿", "id": "3-获取同一帧的图片-内参和-ar-位姿" }, { "level": 2, "text": "4. 发送定位请求", "id": "4-发送定位请求" }, { "level": 2, "text": "5. 读取位姿和置信度", "id": "5-读取位姿和置信度" }, { "level": 2, "text": "6. 使用 Rig.v2 完成多帧定位", "id": "6-使用-rig-v2-完成多帧定位" }, { "level": 3, "text": "6.1 采集一组属于同一跟踪过程的帧", "id": "6-1-采集一组属于同一跟踪过程的帧" }, { "level": 3, "text": "6.2 计算帧间相对位姿", "id": "6-2-计算帧间相对位姿" }, { "level": 3, "text": "6.3 构造 Rig.v2 请求头", "id": "6-3-构造-rig-v2-请求头" }, { "level": 3, "text": "6.4 发送带长度前缀的二进制请求体", "id": "6-4-发送带长度前缀的二进制请求体" }, { "level": 3, "text": "6.5 应用返回位姿", "id": "6-5-应用返回位姿" }, { "level": 2, "text": "7. 理解坐标系", "id": "7-理解坐标系" }, { "level": 2, "text": "8. 把地图内容对齐到 AR Session", "id": "8-把地图内容对齐到-ar-session" }, { "level": 2, "text": "9. Three.js 和 WebXR 示例", "id": "9-three-js-和-webxr-示例" }, { "level": 2, "text": "10. 常见问题", "id": "10-常见问题" }, { "level": 2, "text": "11. 上线前检查", "id": "11-上线前检查" } ] } }, { "id": "localization/templates/unity", "slug": "localization/templates/unity", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/localization/templates/unity", "zh-Hans": "/tutorials/zh-Hans/localization/templates/unity" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/localization/templates/unity", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/localization/templates/unity" }, "previous": { "en": "/tutorials/en/localization/localization-api", "zh-Hans": "/tutorials/zh-Hans/localization/localization-api" }, "next": { "en": "/tutorials/en/localization/templates/wechat-mini-program", "zh-Hans": "/tutorials/zh-Hans/localization/templates/wechat-mini-program" }, "title": { "en": "Build an AR app with the Unity template", "zh-Hans": "使用 Unity 模板开发 AR 应用" }, "description": { "en": "The Unity integration connects 01Spatial absolute localization to AR Foundation. ARKit or ARCore provides smooth frame-to-frame tracking; 01Spatial aligns that local session with persistent map coordinates.", "zh-Hans": "Unity 模板用于把 01Spatial 绝对定位接入 AR Foundation：ARKit 或 ARCore 负责帧间平滑跟踪，01Spatial 把这段本地 AR Session 对齐到持久地图坐标。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/localization/templates/unity.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/localization/templates/unity.md" }, "contentHash": { "en": "sha256:855f073b7423a4eaba10d7871c8140c14bfa9f3e68d8de06453fd14f99fb58c6", "zh-Hans": "sha256:90d48f9cf4cda2e91093ccb1675a3fcb309971f6afe0c9f2f9955cb26767e9b9" }, "headings": { "en": [ { "level": 1, "text": "Build an AR app with the Unity template", "id": "build-an-ar-app-with-the-unity-template" } ], "zh-Hans": [ { "level": 1, "text": "使用 Unity 模板开发 AR 应用", "id": "使用-unity-模板开发-ar-应用" }, { "level": 2, "text": "接入前准备", "id": "接入前准备" }, { "level": 2, "text": "模板中的核心对象", "id": "模板中的核心对象" }, { "level": 2, "text": "接入顺序", "id": "接入顺序" }, { "level": 2, "text": "上线检查", "id": "上线检查" } ] } }, { "id": "localization/templates/wechat-mini-program", "slug": "localization/templates/wechat-mini-program", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/localization/templates/wechat-mini-program", "zh-Hans": "/tutorials/zh-Hans/localization/templates/wechat-mini-program" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/localization/templates/wechat-mini-program", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/localization/templates/wechat-mini-program" }, "previous": { "en": "/tutorials/en/localization/templates/unity", "zh-Hans": "/tutorials/zh-Hans/localization/templates/unity" }, "next": { "en": "/tutorials/en/reference/credentials", "zh-Hans": "/tutorials/zh-Hans/reference/credentials" }, "title": { "en": "Build an AR app with the WeChat Mini Program template", "zh-Hans": "使用微信小程序模板开发 AR 应用" }, "description": { "en": "The Mini Program integration uses XR-FRAME for local tracking and 01Spatial for an absolute camera pose in map coordinates. Persistent Content remains under a map root aligned to the current trackerSpace.", "zh-Hans": "微信小程序模板使用 XR-FRAME 提供本地跟踪，并调用 01Spatial 获取地图中的绝对相机位姿。所有长期存在的数字内容都应保存在地图坐标中，再整体对齐到当前 trackerSpace。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/localization/templates/wechat-mini-program.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/localization/templates/wechat-mini-program.md" }, "contentHash": { "en": "sha256:59625afe0dc391a4a43bfa0db48028b2c9071574d022a190664e6288bd18c7f1", "zh-Hans": "sha256:5ec933d56f1efad30f18dc6835e94ba617eedd833d89a6037a233444f70a3e59" }, "headings": { "en": [ { "level": 1, "text": "Build an AR app with the WeChat Mini Program template", "id": "build-an-ar-app-with-the-wechat-mini-program-template" } ], "zh-Hans": [ { "level": 1, "text": "使用微信小程序模板开发 AR 应用", "id": "使用微信小程序模板开发-ar-应用" }, { "level": 2, "text": "接入前准备", "id": "接入前准备" }, { "level": 2, "text": "同步采样", "id": "同步采样" }, { "level": 2, "text": "场景组织", "id": "场景组织" }, { "level": 2, "text": "发布前检查", "id": "发布前检查" } ] } }, { "id": "reference/credentials", "slug": "reference/credentials", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/reference/credentials", "zh-Hans": "/tutorials/zh-Hans/reference/credentials" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/reference/credentials", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/reference/credentials" }, "previous": { "en": "/tutorials/en/localization/templates/wechat-mini-program", "zh-Hans": "/tutorials/zh-Hans/localization/templates/wechat-mini-program" }, "next": { "en": "/tutorials/en/reference/coordinate-pose", "zh-Hans": "/tutorials/zh-Hans/reference/coordinate-pose" }, "title": { "en": "Credentials and keys", "zh-Hans": "凭证与 Key" }, "description": { "en": "01Spatial separates who is calling from which resource is targeted.", "zh-Hans": "01Spatial 使用不同凭证表达“谁在请求”和“请求哪个资源”。不要把 API Key、Map Key、Project Key 和 Portal 登录令牌混为一谈。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/reference/credentials.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/reference/credentials.md" }, "contentHash": { "en": "sha256:d5a7df82f509996fc5ac05b758558a6fb8cf65275e3a024bee1b79c5412ec698", "zh-Hans": "sha256:388b902c6f7ff412976add0f5b16f0c185be31938b28ae8b45e1437bc7d4d73c" }, "headings": { "en": [ { "level": 1, "text": "Credentials and keys", "id": "credentials-and-keys" } ], "zh-Hans": [ { "level": 1, "text": "凭证与 Key", "id": "凭证与-key" }, { "level": 2, "text": "选择 Map 或 Project", "id": "选择-map-或-project" }, { "level": 2, "text": "安全使用", "id": "安全使用" }, { "level": 2, "text": "轮换与失效", "id": "轮换与失效" } ] } }, { "id": "reference/coordinate-pose", "slug": "reference/coordinate-pose", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/reference/coordinate-pose", "zh-Hans": "/tutorials/zh-Hans/reference/coordinate-pose" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/reference/coordinate-pose", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/reference/coordinate-pose" }, "previous": { "en": "/tutorials/en/reference/credentials", "zh-Hans": "/tutorials/zh-Hans/reference/credentials" }, "next": { "en": "/tutorials/en/reference/troubleshooting", "zh-Hans": "/tutorials/zh-Hans/reference/troubleshooting" }, "title": { "en": "Coordinate and pose conventions", "zh-Hans": "坐标系与位姿约定" }, "description": { "en": "01Spatial returns the camera pose in map coordinates. Let TAB transform points from frame B to frame A: M is Map, A is the current AR session, and C is Camera. API cameratoworld is TMC.", "zh-Hans": "定位成功后，01Spatial 返回相机在地图坐标系中的位姿。正确理解矩阵方向和相机轴，是避免内容镜像、旋转或固定偏移的关键。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/reference/coordinate-pose.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/reference/coordinate-pose.md" }, "contentHash": { "en": "sha256:82951db8c3cc58f7e19767d2b175f2b7a4be7312e1ee3ef7edd425ff89c51066", "zh-Hans": "sha256:63d059a2f20e86d0b02dad6a20609be586cecd0b33bc8f4961bb450f82b94037" }, "headings": { "en": [ { "level": 1, "text": "Coordinate and pose conventions", "id": "coordinate-and-pose-conventions" } ], "zh-Hans": [ { "level": 1, "text": "坐标系与位姿约定", "id": "坐标系与位姿约定" }, { "level": 2, "text": "变换命名", "id": "变换命名" }, { "level": 2, "text": "相机轴", "id": "相机轴" }, { "level": 2, "text": "对齐地图内容", "id": "对齐地图内容" } ] } }, { "id": "reference/troubleshooting", "slug": "reference/troubleshooting", "status": { "en": "draft", "zh-Hans": "published" }, "url": { "en": "/tutorials/en/reference/troubleshooting", "zh-Hans": "/tutorials/zh-Hans/reference/troubleshooting" }, "absoluteUrl": { "en": "https://portal.01spatial.ai/tutorials/en/reference/troubleshooting", "zh-Hans": "https://portal.01spatial.cn/tutorials/zh-Hans/reference/troubleshooting" }, "previous": { "en": "/tutorials/en/reference/coordinate-pose", "zh-Hans": "/tutorials/zh-Hans/reference/coordinate-pose" }, "next": { "en": null, "zh-Hans": null }, "title": { "en": "Errors and troubleshooting", "zh-Hans": "错误与故障排查" }, "description": { "en": "First isolate the failing layer: upload, build, viewing, localization request, or AR alignment. Avoid changing scan data, intrinsics, and coordinate conversion at the same time.", "zh-Hans": "先确定问题发生在哪一层：上传、建图、地图浏览、定位请求，还是 AR 对齐。不要在没有证据时同时修改扫描数据、内参和坐标转换，否则很难判断真正原因。" }, "markdown": { "en": "https://portal.01spatial.ai/ai-docs/en/reference/troubleshooting.md", "zh-Hans": "https://portal.01spatial.cn/ai-docs/zh-Hans/reference/troubleshooting.md" }, "contentHash": { "en": "sha256:fbb8304acf5c459f1a067ed30d68fd6e3f692ae5cd6252ca3387f62da1d79d43", "zh-Hans": "sha256:087a220ca90bab9275b2e2ec047b8c5d61af1deae54d6c8a3351f3e41535a23d" }, "headings": { "en": [ { "level": 1, "text": "Errors and troubleshooting", "id": "errors-and-troubleshooting" }, { "level": 2, "text": "Upload and build", "id": "upload-and-build" }, { "level": 2, "text": "HTTP status", "id": "http-status" } ], "zh-Hans": [ { "level": 1, "text": "错误与故障排查", "id": "错误与故障排查" }, { "level": 2, "text": "上传与建图", "id": "上传与建图" }, { "level": 2, "text": "定位 HTTP 状态", "id": "定位-http-状态" }, { "level": 2, "text": "结果看起来不对", "id": "结果看起来不对" } ] } } ], "hierarchy": [ { "id": "start", "label": { "en": "Start here", "zh-Hans": "开始" }, "items": [ { "id": "overview", "docSlug": "", "label": { "en": "Get Started", "zh-Hans": "快速开始" } }, { "id": "workflow", "docSlug": "concepts/platform-workflow", "label": { "en": "How it works", "zh-Hans": "它是如何工作的？" } }, { "id": "for-ar-developers", "docSlug": "concepts/for-ar-developers", "label": { "en": "For AR developers", "zh-Hans": "写给 AR 开发者" } }, { "id": "for-robotics-developers", "docSlug": "concepts/for-robotics-developers", "label": { "en": "For robotics developers", "zh-Hans": "写给机器人开发者" } } ] }, { "id": "mapping", "label": { "en": "Scanning & mapping", "zh-Hans": "扫描与建图" }, "items": [ { "id": "standard-camera-video", "label": { "en": "Standard camera video", "zh-Hans": "普通相机视频" }, "children": [ { "id": "standard-video-capture", "docSlug": "mapping/standard-camera-video/capture", "label": { "en": "Spatial scan", "zh-Hans": "空间扫描" } }, { "id": "standard-video-configurator", "docSlug": "mapping/standard-camera-video/map-configurator", "label": { "en": "Configure", "zh-Hans": "配置" } }, { "id": "standard-video-build", "docSlug": "mapping/standard-camera-video/build", "label": { "en": "Build the map", "zh-Hans": "建图" } } ] }, { "id": "panorama-camera-video", "label": { "en": "360° camera video", "zh-Hans": "全景相机视频" }, "children": [ { "id": "panorama-video-capture", "docSlug": "mapping/panorama-camera-video/capture", "label": { "en": "Spatial scan", "zh-Hans": "空间扫描" } }, { "id": "panorama-video-spatial-reference-board", "docSlug": "mapping/panorama-camera-video/spatial-reference-board", "label": { "en": "Use Spatial Reference Boards", "zh-Hans": "使用空间基准板" } }, { "id": "panorama-video-configurator", "docSlug": "mapping/panorama-camera-video/map-configurator", "label": { "en": "Configure", "zh-Hans": "配置" } }, { "id": "panorama-video-build", "docSlug": "mapping/panorama-camera-video/build", "label": { "en": "Build the map", "zh-Hans": "建图" } } ] }, { "id": "reconstruction-app-scan", "label": { "en": "Mobile 3D scanning", "zh-Hans": "移动端三维扫描" }, "children": [ { "id": "polycam-scan", "docSlug": "mapping/mobile-3d-scanning/polycam", "label": { "en": "Scan with Polycam", "zh-Hans": "使用 Polycam 扫描" } }, { "id": "kiri-engine-scan", "docSlug": "mapping/mobile-3d-scanning/kiri-engine", "label": { "en": "Scan with KIRI Engine", "zh-Hans": "使用 KIRI Engine 扫描" } } ] }, { "id": "lidar-scan", "label": { "en": "LiDAR scan", "zh-Hans": "LiDAR 扫描" }, "badge": { "en": "Top choice", "zh-Hans": "最推荐" }, "children": [ { "id": "lidar-overview", "docSlug": "mapping/lidar", "label": { "en": "LiDAR scanning overview", "zh-Hans": "LiDAR 扫描概述" } }, { "id": "matterport-scan", "docSlug": "mapping/lidar/matterport", "label": { "en": "Scan with Matterport", "zh-Hans": "使用 Matterport 扫描" } }, { "id": "faro-scan", "docSlug": "mapping/lidar/faro", "label": { "en": "Scan with FARO", "zh-Hans": "使用 FARO 扫描" } }, { "id": "navvis-scan", "docSlug": "mapping/lidar/navvis", "label": { "en": "Scan with NavVis", "zh-Hans": "使用 NavVis 扫描" } }, { "id": "leica-rtc-scan", "docSlug": "mapping/lidar/leica-rtc", "label": { "en": "Scan with Leica RTC", "zh-Hans": "使用 Leica RTC 扫描" } }, { "id": "hexagon-realslam-scan", "docSlug": "mapping/lidar/hexagon-realslam", "label": { "en": "Scan with Hexagon RealSLAM", "zh-Hans": "使用 Hexagon RealSLAM 扫描" } }, { "id": "xgrids-scan", "docSlug": "mapping/lidar/xgrids", "label": { "en": "Scan with XGRIDS", "zh-Hans": "使用 XGRIDS 扫描" } }, { "id": "fjd-scan", "docSlug": "mapping/lidar/fjd", "label": { "en": "Scan with FJD", "zh-Hans": "使用 FJD 扫描" } }, { "id": "chcnav-scan", "docSlug": "mapping/lidar/chcnav", "label": { "en": "Scan with CHCNAV", "zh-Hans": "使用 CHCNAV 扫描" } } ] } ] }, { "id": "map-content", "label": { "en": "Maps & content", "zh-Hans": "管理地图 & 内容编辑" }, "items": [ { "id": "spatial-maps-management", "docSlug": "maps/manage", "label": { "en": "Manage maps", "zh-Hans": "管理地图" } }, { "id": "studio-map-panel", "docSlug": "maps/explore", "label": { "en": "Explore a map", "zh-Hans": "探索地图" } }, { "id": "studio-content-panel", "docSlug": "maps/add-content", "label": { "en": "Add content", "zh-Hans": "添加内容" } } ] }, { "id": "localization", "label": { "en": "Localization & AR", "zh-Hans": "定位与 AR" }, "items": [ { "id": "studio-test", "docSlug": "localization/space-studio-test", "label": { "en": "Run a localization test in Space Studio", "zh-Hans": "使用 Space Studio 执行定位测试" } }, { "id": "launch-ar", "label": { "en": "Launch AR", "zh-Hans": "开启 AR" }, "children": [ { "id": "android-webxr", "docSlug": "localization/launch-ar/android-webxr", "label": { "en": "Android · WebXR client", "zh-Hans": "Android 设备（WebXR 客户端）" } }, { "id": "ios-appclip", "docSlug": "localization/launch-ar/ios-app-clip", "label": { "en": "iOS · App Clip client", "zh-Hans": "iOS 设备（App Clip 客户端）" } }, { "id": "wechat-client", "docSlug": "localization/launch-ar/wechat-mini-program", "label": { "en": "WeChat Mini Program", "zh-Hans": "微信小程序" } } ] }, { "id": "localization-api", "docSlug": "localization/localization-api", "label": { "en": "Localization API for generic clients", "zh-Hans": "定位 API（通用客户端）" } }, { "id": "templates", "label": { "en": "Build AR apps with templates", "zh-Hans": "使用模板开发 AR 应用" }, "children": [ { "id": "unity-template", "docSlug": "localization/templates/unity", "label": { "en": "Unity template", "zh-Hans": "Unity 模板" } }, { "id": "wechat-template", "docSlug": "localization/templates/wechat-mini-program", "label": { "en": "WeChat Mini Program template", "zh-Hans": "微信小程序模板" } } ] } ] }, { "id": "reference", "label": { "en": "API & reference", "zh-Hans": "API 与参考" }, "items": [ { "id": "api-reference", "external": "apiReference", "label": { "en": "Interactive API reference", "zh-Hans": "交互式 API Reference" } }, { "id": "credentials", "docSlug": "reference/credentials", "label": { "en": "Credentials & keys", "zh-Hans": "凭证与 Key" } }, { "id": "pose-conventions", "docSlug": "reference/coordinate-pose", "label": { "en": "Coordinate & pose conventions", "zh-Hans": "坐标系与位姿约定" } }, { "id": "errors", "docSlug": "reference/troubleshooting", "label": { "en": "Errors & troubleshooting", "zh-Hans": "错误与故障排查" } } ] } ], "aliases": [ { "language": "en", "from": "https://portal.01spatial.ai/tutorials/en/guides/capture-a-space", "to": "https://portal.01spatial.ai/tutorials/en/mapping/standard-camera-video/capture" }, { "language": "zh-Hans", "from": "https://portal.01spatial.cn/tutorials/zh-Hans/guides/capture-a-space", "to": "https://portal.01spatial.cn/tutorials/zh-Hans/mapping/standard-camera-video/capture" }, { "language": "en", "from": "https://portal.01spatial.ai/tutorials/en/mapping/capture-overview", "to": "https://portal.01spatial.ai/tutorials/en/mapping/standard-camera-video/capture" }, { "language": "zh-Hans", "from": "https://portal.01spatial.cn/tutorials/zh-Hans/mapping/capture-overview", "to": "https://portal.01spatial.cn/tutorials/zh-Hans/mapping/standard-camera-video/capture" }, { "language": "en", "from": "https://portal.01spatial.ai/tutorials/en/mapping/panorama-camera-video/metric-anchor-board", "to": "https://portal.01spatial.ai/tutorials/en/mapping/panorama-camera-video/spatial-reference-board" }, { "language": "zh-Hans", "from": "https://portal.01spatial.cn/tutorials/zh-Hans/mapping/panorama-camera-video/metric-anchor-board", "to": "https://portal.01spatial.cn/tutorials/zh-Hans/mapping/panorama-camera-video/spatial-reference-board" }, { "language": "en", "from": "https://portal.01spatial.ai/tutorials/en/mapping/lidar/leica-geosystems", "to": "https://portal.01spatial.ai/tutorials/en/mapping/lidar/leica-rtc" }, { "language": "zh-Hans", "from": "https://portal.01spatial.cn/tutorials/zh-Hans/mapping/lidar/leica-geosystems", "to": "https://portal.01spatial.cn/tutorials/zh-Hans/mapping/lidar/leica-rtc" }, { "language": "en", "from": "https://portal.01spatial.ai/tutorials/en/guides/localization-for-ar", "to": "https://portal.01spatial.ai/tutorials/en/localization/localization-api" }, { "language": "zh-Hans", "from": "https://portal.01spatial.cn/tutorials/zh-Hans/guides/localization-for-ar", "to": "https://portal.01spatial.cn/tutorials/zh-Hans/localization/localization-api" } ], "externalResources": [ { "type": "api-reference", "url": "/docs" }, { "type": "openapi", "mediaType": "application/vnd.oai.openapi+json", "url": "/openapi.json" } ] }