检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
事件管理 事件管理使用到的接口如表1所示。 表1 事件管理接口列表 接口 描述 参数名 参数类型 参数说明 返回值 dispatchEvent 事件派发。 strId string 侦听事件id。 void data { [key: string]: DataType } 携带的数据。
开启AR会话方案概述 您可开启AR会话获取设备的图像、GPS坐标及传感器数据，启动SLAM从而进行视觉定位。 视觉定位成功后，您可获取到当前位置的坐标信息，并在附近渲染数字内容，从而构建虚实融合的世界。 传感器包括陀螺仪、加速度计、磁力计。 父主题： 开启AR会话
注意事项 视频流无法正常获取原因排查 如果您无法获取视频流，建议您排查以下问题： 检查是否存在浏览器多个标签页同时申请获取视频流的情况，建议您关闭其他标签页。 检查浏览器是否支持WebRTC，如不支持，建议您更换浏览器。 检查应用相机权限是否打开。 检查移动设备后置摄像头是否能正常拍摄画面。
注意事项 了解坐标系 VPS坐标系 VPS坐标系是基于UTM坐标定义的，北向Y轴正向和东向X轴正向如图1所示。 图1 VPS坐标系示意图 Three.js渲染引擎坐标系 摆放虚拟物体时需要注意：Three.js的相机朝向是Z轴的反向。 图2 Three.js渲染引擎坐标系示意图 坐标系转换
cfg.ini调试方法 基本原理 您可以通过创建和修改应用目录下的cfg.ini文件调试信息配置，调试信息在配置文件中以键值对的形式存在。ini文件的配置目录如下： Unity：C:\...\AppData\LocalLow\{company name} \{product name}
调用前须知 调用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地图运行服务。 父主题： 常见问题
定位失败，定位结果显示“invalid url” 检查初始化视觉定位模块时，config参数中配置的url是否正确。url为https://koomap.cn-north-4.myhuaweicloud.com。 父主题： 常见问题
SDK内部派发事件 SDK内部派发事件如表1所示。 表1 SDK内部派发事件列表 事件名称 描述 携带的数据 数据类型 事件说明 GYRO_STATUS 陀螺仪有效性检测。 gyro boolean 需要侦听回调，回调函数会接收到一个参数：event: { data: Object
定位失败，定位结果显示“Incorrect IAM” 检查初始化视觉定位模块时，config参数中配置的AK、SK是否正确。获取方法请参见访问密钥。 父主题： 常见问题
空间位置追踪与渲染 接口列表 空间位置追踪与渲染需要使用到的接口如表1所示。 表1 空间位置追踪与渲染接口列表 接口 描述 参数名 参数类型 参数说明 返回值 createARSession 创建AR会话。 - - - Promise<void> setARStatus 设置AR状态。
定位失败，定位结果显示“FewPnPInliers”或“ErrorMeanReprojectionErrTooLarge” 原因一：可能是发起定位时使用的图片纹理特征不够明显。 解决方案：在移动端，对着纹理丰富的区域单击“手动请求Vps”重新发起定位。 原因二：可能是平面识别未初始化完成。
定位后报错，日志显示“Cannot read properties of undefined（reading ‘position‘）” 在components/xr-start/index.wxml文件里找到xr-camera ，然后在它的上一行加上node-id="cameraParent"的节点，如图1所示。
是否支持将数据导入至线下IDC或第三方云，导入时是否有访问时延要求 当前仅支持通过华为云APIG的REST接口进行数据传输。用户需按照API调用要求完成数据的格式整理和上报，暂不支持其他对接方式。数据导入时无访问时延要求。 父主题： 数据传输
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
