Вас приветствует Mixed Reality Feature ToolWelcome to the Mixed Reality Feature Tool

Изображение баннера Mixed Reality Feature Tool

Важно!

В данный момент средство 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.

Средство Mixed Reality Feature Tool предоставляет новый способ для обнаружения, обновления и добавления пакетов функций смешанной реальности в проекты 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. Когда вы подтвердите список нужных пакетов, средство Mixed Reality Feature Tool скачает их в выбранный вами проект.Once you've validated the packages you want, the Mixed Reality Feature tool will download them into the project of your choice.

Требования к системеSystem requirements

Перед запуском средства Mixed Reality Feature Tool вам потребуется следующее:Before you can run the Mixed Reality Feature Tool, you'll need:

Примечание

В настоящее время средство Mixed Reality Feature Tool работает только в 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

Запустите средство Mixed Reality Feature Tool из исполняемого файла. При первом запуске отобразится такая начальная страница: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
  • открыть веб-браузер, настроенный по умолчанию, и отобразить нашу документацию с помощью кнопки со значком вопросительного знака;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

Каталог пакетов функций извлекается сразу после нажатия кнопки Start (Пуск).The feature package catalog is retrieved as soon as you press Start. Функции группируются по категориям, чтобы их было проще найти.Features are grouped by category to make things easier to find. Например, категория Mixed Reality Toolkit содержит несколько вариантов для выбора:For example, the Mixed Reality Toolkit category has several features for you to choose from:

Обнаружение и получение

Завершив выбор вариантов, щелкните Get features (Получить функции), чтобы извлечь из каталога все необходимые пакеты.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:

Импорт пакетов

Мы настоятельно рекомендуем использовать кнопку Validate (Проверить), чтобы проект 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.

Чтобы продолжить, щелкните Import (Импортировать).Select Import to continue.

Примечание

После нажатия кнопки Import (Импортировать) отобразится простое сообщение, если остались нерешенные проблемы.After clicking the Import button, if any issues remain a simple message will be displayed. Мы рекомендуем нажать здесь кнопку "Нет" и щелкнуть Validate (Проверить), чтобы просмотреть и устранить эти проблемы.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
  • Кнопка Compare (Сравнить) позволяет просматривать в двух соседних окнах текущую версию манифеста и предлагаемые изменения.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:

Проект обновлен

В папке Packages проекта Unity теперь содержится вложенная папка 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