检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API列表 调用前须知 视觉定位 空间位置追踪与渲染 导航 事件管理 SDK内部派发事件 父主题: WebARSDK使用手册
注意事项 模块之间启动销毁存在相关依赖需要按照一定顺序执行,HTSysEntrance需要最先执行。脚本执行顺序可见“Assets > HTFoundation > Scripts”中的SessionsManager.cs文件。 由于SDK的虚拟世界比较庞大,导致距离坐标世界原点
导航路径,实现空间位置追踪导航;开发者基于SDK输出的图像数据、相机矩阵、路径信息,实现3D数字内容渲染。 父主题: WebARSDK使用手册
概述 您可开启AR会话获取设备的图像、GPS坐标及传感器数据,启动SLAM从而进行视觉定位。 传感器包括陀螺仪、加速度计、磁力计。 父主题: 开启AR会话
概述 AR导航功能依赖视觉定位,提供空间位置追踪能力。 您可以依赖图像数据、相机矩阵及路径点信息进行3D导航路径渲染。 父主题: 实现AR导航
开发指导 开发流程 开发流程请参考图1。 图1 开发流程图 开发过程 搜索POI。 // 创建获取POI的异步任务栈 var mPOICloud = new HTPOICloud(); // 将生命周期绑定到unity的生命周期 mPOICloud.Create("NAVIPOI");
调试方法 准备工作 您可根据实际情况选择如下任一组设备进行调试: 安卓手机、数据线、Windows系统电脑。 苹果手机、数据线、Mac系统电脑。 调试步骤 选择安卓手机调试。 用数据线连接手机、电脑,手机开启USB调试模式。 在Chrome浏览器输入:chrome://inspe
调试工具 调试工具包括: 安卓手机 Windows系统电脑 USB数据线 父主题: 常用调试方法
开发指导 开发流程 图1 AR导航启动流程 开发过程 开启AR会话。 选定终点位置。 通过POI智能搜索(hwar.searchPoi)选定终点坐标。 // POI智能搜索 hwar.searchPoi({ "floor": "1F", "address": "xxx"
调试工具 常用的调试工具包括: 基于Chromium内核的浏览器(例如Edge、Chrome)的开发者工具(DevTools) Safari浏览器 父主题: 常用调试方法
注意事项 如果您无法获取视频流,建议排查以下问题: 检查小程序相机权限是否打开。 检查移动设备后置摄像头是否能正常拍摄画面。 父主题: 开启AR会话
开启AR会话方案概述 您可开启AR会话获取设备的图像、GPS坐标及传感器数据,启动SLAM从而进行视觉定位。 视觉定位成功后,您可获取到当前位置的坐标信息,并在附近渲染数字内容,从而构建虚实融合的世界。 传感器包括陀螺仪、加速度计、磁力计。 父主题: 开启AR会话
注意事项 视频流无法正常获取原因排查 如果您无法获取视频流,建议您排查以下问题: 检查是否存在浏览器多个标签页同时申请获取视频流的情况,建议您关闭其他标签页。 检查浏览器是否支持WebRTC,如不支持,建议您更换浏览器。 检查应用相机权限是否打开。 检查移动设备后置摄像头是否能正常拍摄画面。
注意事项 了解坐标系 VPS坐标系 VPS坐标系是基于UTM坐标定义的,北向Y轴正向和东向X轴正向如图1所示。 图1 VPS坐标系示意图 Three.js渲染引擎坐标系 摆放虚拟物体时需要注意:Three.js的相机朝向是Z轴的反向。 图2 Three.js渲染引擎坐标系示意图 坐标系转换
事件管理 事件管理使用到的接口如表1所示。 表1 事件管理接口列表 接口 描述 参数名 参数类型 参数说明 返回值 dispatchEvent 事件派发。 strId string 侦听事件id。 void data { [key: string]: DataType } 携带的数据。
调用前须知 调用API前,您需提前了解如下内容: WebARSDK封装类名为“hwar”,所有API均直接通过类“hwar”来调用,无需实例化。 下文API中的GPS坐标系为WGS84坐标系。 utmCode指UTM(Universal Transverse Mercator Grid
调用前准备工作 XRLightSDK封装类名为“XRClient”,所有API均直接通过类“XRClient”来调用,无需实例化。 在调用SDK前,需在文件头部引入XRClient类。 import { XRClient } from "../../SDK/XRClient"; 父主题:
定位失败,定位结果显示“OutOfService” 登录KooMap管理控制台,检查是否开通了AR地图运行服务,如未开启,请开通AR地图运行服务。 父主题: 常见问题
SDK内部派发事件 SDK内部派发事件如表1所示。 表1 SDK内部派发事件列表 事件名称 描述 携带的数据 数据类型 事件说明 GYRO_STATUS 陀螺仪有效性检测。 gyro boolean 需要侦听回调,回调函数会接收到一个参数:event: { data: Object
空间位置追踪与渲染 接口列表 空间位置追踪与渲染需要使用到的接口如表1所示。 表1 空间位置追踪与渲染接口列表 接口 描述 参数名 参数类型 参数说明 返回值 createARSession 创建AR会话。 - - - Promise<void> setARStatus 设置AR状态。