Microsoft 混合现实 Toolkit 2.6 发行说明

2.6.2 中的新增功能

更正空间网格的父级

修复了在移动混合现实 Playspace 对象后空间网格未正确定位的问题 (例如：通过传送) 。

2.6.1 中的新增功能

修复了 OpenXR 未在 HoloLens 2/UWP 上运行的问题

修复了阻止 MRTK 的 OpenXR 支持在 UWP 上运行的回归。

修复了 Leap Motion ObjectManipulator 不旋转的问题

修复了 ObjectManipulator 脚本未考虑 Leap Motion 手部旋转的回归。

示例场景更新

汇报场景理解示例场景，以正确反映 Unity 插件的已交付状态。 此外，将示例更新为不再依赖于要导入的空间感知示例场景。 在更新到 2.6.1 之前，如果项目中存在导入的场景理解和空间感知示例，则应将其删除，以避免可能的冲突。 如果未删除这些示例并在控制台中看到相关冲突，请删除两个示例 (或 Assets/Samples/Mixed Reality Toolkit Examples 文件夹) ，然后再次尝试导入。

汇报对话框示例场景，以正确描述当前对话方案。

2.6.0 中的新增功能

添加对 OpenXR 的支持

Unity的 OpenXR 预览包和Microsoft混合现实 OpenXR 包的初始支持可用。 有关详细信息，请参阅 MRTK/XRSDK 入门页、Unity的论坛帖子或Microsoft的文档。

资产交换实用工具

使用新的资产交换实用工具交换Unity场景中的多个资产。

MRTK 现在支持 HP 运动控制器

HP 混响 G2 的控制器现在可本机与 MRTK 配合使用。

实验互式元素 + 状态可视化工具

Interactive 元素是 MRTK 输入系统的简化集中式入口点。 它包含核心交互状态的状态管理方法、事件管理和状态设置逻辑。 有关详细信息，请参阅 Interactive 元素文档。

状态可视化工具是依赖于 Interactive 元素的动画组件。 此组件创建动画剪辑，设置关键帧，并生成动画器状态机。 有关详细信息，请参阅 状态可视化工具文档

所有平台上现在都支持具有传送手势的传送

用户现在可以使用传送手势跨所有平台在游戏空间中移动。 若要在具有默认配置的 MR 设备上使用控制器传送，请使用纵杆。 若要用关节手传送传送，请做出手势，手掌朝上，索引和拇指向外粘附，通过卷曲食指来完成传送。 若要使用输入模拟传送，请参阅更新的 输入模拟服务文档。

场景理解现已在 MRTK 中作为实验性空间感知观察程序提供

MRTK 2.6 中引入了 对场景理解 的实验性支持。 用户可以将 HoloLens 2 的场景理解功能合并为基于 MRTK 的项目中的空间感知观察程序。 有关详细信息，请阅读 场景理解文档 。

运行时配置文件切换支持

MRTK 现在允许在 MRTK 实例初始化之前切换配置文件 (即) 前 MRTK 初始化配置文件切换，在配置文件处于活动使用状态后， (即活动配置文件切换) 。 前一种开关可用于根据硬件的功能启用选择组件，而后者可用于在用户进入应用程序的子部分时修改体验。 有关详细信息和代码示例，请阅读 有关配置文件切换的文档 。

方向指示器和跟踪求解器从实验毕业

两个新的求解器已准备好用于主线 MRTK。

手部教练从实验毕业

手部指导功能现已准备好与主线 MRTK 一起使用。

从实验阶段毕业的对话控件

现在，对话框控件已准备好与主线 MRTK 一起使用。

脉冲着色器从实验阶段毕业

脉冲着色器脚本已从实验阶段毕业。 有关详细信息，请参阅： 脉冲着色器文档

输入录制服务改进

InputRecordingService 和 InputPlaybackService 现在可以录制和播放眼睛凝视输入。 录制经过优化，可确保整个录制期间帧速率一致，同时录制文件大小和节省时间减少约 50%。 现在可以异步执行录制文件的保存和加载。 此 MRTK 版本中更改了录制的文件格式，请参阅 此处 了解有关新版本 1.1 规范的详细信息。

阅读模式

添加了对HoloLens 2上的阅读模式的支持。 阅读模式会缩小系统的视野，但消除了Unity输出的缩放。 由Unity呈现的像素对应于HoloLens 2上的投影像素。 应用程序作者应与多个人一起进行测试，以确保在其应用中需要权衡。

支持 UWP 上的 3D 应用启动器

添加了为 UWP 设置 3D 应用启动器 的功能。 此设置在 MRTK 生成窗口和 MRTK 项目设置的“生成设置”下公开。 在 Unity 中生成期间，它会自动写入项目中。

中断性变更

导入的 GLTF 对象的某些字段现在已大写

为了减少与反序列化相关的问题，导入的 GLTF 对象的某些字段现在以大写字母开头。 受影响的字段在新名称中 (，) ：ComponentType、、Path、TargetTypeInterpolation、Mode、、MagFilter、MinFilter、、WrapS、 。 WrapT

输入动画二进制文件具有更新的版本 1.1 格式

和 InputPlaybackService使用的InputRecordingService输入动画二进制文件现在具有更新的文件格式，用于启用对这两个服务进行的优化。 有关新版本 1.1 规范的详细信息，请参阅 此处 。

MSBuild for Unity 支持

自 2.5.2 版本起，已删除对 MSBuild for Unity 的支持，以符合 Unity 的新包指南。

已知问题

OpenXR

全息远程处理和 OpenXR 目前存在一个已知问题，其中手关节并非始终可用。 此外，眼动跟踪示例场景目前不兼容，但眼动跟踪 确实 可以正常工作。

某些混合现实工具包Standard着色器功能需要基础包

通过 Unity 包管理器导入时，MRTK Standard 着色器实用工具脚本 (例如：HoverLight.cs) 不会与 Standard Assets 包中的着色器并置。 若要访问该功能，应用程序需要导入 Foundation 包。

CameraCache 可能会在关闭时创建新相机

例如，在某些情况下， (在Unity 编辑器) 中使用 LeapMotion 提供程序时，CameraCache 可以在关闭时重新创建 MainCamera。 有关详细信息 ，请参阅此问题 。

通过 Unity 包管理器导入示例时，FileNotFoundException

根据项目路径的长度，通过 Unity 包管理器导入示例可能会在 Unity 控制台中生成 FileNotFoundException 消息。 原因是“缺失”文件的路径长于) MAX_PATH (256 个字符。 若要解决此问题，请缩短项目路径的长度。

未指定空间化器。 应用程序将不支持空间声音

如果未配置音频空间化器，则会出现“未指定空间化器”警告。 如果未安装 XR 包，则会出现此警告，因为Unity这些包中包含空间化器。

若要解决此问题，请确保：

• 窗>包管理器 已安装一个或多个 XR 包

• 混合现实工具包>实用工具>配置Unity项目并针对音频空间化器进行选择

  

NullReferenceException：对象引用未设置为对象实例 (SceneTransitionService.Initialize)

在某些情况下，打开 EyeTrackingDemo-00-RootScene 可能会导致 SceneTransitionService 类的 Initialize 方法中出现 NullReferenceException。 此错误是由于未设置场景转换服务的配置文件。 若要解决此问题，请使用以下步骤：

• 导航到 MixedRealityToolkit 层次结构中的 对象
• 在“检查器”窗口中，选择 Extensions
• 如果未展开，请展开 Scene Transition Service
• 将 的值 Configuration Profile 设置为 MRTKExamplesHubSceneTransitionServiceProfile

Oculus Quest

面向独立平台时，使用 Oculus XR 插件存在一个已知问题。 查看 Oculus bug 跟踪器/论坛/发行说明以获取更新。

该 bug 表示为以下三个错误集：

Oculus XR 插件错误644204

UnityUI 和 TextMeshPro

较新版本的 TextMeshPro (1.5.0+ 或 2.1.1+) 存在已知问题，其中下拉列表的默认字体大小和粗体字体字符间距已更改。

可以通过降级到早期版本的 TextMeshPro 来解决此问题。 有关详细信息，请参阅 问题 #8556。