检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
概述 SDK功能集成在HTFoundationOrigin预制体中，默认开启相机预览流、定位、资源加载与调试面板功能，主要功能包含导航、白膜显隐等。其主要是由HTSysEntrance和Canvas构成： HTSysEntrance：负责提供SDK功能并维护生命周期。 Canvas：负责提供示例界面UI。
全场景：全场景高精度空间计算技术，连接物理世界和数字世界。 高精度：AR地图运行服务视觉定位和导航可实现厘米级定位精度。 高效率：外业数据一次采集生成多种AR成果数据，应用到虚实融合、定位、导航等多个场景，极大地提升数据采集和地图生产效率。 全自动：全自动化AR地图生产，用户只需上传全景相机数据，一键启动和完成地图生产。
构造请求 本节介绍REST API请求的组成，并以调用KooMap的AR导航接口说明如何调用API。 请求URI 请求URI由如下部分组成： {URI-scheme}://{Endpoint}/{resource-path}?{query-string} 尽管请求URI包含在请求
App，可通过主流Web浏览器平台、主流终端设备的App内嵌WebView，实现WebAR体验。 WebARSDK提供的API，可以将用户、空间及数字内容连接在一起 ，达到厘米级的定位能力和1度以内的定姿能力，实现随时随地高精度的空间计算。在AR地图覆盖区域，用户可进行3D实景步行导引，无需担心GPS信号弱的环境。
）是提供空间处理、计算、可视、虚实交互等一站式开箱即用的云服务，赋能客户虚实融合互动的应用创新。 您可以使用本文档提供的API对云地图服务进行相关操作，如空间定位、空间导航。支持的全部操作请参见API概览。 在调用KooMap API之前，请确保已经充分了解KooMap相关概念，详细信息请参见云地图服务的《产品介绍》。
创新。 当前KooMap推出了AR地图运行服务和AR地图生产服务。 AR地图运行服务：基于高精度AR地图，提供厘米级高精度的视觉定位和AR导航，支持用户在物理空间中进行AR内容的展示，构建虚实交互应用体验。 AR地图生产服务：对外业采集的图像数据进行加工处理，生成AR地图成果数据，供AR地图运行服务使用。
将设备图像中的特征与索引中的特征进行比较，以获得目标设备的位姿。 AR导航 AR导航是新型的地图导航方法，基于摄像头实时捕捉的实景画面，通过数字内容的形态将地图导航信息叠加在实景画面中，生成虚拟的3D导航指引。
请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对AR导航接口，如果调用后返回状态码为“200”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。
您可通过如下任意方式完成AR地图生产服务的开通。 方式一：在左侧导航栏选择“总览”，然后在右侧页面单击“AR地图生产服务”卡片下的“开通服务”。 方式二：在左侧导航栏选择“服务概览”，然后在右侧“服务列表”页面单击“AR地图全景建图云服务”操作列“开通”。（左侧导航栏如有“服务概览”菜单且非首次开通，才能使用此开通方式。）
适用场景 按需计费适用于具有不能中断的短期、突增或不可预测的应用或服务。比如AR地图运行服务在某个现场AR营销活动中支持数字内容的展示和AR导航。 适用计费项 表1 适用计费项 服务 计费项 说明 AR地图运行服务 AR地图运行服务基础版 按实际开通时长计费，以小时为单位进行计费。
服务概览 开通AR地图运行服务或者AR地图生产服务后，您可在左侧导航栏选择“AR地图”下的“服务概览”菜单，做如下操作： 查看该服务相关信息，比如：产品名称、规格（仅适用于AR地图运行服务）、计费模式、套餐包剩余可用额度/总额度（仅适用于AR地图生产服务）以及状态。 退订AR地图运行服务或AR地图生产服务。
WebARSDK使用手册 开发概述 总体开发思路 准备工作 快速开始 开启AR会话 实现AR导航 API列表 代码示例 常用调试方法
开发技能要求 具备TypeScript/JavaScript开发基础。 熟悉Web移动端开发。 熟悉Three.js、LayaAir等渲染库，可实现基于WebGL的3D渲染。 下载SDK 请下载WebARSDK软件包和软件包的完整性校验文件，并解压软件包、核对文件目录。 图1 SDK包目录结构
身份认证：KooMap提供的身份认证可以分为控制台和云服务两个层面。 控制台层面：您可以使用华为云用户名与密码登录，实现用户的认证与鉴权，未授权的不能访问。 云服务层面：您可通过开放的API网关，实现AR地图运行服务的访问和集成，具体操作和描述请参考KooMap的《API参考》。KooMap提供如下两种认证方式进行认证鉴权。
可快速搜索的索引。将设备图像中的特征与索引中的特征进行比较，可获得目标设备的位姿。 AR导航 基于摄像头实时捕捉的实景画面，将地图导航信息通过数字内容的形态叠加在实景画面中，生成虚拟的3D导航指引。
0002 Navi failed, please check parameters. 导航失败。 检查参数是否正确或联系技术支持。 400 NAVI.0003 Invalid parameters. 导航算法服务参数不正确。 检查参数是否正确。 400 NAVI.0004 Access
API 空间定位 空间导航
2023年04月 序号 功能名称 功能描述 阶段 相关文档 1 AR地图运行服务 基于高精度AR地图，提供在物理世界的厘米级高精度的视觉定位和AR导航，支持用户在物理空间中进行AR内容的展示，提供虚实交互应用体验。 公测 开通AR地图运行服务 2023年03月 序号 功能名称 功能描述 阶段
API列表 调用前须知 视觉定位 空间位置追踪与渲染 导航 事件管理 SDK内部派发事件 父主题： WebARSDK使用手册
HTSDK使用手册 开发概述 总体开发思路 准备工作 快速开始 创建HTFoundation会话 AR导航 代码示例 常用调试方法
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
