欢迎使用混合现实功能工具

混合现实功能工具横幅图像

重要

混合现实功能工具目前仅适用于Unity。如果您正在开发Unreal,请参阅工具安装文档。

混合现实功能工具是开发人员发现、更新混合现实功能包并将其添加到Unity项目中的一种新方法。您可以按名称或类别搜索包,查看其依赖项,甚至可以在导入之前查看对项目清单文件的建议更改。如果您以前从未使用过清单文件,那么它是一个包含所有项目包的JSON文件。一旦你验证了你想要的包,混合现实功能工具将把它们下载到你选择的项目中。

系统要求

在运行混合现实功能工具之前,您需要:

  • 运行Windows 10或11并具有活动Internet连接的电脑

注释

如果电脑位于由组织管理的网络上,请确保允许访问以下URL:

下载

设置好环境后:

注释

如果您刚开始使用Unity Package Manager,请按照我们的UPM说明.

此版本中的更改

1.0.2209.0版—审查包括以下改进:

  • 在发现功能视图中添加了“显示预览功能”选项
  • 更新为。净额6
  • 整合了应用程序和。NET 6运行时转换为单个可执行文件以便于分发
  • 修复了在不必要时显示降级现有包版本提示的问题

1.入门

从可执行文件启动混合现实功能工具,该文件在首次启动时显示起始页:

入门

从起始页,您可以:

  • 配置工具设置使用档位图标按钮
  • 使用问号按钮启动默认web浏览器并显示文档
  • 选择起点开始发现功能包

2.选择Unity项目

为了确保您的项目Unity版本支持所有发现的功能,第一步是使用省略按钮(项目路径字段右侧)。

选择Unity项目

注释

浏览Unity项目文件夹时显示的对话框包含“_”作为文件名。必须有文件名的值才能选择文件夹。

找到项目的文件夹后,单击“打开”按钮返回到混合现实功能工具。

重要

混合现实功能工具执行验证,以确保它已被定向到Unity项目文件夹。文件夹必须包含资产包装项目设置文件夹。

选择项目后,您可以

  • 恢复功能:将项目清单中列出的Feature Tool附带的包下载到套餐/混合现实如果他们还没有出现在那里。该功能类似于nuget恢复在概念上。通常,只有当您从配置为忽略tarball文件的repo克隆了一个项目(带有Feature Tool包)时,才需要执行此操作。如果不需要获取新包,可以在恢复后关闭Feature Tool。

和/或

  • 发现功能:转至下一页,选择要添加到项目中的包。

3.发现和获取功能包

功能按类别分组,以便于查找。例如混合现实工具包类别有几个功能供您选择:

发现和获取

注释

如果您将在项目中使用MRTK3公共预览版本,则必须启用显示预览版本如下面红色框中所示。

MRTK3的推荐功能设置

当混合现实特征工具识别出之前导入的特征时,它会显示每个特征的通知消息。

导入功能的通知

做出选择后,选择获取功能从目录中下载所有必需的包。有关更多信息,请参阅发现和获取特征.

4.导入功能包

获取后,将显示完整的包集以及所需依赖项的列表。如果您需要更改任何功能或软件包选择,现在可以:

正在导入包

我们强烈建议使用验证按钮以确保Unity项目可以成功导入选定的要素。验证后,您将看到一个弹出对话框,其中包含一条成功消息或一个已识别问题的列表。

选择导入继续。

注释

单击后导入按钮,如果仍然有任何问题,将显示一条简单的消息。建议单击“否”并使用验证按钮查看并解决问题。

有关更多信息,请参阅导入要素.

5.审查和批准项目变更

最后一步是审查和批准清单和项目文件的拟议更改:

  • 清单的建议更改显示在左侧
  • 要添加到项目中的文件列在右侧
  • 这个比较按钮允许并排查看当前清单和建议的更改

授权

有关更多信息,请参阅审查和批准项目修改.

6.项目更新

当提议的更改获得批准后,您的目标Unity项目将更新为引用选定的混合现实功能。

项目已更新

Unity项目的包装文件夹现在有一个混合现实包含功能包文件和清单的子文件夹将包含相应的引用。

返回Unity,等待新选择的功能加载,然后开始构建!

另请参见