World Locking Tools 疑难解答

此处将注明麻烦的问题。 此外,这里还提供了一个有关缩小世界锁定问题范围的建议策略

世界锁定问题

帧速率低

世界锁定工具对帧率应无明显影响。 (一个例外是,在创建了许多定位点之后,可视化效果最终会导致帧率降低,但可视化工具只用于诊断,而不与应用程序一起提供。)

如果在向应用程序中添加世界锁定工具后发现帧率下降,请查看 Unity 日志。 这通常意味着正在反复生成某个异常。

“缺少 DLL”错误

这些错误通常来自 Frozen World 引擎 DLL。 要解决这些问题,请按照安装文档中的说明将 FrozenWorld 引擎升级到更高版本。 按照这些说明而不更改版本号将修复安装。

或者,可使用 MR 功能工具进行安装。 该工具可处理依赖项的安装。

缺少“FrozenWorld”命名空间

错误如下(通常很多):

Assets\WorldLocking.Engine\Plugin.cs(10,37):错误 CS0234:命名空间“Microsoft.MixedReality”中不存在类型或命名空间名称“FrozenWorld”(是否缺少程序集引用?)

它缺少 FrozenWorld.Engine DLL。 请参阅 NuGet 安装程序

或者,使用 MR 功能工具安装,让其为你处理依赖项安装。

它不起作用

查看 Unity 日志中的错误和异常信息。

检查场景摄像机是否已附加到至少一个其他对象。 作为例子,请查看 WorldLocking.Examples.WorldLockingPhysicsSample 中的设置。 如果正在执行动态摄像机操作,则可能需要向 WorldLockingManager 通知当前摄像机的信息。 请查看 WorldLockingManager. AdjustmentFrameWorldLockingManager.CameraParent

更常见的 Unity/AR 问题

“DirectoryNotFoundException:找不到该路径的某个部分”

路径增长得过长。 请参阅此处更完整的解释

看到“远程操作花费的时间超出预期”消息框之后部署失败

检查 USB 连接。 电缆、端口故障或 IPOverUSB 缺失都可能导致出现这种问题。 但问题很可能出在 PC 到设备的通信路径上。

缺少 Windows SDK 组件

Unity 中指示的 Visual Studio 版本与你尝试使用的 Visual Studio 版本不匹配。 请检查:

Unity > File > Build Settings > Visual Studio Version

尤其危险的情况是将其设置为了 Latest Installed 并安装了多个版本的 Visual Studio。

在 HoloLens 上,应用程序启动时是一块板,而不是一种 AR 体验

如果目标是 Unity 的内置 VR 支持(也称为旧 XR),那么请检查:

Unity > Project Settings > Player > XR Settings

必须选中“支持虚拟现实”,以及虚拟现实 SDK 中的“Windows 混合现实”

如果使用 Unity 的 AR 子系统/XR SDK,请确认你已按照我们的跨平台使用 Unity 的 XR SDK 插件系统文章中的所有步骤进行操作。 可能的原因包括:

  • 缺少所需的包之一。
  • 尚未在 MixedRealityToolkit 对象上设置适当的配置文件(如果使用的是 MRTK)。

在 HoloLens2 上为 ARM 构建应用时,应用程序在启动时停止,ARM64 运行正常

已知问题

解决方法是禁用底层的图形作业

Project Settings > Player > Other Settings > Graphics Jobs

或直接面向 ARM64 进行构建。

此问题已在 Unity 2019.4 和 Unity 2020.3 中得到解决。

另请参阅