检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
概述 SDK功能集成在HTFoundationOrigin预制体中,默认开启相机预览流、定位、资源加载与调试面板功能,主要功能包含导航、白膜显隐等。其主要是由HTSysEntrance和Canvas构成: HTSysEntrance:负责提供SDK功能并维护生命周期。 Canvas:负责提供示例界面UI。
调试方法 准备工作 您可根据实际情况选择如下任一组设备进行调试: 安卓手机、数据线、Windows系统电脑。 苹果手机、数据线、Mac系统电脑。 调试步骤 选择安卓手机调试。 用数据线连接手机、电脑,手机开启USB调试模式。 在Chrome浏览器输入:chrome://inspe
调试工具 调试工具包括: 安卓手机 Windows系统电脑 USB数据线 父主题: 常用调试方法
导航 导航需要使用到的接口如表1所示。 表1 导航接口列表 接口 描述 参数名 参数类型 参数说明 返回值 searchPoi POI智能搜索。 searchData { floor?: string; address?: string; title?: string; tag?:
开发指导 开发流程 开发流程请参考图1。 图1 开发流程图 开发过程 搜索POI。 // 创建获取POI的异步任务栈 var mPOICloud = new HTPOICloud(); // 将生命周期绑定到unity的生命周期 mPOICloud.Create("NAVIPOI");
注意事项 创建导航 // HTNavigationProvider是为导航模块提供参数与配置的类,通过对这个类的参数调整,可以对导航功能进行详细配置 mNaviProvider = new HTNavigationProvider(HTSystemManager.GetHTSystem()
概述 您可开启AR会话获取设备的图像、GPS坐标及传感器数据,启动SLAM从而进行视觉定位。 传感器包括陀螺仪、加速度计、磁力计。 父主题: 开启AR会话
概述 AR导航功能依赖视觉定位,提供空间位置追踪能力。 您可以依赖图像数据、相机矩阵及路径点信息进行3D导航路径渲染。 父主题: 实现AR导航
注意事项 模块之间启动销毁存在相关依赖需要按照一定顺序执行,HTSysEntrance需要最先执行。脚本执行顺序可见“Assets > HTFoundation > Scripts”中的SessionsManager.cs文件。 由于SDK的虚拟世界比较庞大,导致距离坐标世界原点
事件管理 事件管理使用到的接口如表1所示。 表1 事件管理接口列表 接口 描述 参数名 参数类型 参数说明 返回值 dispatchEvent 事件派发。 strId string 侦听事件id。 void data { [key: string]: DataType } 携带的数据。
开发指导 开发流程 创建和开发流程如图1所示。 图1 流程图 开发过程 配置AK/SK信息。 在新建的Unity工程“Assets > HTFoundation > Scripts > BaseUtils”中找到HTStringRes.cs,并在HTStringRes.cs配置A
开发指导 开发流程 图1 开启AR会话开发流程 开发过程 获取Token。 成功获取Token后才能进行定位请求。 // 向服务器请求签名 hwar.getToken().then((res) => { // 获取成功 }).catch((err) => { //
开发指导 开发流程 图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浏览器 父主题: 常用调试方法
cfg.ini调试方法 基本原理 您可以通过创建和修改应用目录下的cfg.ini文件调试信息配置,调试信息在配置文件中以键值对的形式存在。ini文件的配置目录如下: Unity:C:\...\AppData\LocalLow\{company name} \{product name}
注意事项 视频流无法正常获取原因排查 如果您无法获取视频流,建议您排查以下问题: 检查是否存在浏览器多个标签页同时申请获取视频流的情况,建议您关闭其他标签页。 检查浏览器是否支持WebRTC,如不支持,建议您更换浏览器。 检查应用相机权限是否打开。 检查移动设备后置摄像头是否能正常拍摄画面。
注意事项 了解坐标系 VPS坐标系 VPS坐标系是基于UTM坐标定义的,北向Y轴正向和东向X轴正向如图1所示。 图1 VPS坐标系示意图 Three.js渲染引擎坐标系 摆放虚拟物体时需要注意:Three.js的相机朝向是Z轴的反向。 图2 Three.js渲染引擎坐标系示意图 坐标系转换
SDK内部派发事件 SDK内部派发事件如表1所示。 表1 SDK内部派发事件列表 事件名称 描述 携带的数据 数据类型 事件说明 GYRO_STATUS 陀螺仪有效性检测。 gyro boolean 需要侦听回调,回调函数会接收到一个参数:event: { data: Object
空间位置追踪与渲染 接口列表 空间位置追踪与渲染需要使用到的接口如表1所示。 表1 空间位置追踪与渲染接口列表 接口 描述 参数名 参数类型 参数说明 返回值 createARSession 创建AR会话。 - - - Promise<void> setARStatus 设置AR状态。