欢迎使用混合现实功能工具Welcome to the Mixed Reality Feature Tool

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

重要

混合现实功能工具目前仅适用于 Unity。The Mixed Reality Feature Tool is only available for Unity at the moment. 如果是在 Unreal 中进行开发,请参阅工具安装文档。If you're developing in Unreal, refer to the tools installation documentation.

混合现实功能工具是开发人员发现、更新混合现实功能包并将其添加到 Unity 项目中的一种新方式。The Mixed Reality Feature Tool is a new way for developers to discover, update, and add Mixed Reality feature packages into Unity projects. 你可以按名称或类别搜索包,查看其依赖项,甚至在导入之前查看项目清单文件的建议更改。You can search packages by name or category, see their dependencies, and even view proposed changes to your projects manifest file before importing. 如果以前从未使用过清单文件,则它是包含所有项目包的 JSON 文件。If you've never worked with a manifest file before, it's a JSON file containing all your projects packages. 验证所需的包后,混合现实功能工具会将它们下载到所选的项目中。Once you've validated the packages you want, the Mixed Reality Feature tool will download them into the project of your choice.

系统要求System requirements

在运行混合现实功能工具之前,需要具备以下项:Before you can run the Mixed Reality Feature Tool, you'll need:

备注

混合现实功能工具目前仅可在 Windows 上运行,但即将推出 MacOS 支持!The Mixed Reality Feature Tool currently only runs on Windows, but MacOS support is coming soon!

下载Download

设置环境后:Once you have your environment set up:

1.入门1. Getting started

从可执行文件启动混合现实功能工具,此操作将在首次启动时显示起始页:Launch the Mixed Reality Feature Tool from the executable file, which displays the start page on first launch:

开始使用

从起始页,你可以:From the start page, you can:

  • 使用齿轮图标按钮配置工具设置Configure tool settings using the gear icon button
  • 使用问号按钮启动默认 web 浏览器并显示文档Use the question mark button to launch the default web browser and display our documentation
  • 选择“开始”,开始发现功能包Select Start to begin discovering feature packages

2.发现并获取功能包2. Discovering and acquiring feature packages

按下“开始”之后,即会检索功能包目录。The feature package catalog is retrieved as soon as you press Start. 功能按类别分组,方便查找。Features are grouped by category to make things easier to find. 例如,“混合现实工具包”类别具有几个可供选择的功能:For example, the Mixed Reality Toolkit category has several features for you to choose from:

发现和获取

做出选择后,选择“获取功能”,从目录中获取所有所需的包。Once you've made your choices, select Get features to fetch all the required packages from the catalog. 有关详细信息,请参阅发现并获取功能For more information, please see discovering and acquiring features.

3.导入功能包3. Importing feature packages

获取完毕后,将显示完整的包集,以及所需依赖项的列表。Following acquisition, the complete set of packages is presented, along with a list of required dependencies. 如果需要更改任何功能或包选择,则可以执行以下操作:If you need to change any feature or package selections, this is the time:

导入程序包

强烈建议使用“验证”按钮,确保 Unity 项目可以成功导入所选功能。We highly recommend using the Validate button to ensure the Unity project can successfully import the selected features. 验证完成后,你将看到一个弹出对话框,其中包含一条成功消息或已识别出的问题的列表。After validation, you'll see a pop-up dialog with a success message or a list of identified issues.

还需要在导入之前设置目标 Unity 项目的位置。You also need to set the location of the target Unity project before you import. 使用项目路径左侧的省略号按钮进行浏览。Use the ellipsis button to the left of the project path field to browse. 完成文件系统导航后,打开包含目标 Unity 项目的文件夹。When you're done navigating your file system, open the folder containing your target Unity project.

备注

浏览 Unity 项目文件夹时显示的对话框包含“”作为文件名。The dialog that's displayed when browsing for the Unity project folder contains '' as the file name. 文件名必须有一个值才能使文件夹被选中。There must be a value for the file name to enable the folder to be selected.

选择“导入”继续。Select Import to continue.

备注

单击“导入”按钮后,如果有任何问题仍存在,则将显示一条简单消息。After clicking the Import button, if any issues remain a simple message will be displayed. 建议单击“否”,并使用“验证”按钮来查看和解决问题。The recommendation is to click No and to use the Validate button to view and resolve the issues.

有关详细信息,请参阅导入功能For more information, please see importing features.

4.查看和批准项目更改4. Reviewing and approving project changes

最后一步是检查并批准对清单和项目文件的建议更改:The final step is reviewing and approving the proposed changes to the manifest and project files:

  • 建议的清单更改显示在左侧The proposed changes to the manifest are displayed on the left
  • 要添加到项目中的文件显示在右侧The files to be added to the project are listed to the right
  • “比较”按钮允许并排查看当前清单和建议的更改The Compare button allows for side by side viewing of the current manifest and the proposed changes

授权

有关详细信息,请参阅查看和批准项目修改For more information, see reviewing and approving project modifications.

5.已更新项目5. Project updated

更改建议获得批准后,会更新目标 Unity 项目以引用所选的混合现实功能:When the proposed changes are approved, your target Unity project is updated to reference the selected Mixed Reality features:

已更新项目

Unity 项目的 Packages 文件夹现在具有一个包含功能包文件的 MixedReality 子文件夹,并且清单将包含相应的引用 。The Unity project's Packages folder now has a MixedReality subfolder with the feature package file(s) and the manifest will contain the appropriate reference(s).

返回到 Unity,等待加载新的选定功能,并开始生成!Return to Unity, wait for the new selected features to load, and start building!

另请参阅See also