检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
准备工作 开通关联服务 开通AR地图运行服务。 AR地图运行服务可在KooMap管理控制台开通。 开发技能要求 熟悉C#语言开发。 熟悉Unity3D开发。 下载SDK 请下载Cyberverse-HTFoundation安装包和安装包完整性校验文件。 搭建开发环境 准备Wind
AR导航 功能介绍 AR导航是新型的地图导航方法，基于摄像头实时捕捉的实景画面，将地图导航信息通过数字内容的形态叠加在实景画面中，生成虚拟的3D导航指引。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
支持云审计的关键操作 操作场景 平台提供了云审计服务（Cloud Trace Service，简称CTS）。通过云审计服务，可记录与KooMap相关的操作事件，便于日后的查询、审计和回溯。 前提条件 已开通云审计服务。 支持审计的关键操作列表 表1 云审计服务支持的KooMap操作列表
开发指导 开发流程 开发流程请参考图1。 图1 开发流程图 开发过程 搜索POI。 // 创建获取POI的异步任务栈 var mPOICloud = new HTPOICloud(); // 将生命周期绑定到unity的生命周期 mPOICloud.Create("NAVIPOI");
审计与日志 云审计服务（Cloud Trace Service，CTS），是华为云安全解决方案中专业的日志审计服务，提供对各种云资源操作记录的收集、存储和查询功能，可用于支撑安全分析、合规审计、资源跟踪和问题定位等常见应用场景。 用户开通云审计服务并创建和配置追踪器后，CTS可记
事件管理 事件管理使用到的接口如表1所示。 表1 事件管理接口列表 接口 描述 参数名 参数类型 参数说明 返回值 dispatchEvent 事件派发。 strId string 侦听事件id。 void data { [key: string]: DataType } 携带的数据。
空间位置追踪与渲染 接口列表 空间位置追踪与渲染需要使用到的接口如表1所示。 表1 空间位置追踪与渲染接口列表 接口 描述 参数名 参数类型 参数说明 返回值 createARSession 创建AR会话。 - - - Promise<void> setARStatus 设置AR状态。
SDK内部派发事件 SDK内部派发事件如表1所示。 表1 SDK内部派发事件列表 事件名称 描述 携带的数据 数据类型 事件说明 GYRO_STATUS 陀螺仪有效性检测。 gyro boolean 需要侦听回调，回调函数会接收到一个参数：event: { data: Object
视觉定位 接口列表 视觉定位需要使用的接口如表1所示。 表1 视觉定位接口列表 接口 描述 参数名 参数类型 参数说明 返回值 getToken 向服务器请求签名。 - - - Promise<any> setAKSK 验证租户身份信息。 requestParams { AK: string;
常见问题 定位失败，定位结果显示“Incorrect IAM” 定位失败，定位结果显示“OutOfService” 定位失败，定位结果显示“invalid url” 定位后报错，日志显示“Cannot read properties of undefined（reading ‘position‘）”
注意事项 了解坐标系 VPS坐标系 VPS坐标系是基于UTM坐标定义的，北向Y轴正向和东向X轴正向如图1所示。 图1 VPS坐标系示意图 Three.js渲染引擎坐标系 摆放虚拟物体时需要注意：Three.js的相机朝向是Z轴的反向。 图2 Three.js渲染引擎坐标系示意图 坐标系转换
快速开始 创建Unity项目。 新建一个Unity Project，“Template”选择“3D”。 导入ARFoundation包，并配置ARCore XR Plugin和ARKit XR Plugin。 打开工程里自动创建的Packages文件夹目录下的manifest.json文件，在manifest
状态码 常用状态码请参见表1。 表1 请求状态返回码 状态码 描述 说明 200 OK 服务器已成功处理了请求。 400 Bad Request 非法请求。 建议直接修改该请求，不要重试该请求。 403 Forbidden 请求被拒绝访问。 返回该状态码，表明请求能够到达服务端，
快速开始 以工程Project为例，通过引入SDK脚本、传入AK/SK、调用API，验证工程中SDK是否引入正常，为后续功能开发做准备。 操作步骤 创建工程（Project），并将WebARSDK包解压后放入工程目录。 Project ├── index.html ├── src
返回结果 状态码 请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对AR导航接口，如果调用后返回状态码为“200”，则表示请求成功。 响应消息头 对应请求消息头，响应
总体开发思路 使用HTFoundation示例开发移动端应用的工作流程如图1所示。 图1 工作流程 创建一个新的工程目录。 使用Unity3D引擎创建基础工程，基础工程里面会有一个空的工程目录。详情见创建Unity项目。 导入ARFoundation插件包。 在Unity的Packages文件夹中找到manifest
与其他服务的关系 表1 KooMap与其他服务的依赖关系 服务名称 KooMap与其他服务的关系 主要交互功能 对象存储服务（Object Storage Service，OBS） 原始数据通过对象存储服务的OBS桶来存储，KooMap从OBS加载原始数据完成AR地图生产服务。 从OBS下载原始数据至KooMap。
开通KooMap KooMap当前提供了AR地图生产服务和AR地图运行服务。 AR地图生产服务：对外业采集的图像数据进行加工处理，生成AR地图成果数据，供AR地图运行服务使用。 AR地图运行服务：基于高精度AR地图，提供厘米级高精度的视觉定位和AR导航，支持用户在物理空间中进行AR内容的展示，构建虚实交互应用体验。
套餐包 如果购买了套餐包，已购买套餐包不支持退订，请谨慎购买。 套餐包是一种先付费再使用的计费模式，适用于对产品需求稳定且希望降低成本的用户。 套餐包有效期为1年。 目前，套餐支持按需套餐包，购买按需套餐包后，使用时优先扣除套餐包额度，超出部分按需计费。 套餐包详情 用户可以根据实际需求购买套餐包获取更多的优惠。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
