检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备机型暂不支持。 开启AR会话状态，发送VPS请求获取定位数据。 通过回调函数（hwar.registerGetNewVpsPose）获取定位数据，如果获取失败，可通过侦听事件“VPS_FAIL”处理。 // 设置AR状态，第一个参数设为true表示开始发送VPS请求 hwar.setARStatus(true
准备工作 开发技能要求 具备TypeScript/JavaScript开发基础。 熟悉Web移动端开发。 熟悉Three.js、LayaAir等渲染库，可实现基于WebGL的3D渲染。 下载SDK 请下载WebARSDK软件包和软件包的完整性校验文件，并解压软件包、核对文件目录。 图1 SDK包目录结构
开发概述 WebARSDK简介 WebARSDK是一款轻量化JS-SDK，支持租户通过SDK快速集成和使用KooMap AR地图运行服务，开放能力的内存增加不大于3MB，运行时不依赖于Native App，可通过主流Web浏览器平台、主流终端设备的App内嵌WebView，实现WebAR体验。
代码示例 开启AR会话功能的代码样例，具体见WebARSDK包中hwar目录下的demo.html。 WebARSDK包的目录请参考图1。 父主题： WebARSDK使用手册
注意事项 了解坐标系 VPS坐标系 VPS坐标系是基于UTM坐标定义的，北向Y轴正向和东向X轴正向如图1所示。 图1 VPS坐标系示意图 Three.js渲染引擎坐标系 摆放虚拟物体时需要注意：Three.js的相机朝向是Z轴的反向。 图2 Three.js渲染引擎坐标系示意图 坐标系转换
WebARSDK使用手册 开发概述 总体开发思路 准备工作 快速开始 开启AR会话 实现AR导航 API列表 代码示例 常用调试方法
获取设备的相机时出错。一般是设备没有后置摄像头。 - - 需要侦听回调。回调函数无event参数。 VPS_FAIL VPS定位失败。可能是定位不在地图范围、定位超时等原因。 - - 需要侦听回调。回调函数无event参数。 接口调用及相机fov设置示例 // 以事件名"UPDATE_CAMERA_FOV"为例 hwar
number; utmCode: string; } registerGetNewVpsPose 设置定位成功回调函数。 funGetNewPose Function 回调函数。 需要接收两个参数： VPS请求接口的返回数据和世界坐标原点。 dictPoseData: { utmcode: string;
总体开发思路 使用WebARSDK开发移动端应用的工作流程如图1所示。 图1 工作流程 准备工作。 下载WebARSDK、收集AK/SK信息、开通关联服务。 创建H5移动端工程。 使用原生或者流行框架（如Vue、React）创建H5移动端工程。 引入WebARSDK文件。 下载、
在Mac电脑中，选择“Safari 浏览器 > 偏好设置”，单击“高级”，勾选“在菜单栏中显示‘开发’菜单”。 苹果手机开启调试模式。 苹果手机连接Mac电脑，打开手机Safari浏览器并运行Web页面。 在Mac电脑的Safari浏览器“开发”菜单下选择已连接的苹果手机，单击手机打开的Web页面进行调试。 父主题：
如果您无法获取视频流，建议您排查以下问题： 检查是否存在浏览器多个标签页同时申请获取视频流的情况，建议您关闭其他标签页。 检查浏览器是否支持WebRTC，如不支持，建议您更换浏览器。 检查应用相机权限是否打开。 检查移动设备后置摄像头是否能正常拍摄画面。 无法进行视觉定位原因排查 如
}); 进行视觉定位。 通过设置AR会话状态（hwar.setARStatus）或者触发手动定位（hwar.requestVps）发送定位请求，定位成功结果通过回调函数返回。 // 触发手动定位请求 hwar.requestVps(); // 设置定位成功回调函数 hwar.r
常用调试方法 调试工具 调试方法 父主题： WebARSDK使用手册
实现AR导航 概述 开发指导 注意事项 父主题： WebARSDK使用手册
API列表 WebARSDK封装类名为“hwar”，所有API均直接通过类“hwar”来调用，无需实例化。 本章节所指的GPS坐标系为WGS84坐标系。 utmCode指UTM（UNIVERSAL TRANSVERSE MERCARTOR GRID SYSTEM，通用横墨卡托格网系统）投影带号。
以工程Project为例，通过引入SDK脚本、传入AK/SK、调用API，验证工程中SDK是否引入正常，为后续功能开发做准备。 操作步骤 创建工程（Project），并将WebARSDK包解压后放入工程目录。 Project ├── index.html ├── src │ ├── index.js ├── hwar
setARStatus 设置AR状态。 isAR boolean 是否开启AR。 true：开启会话，开始发送请求。 false：关闭会话，停止发送请求。 void apkUuidIsUpdate boolean 是否更新会话。可选。 默认为false。 true：重置会话，重新进行VPS请求。 false：不重置会话。
开启AR会话 概述 开发指导 注意事项 父主题： WebARSDK使用手册
概述 您可开启AR会话获取设备的图像、GPS坐标及传感器数据，启动SLAM从而进行视觉定位。 传感器包括陀螺仪、加速度计、磁力计。 父主题： 开启AR会话
概述 AR导航功能依赖视觉定位，提供空间位置追踪能力。 您可以依赖图像数据、相机矩阵及路径点信息进行3D导航路径渲染。 父主题： 实现AR导航
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
