检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
快速开始 创建Unity项目。 新建一个Unity Project,“Template”选择“3D”。 导入ARFoundation包,并配置ARCore XR Plugin和ARKit XR Plugin。 打开工程里自动创建的Packages文件夹目录下的manifest.json
WebARSDK使用手册 开发概述 总体开发思路 准备工作 快速开始 开启AR会话 实现AR导航 API列表 代码示例 常用调试方法
注意事项 视频流无法正常获取原因排查 如果您无法获取视频流,建议您排查以下问题: 检查是否存在浏览器多个标签页同时申请获取视频流的情况,建议您关闭其他标签页。 检查浏览器是否支持WebRTC,如不支持,建议您更换浏览器。 检查应用相机权限是否打开。 检查移动设备后置摄像头是否能正常拍摄画面
注意事项 了解坐标系 VPS坐标系 VPS坐标系是基于UTM坐标定义的,北向Y轴正向和东向X轴正向如图1所示。 图1 VPS坐标系示意图 Three.js渲染引擎坐标系 摆放虚拟物体时需要注意:Three.js的相机朝向是Z轴的反向。 图2 Three.js渲染引擎坐标系示意图 坐标系转换
概述 AR导航功能依赖视觉定位,进行空间位置跟踪。它将会根据当前位置信息及终点信息获取路径点信息,然后进行3D虚拟世界渲染操作。 其包含的功能主要有路线规划及导航指示: 路线规划:根据目的地和当前位置,自动规划合适的路线。 导航指示:引导用户沿着设定的路线前进,并在需要时提供转弯提示等导航信息
代码示例 开启AR会话功能的代码样例,具体见WebARSDK包中hwar目录下的demo.html。 WebARSDK包的目录请参考图1。 父主题: WebARSDK使用手册
AR导航 概述 开发指导 注意事项 父主题: HTSDK使用手册
代码示例 完整的示例代码在SDK压缩包Cyberverse-HTFoundation.zip的Demo.zip中。 您可在创建完成后的Unity项目中找到对应的示例代码。 父主题: HTSDK使用手册
API是否支持集成到第三方产品中 如果用户需要将KooMap服务集成到第三方系统用于二次开发,请使用API方式访问KooMap服务,具体操作和描述请参见如何调用API。 父主题: API使用
常用调试方法 调试工具 cfg.ini调试方法 父主题: HTSDK使用手册
API列表 WebARSDK封装类名为“hwar”,所有API均直接通过类“hwar”来调用,无需实例化。 本章节所指的GPS坐标系为WGS84坐标系。 utmCode指UTM(UNIVERSAL TRANSVERSE MERCARTOR GRID SYSTEM,通用横墨卡托格网系统
开启AR会话 概述 开发指导 注意事项 父主题: WebARSDK使用手册
调试方法 准备工作 您可根据实际情况选择如下任一组设备进行调试: 安卓手机、数据线、Windows系统电脑。 苹果手机、数据线、Mac系统电脑。 调试步骤 选择安卓手机调试。 用数据线连接手机、电脑,手机开启USB调试模式。 在Chrome浏览器输入:chrome://inspect
调试工具 调试工具包括: 安卓手机 Windows系统电脑 USB数据线 父主题: 常用调试方法
导航 导航需要使用到的接口如表1所示。 表1 导航接口列表 接口 描述 参数名 参数类型 参数说明 返回值 searchPoi POI智能搜索。 searchData { floor?: string; address?: string; title?: string; tag?:
事件管理 事件管理使用到的接口如表1所示。 表1 事件管理接口列表 接口 描述 参数名 参数类型 参数说明 返回值 dispatchEvent 事件派发。 strId string 侦听事件id。 void data { [key: string]: DataType } 携带的数据
注意事项 模块之间启动销毁存在相关依赖需要按照一定顺序执行,HTSysEntrance需要最先执行。脚本执行顺序可见“Assets > HTFoundation > Scripts”中的SessionsManager.cs文件。 由于SDK的虚拟世界比较庞大,导致距离坐标世界原点较远的虚拟资源坐标值很大
cfg.ini调试方法 基本原理 您可以通过创建和修改应用目录下的cfg.ini文件调试信息配置,调试信息在配置文件中以键值对的形式存在。ini文件的配置目录如下: Unity:C:\...\AppData\LocalLow\{company name} \{product name
视觉定位 接口列表 视觉定位需要使用的接口如表1所示。 表1 视觉定位接口列表 接口 描述 参数名 参数类型 参数说明 返回值 getToken 向服务器请求签名。 - - - Promise<any> setAKSK 验证租户身份信息。 requestParams { AK: string
SDK内部派发事件 SDK内部派发事件如表1所示。 表1 SDK内部派发事件列表 事件名称 描述 携带的数据 数据类型 事件说明 GYRO_STATUS 陀螺仪有效性检测。 gyro boolean 需要侦听回调,回调函数会接收到一个参数:event: { data: Object