检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
请下载Cyberverse-HTFoundation安装包和安装包完整性校验文件。 搭建开发环境 准备Windows，安装Unity2020或以上版本以及Visual Studio。 准备iOS环境，安装Xcode。 准备Android环境，安装Android Studio。 如果您需要在华为手机上使用SDK，请咨询华为云专业服务团队。
注意事项 了解坐标系 VPS坐标系 VPS坐标系是基于UTM坐标定义的，北向Y轴正向和东向X轴正向如图1所示。 图1 VPS坐标系示意图 Three.js渲染引擎坐标系 摆放虚拟物体时需要注意：Three.js的相机朝向是Z轴的反向。 图2 Three.js渲染引擎坐标系示意图 坐标系转换
} 初始化配置参数。 access：认证用的AK。 secret：认证用的SK。 beforeLocateDelta：首次定位成功前每隔几秒触发一次自动请求。 afterLocateDelta：定位成功后每隔几秒触发一次自动请求。 autoRequest：是否开启Vps自动请求。
准备工作 您可根据实际情况选择如下任一组设备进行调试： 安卓手机、数据线、Windows系统电脑。 苹果手机、数据线、Mac系统电脑。 调试步骤 选择安卓手机调试。 用数据线连接手机、电脑，手机开启USB调试模式。 在Chrome浏览器输入：chrome://inspect/#d
调试工具 调试工具包括： 安卓手机 Windows系统电脑 USB数据线 父主题： 常用调试方法
区域，用户可进行3D实景步行导引，无需担心GPS信号弱的环境。 工作原理 WebARSDK通过设备传入的图像及传感器数据，调用视觉定位（VPS）和导航服务，以及SLAM（同步定位与地图构建）算法，为您的应用提供环境感知与交互感知能力，再经应用渲染给用户呈现虚实融合体验。 图1 WebARSDK工作原理
Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。Token可通过调用获取用户Token接口获取。 云服务存在两种部署方式：项目级服务和全局级服务。其中： 项目级服务需要获取项目级别的Token，此时请求body中“auth.scope”的取值为“project”。
Key，SK）两部分，是您在华为云的长期身份凭证。华为云通过AK识别访问用户的身份，通过SK对请求数据进行签名验证，用于确保请求的机密性、完整性和请求者身份的正确性。 获取方法请参见访问密钥。 开通关联服务 开通AR地图运行服务。 环境要求 已安装微信开发者工具。 移动设备已配置后置摄像头、陀螺仪、加速度传感器、GPS芯片等器件。
onErrTooLarge” 原因一：可能是发起定位时使用的图片纹理特征不够明显。 解决方案：在移动端，对着纹理丰富的区域单击“手动请求Vps”重新发起定位。 原因二：可能是平面识别未初始化完成。 解决方案： 查看camera的position和rotation数值。 如果pos
AR地图服务通过AR地图生产和AR地图运行来实现基于视觉定位（VPS）的AR内容展示和AR导航。应用到具体项目时，应妥善选取场景。若场景选取不合适，可能导致视觉定位效果不佳，影响最终的AR内容展示和AR导航。 场景选取总体原则： VPS定位能力与人的视觉定位能力类似，需要捕捉环境中的特征点
携带数据 数据类型 数据说明 事件说明 VPS_RESULT Vps定位结果事件。 status boolean 定位是否成功。 Vps定位结果返回时触发该事件。 info string 具体定位结果信息。 VPS_TRACKING Vps跟踪状态事件。 status boolean
验证视觉定位效果时，您需竖屏正向手持设备扫描周边环境。 检查定位区域是否在地图服务范围内。 按“F12”打开DevTools，在“Network”页签中查看“vps”的状态码。如果状态码为“400”，请在“Response”页签中查看“error_msg”内容，如显示“access denied, out
示例。 修改工程配置。 单击菜单“Custom Tools > Set HTFoundation Config”自动设置工程所需配置项。详情见配置项目选项。 配置AK/SK。 包含访问密钥ID（AK）和秘密访问密钥（SK）两部分，是用户在华为云的长期身份凭证。华为云通过AK识别访
数据传输 是否支持将数据导入至线下IDC或第三方云，导入时是否有访问时延要求
运营分析 服务会记录哪些用户行为数据
如何调用API 构造请求 认证鉴权 返回结果
附录 状态码 错误码
安全 责任共担 身份认证与访问控制 数据保护技术 审计与日志 认证证书
API列表 调用前须知 视觉定位 空间位置追踪与渲染 导航 事件管理 SDK内部派发事件 父主题： WebARSDK使用手册
API列表 调用前准备工作 视觉定位 事件 日志 其他 父主题： XRLightSDK使用手册
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
