Table of Contents

模拟运行（非 Unity 应用开发）

本文档介绍了如何使用 Mega Studio 中的 Annotation Tool 工具进行模拟运行，查看定位效果。

注意

以下内容及工具不适用于 Unity 应用开发过程。

如果您在开发 Unity 应用，请参考开发指南中的 使用 session 验证工具模拟运行。

准备工作

模拟运行之前需要准备好 Mega Studio 中的 Annotation Tool 工具。

下载 Mega Studio

Mega Studio 是以 Unity 插件的形式提供的，需要在 EasyAR 下载页面，下载 EasyAR Sense Unity Plugin (for Mega)，再导入至 Unity 中进行使用。

下载 Mega Studio

阅读并同意“隐私政策”与“合规指南”，然后点击“下载”

下载 Mega Studio

文件解压，将下载后的文件解压成下图的结构

下载 Mega Studio

创建 Unity 项目

运行 Unity，创建一个项目。

  • 点击“新项目”

  • 选择“3D(Built-In Render Pipeline)”，

  • 点击“创建项目”

    创建unity项目 创建unity项目

提示

Unity 6000 之后的版本需要先下载 3D (Built-In Render Pipeline) 组件

安装 Mega Studio

  1. 点击菜单栏的 “Window”

  2. 选择 “Package Manager”

  3. 在弹出的窗口中，点击左上角的 “＋” 符号

  4. 选择 “Add package from tarball...”

  5. 依次安装 com.easyar.sense 、com.easyar.mega 和 com.easyar.mega.studio 这 3 个包

  6. 安装成功后如图所示

    安装studio

填写许可证

从 Unity 菜单中选择 EasyAR > Sense > Configuration 调出 EasyAR Sense 设置界面。

FillInKey

在 EasyAR Sense License 下的输入框中填入 EasyAR Sense License。

FillInKey2

提示

EasyAR Sense License 可以从 EasyAR 开发中心（中文，英文） 创建。初次使用可以按以下步骤创建：

  • 创建 EasyAR Sense 4.x 个人版
  • 稀疏空间地图选 否
  • 应用名称随意填写，Bundle ID 和 Package Name 填写 com.mycompany.myproject
  • 选择刚创建的 License，进入之后点击右侧复制按钮

copykey

开始模拟运行

模拟定位测试允许您在无需完整应用开发的情况下，直接查看叠加渲染效果。通过在 Mega Studio 中回放 EIF 数据、发送定位请求，并通过叠加渲染 Mesh 的方式，预览定位结果。以下是具体的操作流程：

加载地图

  1. 在左侧面板 “Hierarchy” 空白处点击右键，选择 “EasyAR Mega” -> “Tool” -> 导入 “Annotation Tool (Edit Mode)”

    使用studio

  2. 在左侧面板 “Hierarchy” 中选择 “EasyAR.Mega.Annotation"

  3. 在右侧面板 “Inspector” 中选择账号，输入 EasyAR 的账号名与密码

  4. 点击“登录”

    使用studio

    如果您需要使用服务登录，可以参考 Unity 登录组件。

  5. 在右侧面板 “Inspector” 中，点击 “Mega Cloud Service” 后的图标

  6. 在打开的窗口中，选择一个 “Mega Block定位服务”，点击“确定”

  7. 在右侧面板 “Inspector” 中，点击 “加载” ，将地图加入到 Unity 项目中

    使用studio

加载 EIF

  1. 按照下图所示，在左侧面板 “Hierarchy” 中点击 “EasyAR.Mega.Annotation"，然后再在右侧面板 “Inspector” 中点击 “2” 勾选验证工具，再点击按钮 “3” 进行播放。

    使用studio

    点击选项卡 “4” 后，“Mega Validation Tool” 工具窗口会单独显示。

    使用studio

  2. 按照下图点击加载按钮，选择您测试所用的 EIF 文件，并点击“打开”，即可自动播放 EIF 并查看定位效果。

    使用studio

运行效果及控制

加载 EIF 之后，“EasyAR.Mega.Annotation” 会自动播放 EIF，并进行定位，在 Game 里面可以查看 Mesh 叠加的效果。

您可以通过调整模型渲染透明度来查看定位效果。同时也可以拖拽进度条，调整开始播放的时间。

使用studio

功能说明

  1. 播放/暂停
  2. 停止
  3. 向前 5s（新格式数据可用，录制异常停止除外）
  4. 减速播放（新格式数据可用）
  5. 加速播放（新格式数据可用）
  6. 向后 5s（新格式数据可用，录制异常停止除外）
  7. 打开 EIF 文件
  8. 当前时间/总时间
  9. 当前倍速
  10. 播放进度（新格式数据可拖动，录制异常停止除外）

还可以在 “Hierarchy” 中点击 “Main Camera”，查看定位过程中相机的实时位置。

使用studio

在定位显示控制区，您可以调整内容显示：

  1. 显示/隐藏视频背景

  2. 显示/隐藏 Block 模型（URP 下将同时隐藏 Scene 窗口的模型）

  3. 控制 Block 模型透明度（URP 下无法使用）

    使用studio

后续步骤

相关主题