-
调试选项 loglevel：UPDATE|INFO|WARNING|ASSERT|EXCEPTION|ERROR|NONE 日志级别左边包含右边的日志信息，即UPDATE级别会打印所有日志信息，使用该字段会打印HTDebug的日志，并写日志到此文件的上一级文件目录。NONE表示不保存log。 debugger_ctrl_switch：ON|OFF 是否在日志中显示调试面板，只对HTAppUIType中mNativeAppIds包含的应用包名有效。 fixed_location_switch：ON|OFF 是否使用自定义的固定位置。 longitude 经度，填写固定位置经纬的值，只在“fixed_location_switch”为“ON”时有效。 latitude 纬度，填写固定位置纬度的值，只在“fixed_location_switch”为“ON”时有效。
-
快速开始 使用微信
开发者工具 创建小程序工程，导入SDK。 本文档使用的微信开发者工具版本为Nightly 1.06.2411282。 使用微信号登录微信开发者工具。 新建微信小程序工程。 单击“新建项目”，进入“创建小程序”页面。 图1 创建小程序 在“项目名称”文本框中填写项目名称。 “目录”选择项目存放的路径。 “AppID”选择“测试号”。 “后端服务”选择“不使用云服务”。 “开发模式”选择“小程序”。 “模板选择”选“不使用模板”。 单击“创建”，完成小程序工程创建。创建完成后，工程目录如图2。 图2 目录名称 新建文件并导入SDK。 在工具的资源管理器，单击右键，选择“新建文件”，新建文件“app.json”，并在app.json中配置页面（pages），代码如下： {
"pages": [
"pages/index/index"
]
} 单击右键，选择“新建文件”，新建文件“app.js”。 按Ctrl+S组合键，保存并编译，工具会自动生成pages文件夹及文件夹下的文件。 下载并解压CyberverseXRLightSDK软件包。 打开工程目录，将解压后得到的build文件夹复制到pages同级目录。 图3 导入SDK后目录 调用SDK，获取版本号。 在“index.js”文件的第一行导入XRClient。 import { XRClient } from "../../build/XRClient"; 在“index.js”文件的onLoad方法里打印SDK版本号。 onLoad(options) {
console.log(XRClient.getVersion())
}, 真机调试，验证结果。 自动调试前，确保移动端设备的微信在前台运行，且与开发者工具登录的是同一个账号。 在微信开发者工具中，单击“真机调试”。 根据移动端设备情况选择“启动 Android 端自动真机调试”或 “启动 iOS 端自动真机调试”。 XRLightSDK是基于XRFrame方案的AR应用，不支持PC端调试。 单击“编译并自动调试”，弹出“真机调试”窗口。 图4 真机调试 在“Console”页签下，查看输出的内容，如果打印了SDK版本号信息，说明引入SDK成功。 图5 查看SDK版本信息 父主题： XRLightSDK使用手册
-
步骤1：新增项目 登录KooMap服务控制台，进入控制台页面。 在左侧导航栏，选择“AR地图”下的“项目管理”菜单，进入“项目管理”页面。 在“项目管理”页面，单击“新增项目”。 在“新增项目”弹窗中，参考表1填写项目相关信息。 表1 新增项目 配置项 配置说明 项目名称 必填项。 输入项目名称。 名称不可重复。 行政区域 必选项。 选择项目覆盖的行政区域。 项目描述 选填项。 根据界面提示输入有关项目描述信息。 单击“确定”，完成新增项目的创建。
-
步骤2：上传数据 在“项目管理”页面，单击项目名称（蓝色字体），进入该项目详情页。 单击“上传数据”，根据表2填写待上传数据的相关信息。 表2 上传数据配置参数 配置项 配置说明 数据名称 必填项。 输入数据名称。 名称不可重复。 数据类型 必选项。 目前仅支持“Insta360”。 上传数据 单击“上传文件夹”上传本地的全景视频。 如果上传数据选择错误，可删除重新上传。 数据描述 选填项。 输入待上传数据的相关描述。 单击“确定”，开始上传数据。 上传数据完成后，显示“完成”对话框。
-
提交地图生产 登录KooMap管理控制台。 在左侧导航栏的“AR地图”下选择“项目管理”。 在“项目管理”页面，单击项目名称（蓝色字体），进入“项目详情”页面。 在数据列表选择注册成功的数据，单击操作列下的“注册调整”，在“注册调整”弹窗内核对地图注册结果。 如对注册结果不满意，可手动调整注册结果的坐标位置及角度。 图1 注册调整 单击“确定”进行地图生成阶段。 地图生产完成后，“地图生成”列显示为“生成成功”。
-
注册地图数据到地球坐标系 登录KooMap管理控制台。 在左侧导航栏的“AR地图”下选择“项目管理”。 在“项目管理”页面，单击项目名称（蓝色字体），进入“项目详情”页面。 在数据列表选择预处理成功的数据，单击操作列下的“提交生产”。 图1 预览轨迹 在“空间预览轨迹”弹窗中核对轨迹是否与实际采图轨迹相符。 如您对轨迹不满意，则需要重新采集数据并上传数据再次进行预处理。 单击“提交生产”进行地图注册。 注册完成后，“地图注册”列显示“注册成功”。
-
在项目内上传数据 登录KooMap管理控制台。 在左侧导航栏的“AR地图”下选择“项目管理”。 在“项目管理”页面，单击项目名称（蓝色字体），进入“项目详情”页面。 单击“上传数据”，根据表1填写待上传数据的相关信息。 表1 上传数据配置参数 配置项 配置说明 数据名称 必填项。 输入数据名称。 名称不可重复。 数据类型 必选项。 目前仅支持“Insta360”。 上传数据 单击“上传文件夹”上传本地的全景视频。 如上传数据错误，可删除重新上传。 数据描述 选填项。 输入待上传数据的相关描述。 单击“确定”，开始上传数据。 您还可以对数据上传任务做如下操作： 查看全部：单击此按钮查看当前任务下全部文件上传进度。 查看激活的：单击此按钮查看当前任务下正在上传的文件上传进度。 继续上传：状态为“失败”时（断网、异常关机、刷新或重启浏览器等情况导致），单击此按钮重新选择数据上传。 移除：单击此按钮移除当前上传任务/文件。 取消：单击此按钮取消文件上传。 数据上传完成后，自动进入预处理阶段。 预处理完成后，“数据状态”为“预处理成功”。
-
如何管理项目 登录KooMap管理控制台。 在左侧导航栏的“AR地图”下选择“项目管理”。 在“项目管理”页面，参考表1管理项目。 表1 管理项目操作说明 操作 操作步骤 操作结果 项目详情查看 单击待查看项目操作列下的“查看详情”。 在“项目详情”中查看该项目的相关信息。 查看到项目的相关信息，包括项目的基本信息和该在项目内已上传的数据列表。 查询项目 在右上角设置项目名称、行政区域作为过滤条件。 单击，界面显示符合过滤条件的全部项目。 界面显示符合过滤条件的所有项目。 编辑项目 方式一： 单击待编辑项目操作列下的“编辑”。 在弹出来的“编辑项目信息”弹窗中，修改项目信息。 单击“确定”，完成信息的修改。 完成项目相关信息的修改。 方式二： 单击待编辑项目操作列下的“查看详情”。 在“项目详情”页面，单击“项目信息”右侧的。 在弹出来的“编辑项目信息”弹窗中，修改项目信息。 单击“确定”，完成信息的修改。 删除项目 单个删除： 单击项目操作列下的“删除”。 在弹出的窗口中单击“是”，完成删除。 项目被删除，并从界面的项目列表中移除。 批量删除： 勾选待删除的项目。 单击“批量删除”。 在弹出的窗口中单击“是”，完成删除。
-
新增项目 开通AR地图生产服务后，您可根据实际需求按照如下操作步骤新增项目，并在项目中设置的行政区域内生产对应的AR地图，形成AR地图覆盖区。 登录KooMap管理控制台。 在左侧导航栏的“AR地图”下选择“项目管理”，然后在右侧页面单击“新增项目”。 在“新增项目”弹窗中，根据表1配置项目名称、行政区域以及项目描述，单击“确定”。 表1 新增项目 配置项 配置说明 项目名称 必填项。 输入项目名称。 名称不可重复。 行政区域 必选项。 选择项目覆盖的行政区域。 项目描述 选填项。 输入待新增项目的相关描述。 新建的项目将显示在项目列表最前端。 父主题： 新增与管理AR地图生产服务项目
-
服务概览 开通AR地图运行服务或者AR地图生产服务后，您可在左侧导航栏选择“AR地图”下的“服务概览”菜单，做如下操作： 查看该服务相关信息，比如：产品名称、规格（仅适用于AR地图运行服务）、计费模式、套餐包剩余可用额度/总额度（仅适用于AR地图生产服务）以及状态。 退订AR地图运行服务或AR地图生产服务。 购买AR地图全景建图云服务套餐包。 AR地图运行服务具体使用指南请参考《开发指南》，AR地图生产服务的使用指南请参考新增与管理AR地图生产服务项目~下载点云文件章节操作。 父主题： AR地图生产服务和AR地图运行服务使用指南
-
支持审计的关键操作列表 表1
云审计 服务支持的KooMap操作列表 操作名称 资源类型 事件名称 开通AR地图运行服务基础版 arapp_serv_base subsARAppServBase 退订AR地图运行服务基础版 arapp_serv_base unsubsARAppServBase 冻结AR地图运行服务基础版 arapp_serv_base freezeARAppServBase 解冻AR地图运行服务基础版 arapp_serv_base unfreezeARAppServBase 删除AR地图运行服务基础版 arapp_serv_base deleteARAppServBase 全景建图服务开通 panorama_con subsArPanoramaConstruct 全景建图服务退订 panorama_con unsubsArPanoramaConstruct 全景建图服务套餐包开通 panorama_con usagePackageOrderArPanoramaConstruct 全景建图服务冻结 panorama_con freezeArPanoramaConstruct 全景建图服务解冻 panorama_con unfreezeArPanoramaConstruct
-
退订AR地图生产服务 您可以参考如下操作步骤退订AR地图生产服务。退订成功后会删除您所已购买的服务资源，并停止计费。 登录KooMap管理控制台。 您可通过如下方式退订AR地图生产服务。 方式一：在左侧导航栏选择“总览”，在右侧页面单击“AR地图生产服务”卡片下的“退订”。 方式二：在左侧导航栏选择“服务概览”，然后在右侧“服务列表”页面，单击“AR地图全景建图云服务”操作列“退订”。 在弹出的对话框中，单击“是”。 退订成功后，系统会删除已购买的服务资源，并停止计费。
-
退订AR地图运行服务 您可以参考如下操作步骤退订AR地图运行服务。退订成功后会删除您所已购买的服务资源，并停止计费。 登录KooMap管理控制台。 您可通过如下方式退订AR地图运行服务。 方式一，在左侧导航栏选择“总览”，在右侧页面单击“AR地图运行服务”卡片下的“退订”。 方式二，在左侧导航栏选择“服务概览”，然后在右侧“服务列表”页面单击“AR地图运行服务基础版”操作列“退订”。 在弹出的对话框中，单击“是”。 退订成功后，系统会删除已购买的服务资源，并停止计费。
-
开通AR地图生产服务 您可以参考如下操作步骤开通AR地图生产服务。 登录KooMap管理控制台。 您可通过如下任意方式完成AR地图生产服务的开通。 方式一：在左侧导航栏选择“总览”，然后在右侧页面单击“AR地图生产服务”卡片下的“开通服务”。 方式二：在左侧导航栏选择“服务概览”，然后在右侧“服务列表”页面单击“AR地图全景建图云服务”操作列“开通”。（左侧导航栏如有“服务概览”菜单且非首次开通，才能使用此开通方式。） 进入“AR地图全景建图云服务”弹窗，了解服务功能并勾选相关须知后，单击“立即开通”。
-
开通AR地图运行服务 您可以参考如下操作步骤开通AR地图运行服务。 登录KooMap管理控制台。 您可通过如下任意方式完成AR地图运行服务的开通。 方式一：在左侧导航栏选择“总览”，然后在右侧页面单击“AR地图运行服务”卡片下的“开通服务”。 方式二：在左侧导航栏选择“服务概览”，然后在右侧“服务列表”页面单击“AR地图运行服务基础版”操作列“开通”。（左侧导航栏如有“服务概览”菜单且非首次开通，才能使用此开通方式。） 进入“开通AR地图运行服务基础版”页面，选择“区域”、配置“规格”，并勾选协议，单击“下一步”。 “规格”输入值必须在50~500之间，且是50的倍数。 在开通AR地图运行服务前，需确认已完成AR地图数据的生产。如未完成，请开通AR地图生产服务。 确认配置信息，单击“立即开通” 开通成功后，您可通过开放的API（Application Programming Interface）或SDK（Software Development Kit）方式使用AR地图运行服务。
