检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
概述 您可开启AR会话获取设备的图像、GPS坐标及传感器数据,启动SLAM从而进行视觉定位。 传感器包括陀螺仪、加速度计、磁力计。 父主题: 开启AR会话
概述 AR导航功能依赖视觉定位,提供空间位置追踪能力。 您可以依赖图像数据、相机矩阵及路径点信息进行3D导航路径渲染。 父主题: 实现AR导航
开发指导 开发流程 开发流程请参考图1。 图1 开发流程图 开发过程 搜索POI。 // 创建获取POI的异步任务栈 var mPOICloud = new HTPOICloud(); // 将生命周期绑定到unity的生命周期 mPOICloud.Create("NAVIPOI");
注意事项 创建导航 // HTNavigationProvider是为导航模块提供参数与配置的类,通过对这个类的参数调整,可以对导航功能进行详细配置 mNaviProvider = new HTNavigationProvider(HTSystemManager.GetHTSystem()
从服务开通到实际可用,需要多长时间 当前KooMap服务处于公测阶段,公测期间开通服务需要7个工作日。 父主题: 服务开通
事件 接口列表 表1 事件接口列表 接口 描述 参数名 参数类型 参数说明 返回值 addEvent 侦听事件。 evtName string 事件ID。 根据实际情况选择Vps定位结果事件ID、Vps状态事件ID或scene实例事件ID。 void cb Function 侦听到事件后,触发的回调函数。
日志 接口列表 表1 日志接口列表 接口 描述 参数名 参数类型 参数说明 返回值 initLogger 初始化日志模块 logger ILog 日志的实例 void setIsSaveLog 日志存储 isSave boolean 是否存储日志 void setLogOutputLevel
其他 接口列表 表1 其他接口列表 接口 描述 参数名 参数类型 参数说明 返回值 requestNavi 请求导航路径。 utmCode string 当前utm区域。 void from number[3] 导航出发点utm坐标。 to number[3] 导航目的地utm坐标。
调用前准备工作 XRLightSDK封装类名为“XRClient”,所有API均直接通过类“XRClient”来调用,无需实例化。 在调用SDK前,需在文件头部引入XRClient类。 import { XRClient } from "../../SDK/XRClient"; 父主题:
开发指导 开发流程 图1 开启AR会话开发流程 开发过程 开启AR相机。 在工具的资源管理器,单击右键,选择“新建文件夹”,命名为“components”。 选择“components”文件夹,单击右键,选择“新建文件夹”,命名为“xrstart”。 选择“xrstart”文件夹
注意事项 如果您无法获取视频流,建议排查以下问题: 检查小程序相机权限是否打开。 检查移动设备后置摄像头是否能正常拍摄画面。 父主题: 开启AR会话
视觉定位 接口列表 表1 视觉定位接口列表 接口 描述 参数名 参数类型 参数说明 返回值 init 初始化视觉定位模块。 config { access: string, secret: string, beforeLocateDelta: number, afterLocateDelta:
注意事项 模块之间启动销毁存在相关依赖需要按照一定顺序执行,HTSysEntrance需要最先执行。脚本执行顺序可见“Assets > HTFoundation > Scripts”中的SessionsManager.cs文件。 由于SDK的虚拟世界比较庞大,导致距离坐标世界原点
SDK内部派发事件 SDK内部派发事件如表1所示。 表1 SDK内部派发事件列表 事件名称 描述 携带的数据 数据类型 事件说明 GYRO_STATUS 陀螺仪有效性检测。 gyro boolean 需要侦听回调,回调函数会接收到一个参数:event: { data: Object
注意事项 视频流无法正常获取原因排查 如果您无法获取视频流,建议您排查以下问题: 检查是否存在浏览器多个标签页同时申请获取视频流的情况,建议您关闭其他标签页。 检查浏览器是否支持WebRTC,如不支持,建议您更换浏览器。 检查应用相机权限是否打开。 检查移动设备后置摄像头是否能正常拍摄画面。
注意事项 了解坐标系 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"
视觉定位 接口列表 视觉定位需要使用的接口如表1所示。 表1 视觉定位接口列表 接口 描述 参数名 参数类型 参数说明 返回值 getToken 向服务器请求签名。 - - - Promise<any> setAKSK 验证租户身份信息。 requestParams { AK: string;
调试工具 常用的调试工具包括: 基于Chromium内核的浏览器(例如Edge、Chrome)的开发者工具(DevTools) Safari浏览器 父主题: 常用调试方法
空间位置追踪与渲染 接口列表 空间位置追踪与渲染需要使用到的接口如表1所示。 表1 空间位置追踪与渲染接口列表 接口 描述 参数名 参数类型 参数说明 返回值 createARSession 创建AR会话。 - - - Promise<void> setARStatus 设置AR状态。