欢迎使用混合现实功能工具
重要
混合现实功能工具目前仅适用于 Unity。 如果是在 Unreal 中进行开发，请参阅工具安装文档。
混合现实功能工具是开发人员发现、更新混合现实功能包并将其添加到 Unity 项目中的一种新方式。 你可以按名称或类别搜索包，查看其依赖项，甚至在导入之前查看项目清单文件的建议更改。 如果以前从未使用过清单文件，则它是包含所有项目包的 JSON 文件。 验证所需的包后，混合现实功能工具会将它们下载到所选的项目中。
系统要求
在运行混合现实功能工具之前，需要具备以下项：
- 运行 Windows 10 或 11 且具有活动的 Internet 连接的电脑
注意
如果电脑位于组织管理的网络上，请确保允许访问以下 URL： https://aka.ms/https://feeds.dev.azure.com/https://learn.microsoft.com/https://pkgs.dev.azure.com/https://mixedrealitycloud.pkgs.visualstudio.com/ （仅适用于特殊早期访问用户）
下载
设置环境后：
- 请从 Microsoft 下载中心下载混合现实功能工具的最新版本。
- 下载完成后，解压缩文件并将其保存到桌面
- 建议创建可执行文件的快捷方式，以便更快地进行访问
注意
如果您是刚开始使用 Unity 包管理器，请遵循我们的 UPM 说明。
此版本中的更改
版本 1.0.2209.0-Preview 包含以下改进：
- 在发现功能视图中添加了“显示预览功能”选项
- 已更新为 .NET 6
- 将应用和 .NET 6 运行时整合为一个可执行文件中，以便于分发
- 修复了在不必要情况下出现降级现有软件包版本的提示这一问题
1.入门
从可执行文件启动混合现实功能工具，此操作将在首次启动时显示起始页：
从起始页，你可以：
- 使用齿轮图标按钮配置工具设置
- 使用问号按钮启动默认 web 浏览器并显示文档
- 选择“开始”，开始发现功能包
2. 选择 Unity 项目
为了确保您项目的 Unity 版本支持所有发现的功能，第一步是使用省略号按钮（位于项目路径字段右侧）将混合现实功能工具指向您的项目。
注意
浏览 Unity 项目文件夹时显示的对话框包含“_”作为文件名。 文件名必须有一个值才能使文件夹被选中。
找到项目的文件夹后，单击“打开”按钮返回到混合现实功能工具。
重要
混合现实功能工具执行验证，确保其已被定向到 Unity 项目文件夹。 该文件夹必须包含 Assets、Packages 和 Project Settings 文件夹。
选择项目后，可以执行以下操作：
- 还原功能：将项目清单中列出的功能工具提供的包下载到 Packages/MixedReality（如果这些包尚不存在）。 此功能与概念中的
nuget restore类似。 通常情况下，如果从某个已配置为忽略 tarball 文件的存储库克隆某个项目（包含功能工具包），则只需执行此操作。 如果不需要获取新包，可以在还原后关闭功能工具。
和/或
- 发现功能：转到下一页，选择要添加到项目的包。
3. 发现并获取功能包
功能按类别分组，方便查找。 例如，“混合现实工具包”类别具有几个可供选择的功能：
注意
如果要在项目中使用 MRTK3 公共预览版，则必须启用 Show preview releases，如下图红框所示。
当混合现实功能工具识别到以前导入的功能时，它针对每个功能显示一条通知消息。
做出选择后，选择“获取功能”，从目录中下载所有必需的包。 有关详细信息，请参阅发现并获取功能。
4. 导入功能包
获取完毕后，将显示完整的包集，以及所需依赖项的列表。 如果需要更改任何功能或包选择，则可以执行以下操作：
强烈建议使用“验证”按钮，确保 Unity 项目可以成功导入所选功能。 验证完成后，你将看到一个弹出对话框，其中包含一条成功消息或已识别出的问题的列表。
选择“导入”继续。
注意
单击“导入”按钮后，如果有任何问题仍存在，则将显示一条简单消息。 建议单击“否”，并使用“验证”按钮来查看和解决问题。
有关详细信息，请参阅导入功能。
5. 查看和批准项目更改
最后一步是检查并批准对清单和项目文件的建议更改：
- 建议的清单更改显示在左侧
- 要添加到项目中的文件显示在右侧
- “比较”按钮允许并排查看当前清单和建议的更改
有关详细信息，请参阅查看和批准项目修改。
6. 已更新项目
更改建议获得批准后，目标 Unity 项目会进行相应更新以引用所选的混合现实功能。
Unity 项目的 Packages 文件夹现在具有一个包含功能包文件的 MixedReality 子文件夹，并且清单将包含相应的引用。
返回到 Unity，等待加载新的选定功能，并开始生成！