检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
事件管理 事件管理使用到的接口如表1所示。 表1 事件管理接口列表 接口 描述 参数名 参数类型 参数说明 返回值 dispatchEvent 事件派发。 strId string 侦听事件id。 void data { [key: string]: DataType } 携带的数据。
概述 AR导航功能依赖视觉定位，提供空间位置追踪能力。 您可以依赖图像数据、相机矩阵及路径点信息进行3D导航路径渲染。 父主题： 实现AR导航
事件 接口列表 表1 事件接口列表 接口 描述 参数名 参数类型 参数说明 返回值 addEvent 侦听事件。 evtName string 事件ID。 根据实际情况选择Vps定位结果事件ID、Vps状态事件ID或scene实例事件ID。 void cb Function 侦听到事件后，触发的回调函数。
其他 接口列表 表1 其他接口列表 接口 描述 参数名 参数类型 参数说明 返回值 requestNavi 请求导航路径。 utmCode string 当前utm区域。 void from number[3] 导航出发点utm坐标。 to number[3] 导航目的地utm坐标。
视觉定位 接口列表 表1 视觉定位接口列表 接口 描述 参数名 参数类型 参数说明 返回值 init 初始化视觉定位模块。 config { access: string, secret: string, beforeLocateDelta: number, afterLocateDelta:
注意事项 模块之间启动销毁存在相关依赖需要按照一定顺序执行，HTSysEntrance需要最先执行。脚本执行顺序可见“Assets > HTFoundation > Scripts”中的SessionsManager.cs文件。 由于SDK的虚拟世界比较庞大，导致距离坐标世界原点
调用前准备工作 XRLightSDK封装类名为“XRClient”，所有API均直接通过类“XRClient”来调用，无需实例化。 在调用SDK前，需在文件头部引入XRClient类。 import { XRClient } from "../../SDK/XRClient"; 父主题：
定位失败，定位结果显示“OutOfService” 登录KooMap管理控制台，检查是否开通了AR地图运行服务，如未开启，请开通AR地图运行服务。 父主题： 常见问题
注意事项 了解坐标系 VPS坐标系 VPS坐标系是基于UTM坐标定义的，北向Y轴正向和东向X轴正向如图1所示。 图1 VPS坐标系示意图 Three.js渲染引擎坐标系 摆放虚拟物体时需要注意：Three.js的相机朝向是Z轴的反向。 图2 Three.js渲染引擎坐标系示意图 坐标系转换
开发指导 开发流程 图1 AR导航启动流程 开发过程 开启AR会话。 选定终点位置。 通过POI智能搜索（hwar.searchPoi）选定终点坐标。 // POI智能搜索 hwar.searchPoi({ "floor": "1F", "address": "xxx"
调试工具 常用的调试工具包括： 基于Chromium内核的浏览器（例如Edge、Chrome）的开发者工具（DevTools） Safari浏览器 父主题： 常用调试方法
空间位置追踪与渲染 接口列表 空间位置追踪与渲染需要使用到的接口如表1所示。 表1 空间位置追踪与渲染接口列表 接口 描述 参数名 参数类型 参数说明 返回值 createARSession 创建AR会话。 - - - Promise<void> setARStatus 设置AR状态。
定位失败，定位结果显示“Incorrect IAM” 检查初始化视觉定位模块config参数中配置的AK、SK是否正确。获取方法请参见访问密钥。 父主题： 常见问题
定位失败，定位结果显示“invalid url” 检查初始化视觉定位模块config参数中配置的url是否正确。url为https://koomap.cn-north-4.myhuaweicloud.com。 父主题： 常见问题
定位后报错，日志显示“Cannot read properties of undefined（reading ‘position‘）” 在components/xr-start/index.wxml文件里找到xr-camera ，然后在它的上一行加上node-id="cameraParent"的节点，如图1所示。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
