验证组件
版本需求:>= 2.10 (老版本请阅读 验证工具(废弃版本) )
未运行状态界面总览
如果验证工具没有在单独窗口打开,studio 工具面板会显示

如果验证工具在单独窗口打开,studio 工具面板会显示

而验证工具窗口会显示

运行状态界面总览
如果验证工具没有在单独窗口打开,studio 工具面板会显示

如果验证工具在单独窗口打开,验证工具窗口会根据窗口大小调整显示

工具区域说明
- 运行控制区
- EIF 播放区
- 定位控制区
- 显示控制区
- 状态信息区
运行控制区

- 使用/禁用验证工具
- 启动/停止验证工具
- 在单独窗口打开
- 关闭单独窗口中的工具
- 在单独工具窗口中选择 studio 工具
EIF播放区

- 播放/暂停
- 停止
- 向前 5s(新格式数据可用,录制异常停止除外)
- 减速播放(新格式数据可用)
- 加速播放(新格式数据可用)
- 向后 5s(新格式数据可用,录制异常停止除外)
- 打开 EIF 文件
- 当前时间/总时间
- 当前倍速
- 播放进度(新格式数据可拖动,录制异常停止除外)
定位控制区

- 定位状态指示器
- 启动/停止定位(默认启动)
- 重置跟踪状态
- 结果稳定器开关(打开开关时是正常的运行效果。一般只有在分析特定问题的时候才需要关闭。)
- 服务地址选择(工具不在运行状态时才能修改)
定位状态指示器颜色说明
- 绿色:定位到 Block 且设备 VIO 跟踪成功显示绿色,若无新的定位结果将在 5s 内渐变至透明;
- 黄色:定位到 Block 但设备 VIO 跟踪失败显示黄色,若无新的定位结果将在 5s 内渐变至透明;
- 白色:定位不到 Block 显示白色,若无新的定位结果将在5s内渐变至透明;
- 红色:定位出错显示红色,在下次定位结果返回前保持显示;
显示控制区

- 显示/隐藏视频背景
- 显示/隐藏标注数据
- 显示/隐藏 Block 模型(URP 下将同时隐藏 Scene 窗口的模型)
- 显示/隐藏按钮名称
- 控制 Block 模型透明度(URP 下无法使用)
Block 模型透明度变换效果如下

状态信息区

- 每帧更新的 session 状态
- 服务器返回的定位结果(和跟踪效果有关,但不是全部跟踪结果)
- 复制
- 复制
- 是否在 Game View 中显示 dump 信息
使用流程
准备 EIF 数据
验证效果需要使用 EIF 数据,请使用 Mega Toolbox 的 远程开发模拟定位用的EIF测试数据录制工具 录制 EIF 文件。根据所选录制格式不同,录制结果中会保存 .mkveif 文件(或 .eif 文件和 .eif.json 文件,这两个文件缺一不可)。
准备 Package
确保 com.easyar.sense 已经导入。如果没有导入会看到以下信息,

这时候需要使用 Unity Package Manager 导入需要的 package 包: com.easyar.sense-**.tgz 。
填写 EasyAR Sense License Key
在网页上登录 EasyAR 开发中心 ,获取 EasyAR Sense License Key

在Unity菜单中打开 EasyAR > Sense > Configuration

然后在打开的 Project Settings 窗口中填写从网站上复制的 license key

连接 Mega 定位服务 在添加工具之后,需要在对应工具中选择所需验证的定位服务

准备 Block 数据(可选)
为了直观的查看定位效果,一般建议加载对应区域的 Block 模型数据。请参照 Block 数据组件 的说明进行加载。
准备标注数据(可选)
如果需要在定位时显示标注数据,可以使用 标注组件 标注或通过 标注数据包组件导入标注。

如果这时场景中 Block 和标注数据都已经导入,场景中都会显示

准备 3D 内容(可选)
可以通过邮件菜单创建 3D 物体,需要注意 3D 物体需要放在 Block 节点下,

创建出来后可以根据需要调整位置大小等,

当然你也可以导入自己的模型,

启动工具
首先启用工具,然后点击运行按钮启动,

你也可以通过 Unity 工具栏上的按钮启动,

启动后有提示弹窗,如果你在开发 Unity 应用,请仔细阅读,

打开 EIF
EIF 打开后会自动开始播放,

查看效果
可以根据需求进行播放控制,通常效果会是这样,

你也可以完全隐藏 Block 模型,这样就和真实场景中看到的效果是一致的,

停止运行和应用恢复
通过工具按钮停止运行,

或者也可以通过 Unity 工具栏上的按钮停止运行,

如果你需要开发自己的应用,如果需要在编辑器上运行自己的程序,别忘记禁用验证工具(仅对编辑器有效,不影响手机上效果),

显示效果及 Unity 使用建议
调整 Game 窗口大小
窗口大小建议与 EIF 视频帧大小一致。一般建议使用大致与 1080P 相当的固定大小,比如 1080x1920(横屏 1920x1080)。

如果窗口大小与 EIF 视频帧差异较大,将无法查看完整的视频画面,工具也会显示警告信息。
调整场景光照
为了更好的观察渲染效果,可以根据需求添加和调整光照。如果没有 Unity 光照的特殊需求,可以让 Unity 自动生成环境光,

同时显示 Scene 窗口和 Game 窗口
有些时候需要同时查看 Scene 窗口和 Game 窗口的内容,这时候可以调整 Unity 默认窗口布局,根据需求调整 Scene 窗口和 Game 窗口的位置。

Unity 开发注意点
ARSession
工具启动时会自动创建 ARSession 及其它必要的 EasyAR 组件,如果场景中本身就有 ARSessio n存在(active),则工具会禁用原本的 ARSession。但是动态创建的 session 不会受控制,如果运行起来会报错。
Main Camera
工具在运行时会修改 main camera 的 Clear Flags 和 Background。Clear Flags 会被改为 Solid Color。Background 会被改为黑色。这些修改不会被保存。
中心模式
工具运行时可以使用所有可支持的中心模式。通常情况下推荐使用 First Target 中心模式。