检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
开发概述 WebARSDK简介 WebARSDK是一款轻量化JS-SDK,支持租户通过SDK快速集成和使用KooMap AR地图运行服务,开放能力的内存增加不大于3MB,运行时不依赖于Native App,可通过主流Web浏览器平台、主流终端设备的App内嵌WebView,实现WebAR体验。
开发指导 开发流程 图1 开启AR会话开发流程 开发过程 获取Token。 成功获取Token后才能进行定位请求。 // 向服务器请求签名 hwar.getToken().then((res) => { // 获取成功 }).catch((err) => { //
开发指导 开发流程 图1 AR导航启动流程 开发过程 开启AR会话。 选定终点位置。 通过POI智能搜索(hwar.searchPoi)选定终点坐标。 // POI智能搜索 hwar.searchPoi({ "floor": "1F", "address": "xxx"
总体开发思路 使用WebARSDK开发移动端应用的工作流程如图1所示。 图1 工作流程 准备工作。 下载WebARSDK、收集AK/SK信息、开通关联服务。 创建H5移动端工程。 使用原生或者流行框架(如Vue、React)创建H5移动端工程。 引入WebARSDK文件。 下载、
开发概述 HTSDK是接入KooMap AR地图运行服务的端侧SDK,助力于快速构建真实和虚拟融合世界。HTFoundation是适配HTSDK的示例代码,供用户在Unity3D中开发业务。 HTFoundation示例实现了真实世界构建、世界位姿定位和跟踪、虚实世界呈现。基于H
准备工作 开发技能要求 具备TypeScript/JavaScript开发基础。 熟悉Web移动端开发。 熟悉Three.js、LayaAir等渲染库,可实现基于WebGL的3D渲染。 下载SDK 请下载WebARSDK软件包和软件包的完整性校验文件,并解压软件包、核对文件目录。
WebARSDK使用手册 开发概述 总体开发思路 准备工作 快速开始 开启AR会话 实现AR导航 API列表 代码示例 常用调试方法
以工程Project为例,通过引入SDK脚本、传入AK/SK、调用API,验证工程中SDK是否引入正常,为后续功能开发做准备。 操作步骤 创建工程(Project),并将WebARSDK包解压后放入工程目录。 Project ├── index.html ├── src │ ├──
需要接收两个参数: VPS请求接口的返回数据和世界坐标原点。 dictPoseData: { utmcode: string; vpsFloor: string; pose: { r: number[], t: number[]} } dictPoseData.pose.r是VPS姿态矩阵 dictPoseData
注意事项 了解坐标系 VPS坐标系 VPS坐标系是基于UTM坐标定义的,北向Y轴正向和东向X轴正向如图1所示。 图1 VPS坐标系示意图 Three.js渲染引擎坐标系 摆放虚拟物体时需要注意:Three.js的相机朝向是Z轴的反向。 图2 Three.js渲染引擎坐标系示意图 坐标系转换
代码示例 开启AR会话功能的代码样例,具体见WebARSDK包中hwar目录下的demo.html。 WebARSDK包的目录请参考图1。 父主题: WebARSDK使用手册
总体开发思路 使用HTFoundation示例开发移动端应用的工作流程如图1所示。 图1 工作流程 创建一个新的工程目录。 使用Unity3D引擎创建基础工程,基础工程里面会有一个空的工程目录。详情见创建Unity项目。 导入ARFoundation插件包。 在Unity的Packages文件夹中找到manifest
开启AR会话 概述 开发指导 注意事项 父主题: WebARSDK使用手册
调试工具 常用的调试工具包括: 基于Chromium内核的浏览器(例如Edge、Chrome)的开发者工具(DevTools) Safari浏览器 父主题: 常用调试方法
偏好设置”,单击“高级”,勾选“在菜单栏中显示‘开发’菜单”。 苹果手机开启调试模式。 苹果手机连接Mac电脑,打开手机Safari浏览器并运行Web页面。 在Mac电脑的Safari浏览器“开发”菜单下选择已连接的苹果手机,单击手机打开的Web页面进行调试。 父主题: 常用调试方法
API列表 WebARSDK封装类名为“hwar”,所有API均直接通过类“hwar”来调用,无需实例化。 本章节所指的GPS坐标系为WGS84坐标系。 utmCode指UTM(UNIVERSAL TRANSVERSE MERCARTOR GRID SYSTEM,通用横墨卡托格网系统)投影带号。
开发指导 开发流程 开发流程请参考图1。 图1 开发流程图 开发过程 搜索POI。 // 创建获取POI的异步任务栈 var mPOICloud = new HTPOICloud(); // 将生命周期绑定到unity的生命周期 mPOICloud.Create("NAVIPOI");
开发指导 开发流程 创建和开发流程如图1所示。 图1 流程图 开发过程 配置AK/SK信息。 在新建的Unity工程“Assets > HTFoundation > Scripts > BaseUtils”中找到HTStringRes.cs,并在HTStringRes.cs配置A
需要侦听回调。回调函数无event参数。 NO_SRTEAM 获取设备的相机时出错。一般是设备没有后置摄像头。 - - 需要侦听回调。回调函数无event参数。 VPS_FAIL VPS定位失败。可能是定位不在地图范围、定位超时等原因。 - - 需要侦听回调。回调函数无event参数。 接口调用及相机fov设置示例
导航 导航需要使用到的接口如表1所示。 表1 导航接口列表 接口 描述 参数名 参数类型 参数说明 返回值 searchPoi POI智能搜索。 searchData { floor?: string; address?: string; title?: string; tag?: