检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
开发概述 WebARSDK简介 WebARSDK是一款轻量化JS-SDK，支持租户通过SDK快速集成和使用KooMap AR地图运行服务，开放能力的内存增加不大于3MB，运行时不依赖于Native App，可通过主流Web浏览器平台、主流终端设备的App内嵌WebView，实现WebAR体验。
计费概述 通过阅读本文，您可以快速了解云地图服务（KooMap）的计费模式、计费项、续费、欠费等主要计费信息。 计费模式 KooMap提供按需计费和套餐包两种计费模式。按需计费是一种后付费模式，即先使用再付费，按照实际使用时长/使用量计费。套餐包是一种先付费再使用的计费模式，使用
其他 接口列表 表1 其他接口列表 接口 描述 参数名 参数类型 参数说明 返回值 requestNavi 请求导航路径。 utmCode string 当前utm区域。 void from number[3] 导航出发点utm坐标。 to number[3] 导航目的地utm坐标。
注意事项 视频流无法正常获取原因排查 如果您无法获取视频流，建议您排查以下问题： 检查是否存在浏览器多个标签页同时申请获取视频流的情况，建议您关闭其他标签页。 检查浏览器是否支持WebRTC，如不支持，建议您更换浏览器。 检查应用相机权限是否打开。 检查移动设备后置摄像头是否能正常拍摄画面。
注意事项 创建导航 // HTNavigationProvider是为导航模块提供参数与配置的类，通过对这个类的参数调整，可以对导航功能进行详细配置 mNaviProvider = new HTNavigationProvider(HTSystemManager.GetHTSystem()
开发指导 开发流程 图1 AR导航启动流程 开发过程 开启AR会话。 选定终点位置。 通过POI智能搜索（hwar.searchPoi）选定终点坐标。 // POI智能搜索 hwar.searchPoi({ "floor": "1F", "address": "xxx"
准备工作 开发技能要求 具备TypeScript/JavaScript开发基础。 熟悉XRFrame的XR/3D应用解决方案。 下载并解压XRLightSDK 请下载XRLightSDK软件包和软件包的完整性校验文件，并解压软件包。 SDK软件包中的目录结构： workers文件夹：工程引用的worker。
总体开发思路 使用HTFoundation示例开发移动端应用的工作流程如图1所示。 图1 工作流程 创建一个新的工程目录。 使用Unity3D引擎创建基础工程，基础工程里面会有一个空的工程目录。详情见创建Unity项目。 导入ARFoundation插件包。 在Unity的Packages文件夹中找到manifest
空间位置追踪与渲染 接口列表 空间位置追踪与渲染需要使用到的接口如表1所示。 表1 空间位置追踪与渲染接口列表 接口 描述 参数名 参数类型 参数说明 返回值 createARSession 创建AR会话。 - - - Promise<void> setARStatus 设置AR状态。
快速开始 使用微信开发者工具创建小程序工程，导入SDK。 本文档使用的微信开发者工具版本为Nightly 1.06.2411282。 使用微信号登录微信开发者工具。 新建微信小程序工程。 单击“新建项目”，进入“创建小程序”页面。 图1 创建小程序 在“项目名称”文本框中填写项目名称。
申请KooMap公测 KooMap在公测阶段需要先申请并通过人工审核后才可以使用。 前提条件 由于公测期间资源有限，仅限已通过实名认证的华为账号申请公测。 申请步骤 您可参考如下操作步骤申请公测。 您可选择以下任一方式登录申请公测页面。 进入KooMap管理控制台，单击“立即申请”。
开发指导 开发流程 创建和开发流程如图1所示。 图1 流程图 开发过程 配置AK/SK信息。 在新建的Unity工程“Assets > HTFoundation > Scripts > BaseUtils”中找到HTStringRes.cs，并在HTStringRes.cs配置A
使用前必读 云地图服务（ KooMap ）是提供空间处理、计算、可视、虚实交互等一站式开箱即用的云服务，赋能客户虚实融合互动的应用创新。 您可以使用本文档提供的API对云地图服务进行相关操作，如空间定位、空间导航。支持的全部操作请参见API概览。 在调用KooMap API之前，
事件 接口列表 表1 事件接口列表 接口 描述 参数名 参数类型 参数说明 返回值 addEvent 侦听事件。 evtName string 事件ID。 根据实际情况选择Vps定位结果事件ID、Vps状态事件ID或scene实例事件ID。 void cb Function 侦听到事件后，触发的回调函数。
SDK内部派发事件 SDK内部派发事件如表1所示。 表1 SDK内部派发事件列表 事件名称 描述 携带的数据 数据类型 事件说明 GYRO_STATUS 陀螺仪有效性检测。 gyro boolean 需要侦听回调，回调函数会接收到一个参数：event: { data: Object
视觉定位 接口列表 表1 视觉定位接口列表 接口 描述 参数名 参数类型 参数说明 返回值 init 初始化视觉定位模块。 config { access: string, secret: string, beforeLocateDelta: number, afterLocateDelta:
总体开发思路 使用WebARSDK开发移动端应用的工作流程如图1所示。 图1 工作流程 准备工作。 下载WebARSDK、收集AK/SK信息、开通关联服务。 创建H5移动端工程。 使用原生或者流行框架（如Vue、React）创建H5移动端工程。 引入WebARSDK文件。 下载、
错误码 AR地图运行服务错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 NAVI.0002 Navi failed, please check parameters. 导航失败。 检查参数是否正确或联系技术支持。
上传数据 您可根据实际需求在项目内上传全景视频，用于AR地图生产。上传的全景视频需符合约束条件请参考“约束与限制”。 前提条件 已新增项目。 在项目内上传数据 登录KooMap管理控制台。 在左侧导航栏的“AR地图”下选择“项目管理”。 在“项目管理”页面，单击项目名称（蓝色字体），进入“项目详情”页面。
与其他服务的关系 表1 KooMap与其他服务的依赖关系 服务名称 KooMap与其他服务的关系 主要交互功能 对象存储服务（Object Storage Service，OBS） 原始数据通过对象存储服务的OBS桶来存储，KooMap从OBS加载原始数据完成AR地图生产服务。 从OBS下载原始数据至KooMap。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
