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

Mixed Reality Feature Tool banner image

Важно!

В данный момент средство Mixed Reality Feature Tool доступно только для платформы Unity. Если вы ведете разработку в Unreal, перейдите к документации по установке средств для этого движка.

Средство Mixed Reality Feature Tool предоставляет новый способ для обнаружения, обновления и добавления пакетов функций смешанной реальности в проекты Unity. Вы можете искать пакеты по имени или категории, просматривать их зависимости и даже проверять предлагаемые изменения в файле манифеста проектов перед импортом. Поясним для тех, кто еще не работал с файлом манифеста: это файл в формате JSON, который содержит все пакеты проектов. Когда вы подтвердите список нужных пакетов, средство Mixed Reality Feature Tool скачает их в выбранный вами проект.

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

Перед запуском средства Mixed Reality Feature Tool вам потребуется следующее:

Примечание

В настоящее время средство Mixed Reality Feature Tool работает только в Windows, но скоро станет доступна поддержка MacOS.

Скачивание

После настройки среды выполните следующие действия:

Примечание

Если вы не знакомы с использованием диспетчера пакетов Unity, следуйте нашим инструкциям по UPM.

Изменения в этом выпуске

Бета-версия 1.0.2103 включает следующие исправления:

  • улучшено обнаружение ошибок при скачивании;
  • обновлен способ написания манифестов для избежания ошибок при обновлении;
  • удалено экранирование из путей к файлам в манифесте проекта.

В этом выпуске добавлены следующие функции:

  • кэширование каталога компонентов; для проверки наличия обновлений и новых функций теперь можно нажать кнопку "Обновить" в окне обнаружения;
  • возможность перемещать выбранный проект из шага импорта перед обнаружением;
  • фильтрация доступных пакетов по указанной в проекте версии Unity;
  • в окне обнаружения теперь отображаются установленные пакеты.

1. Начало работы

Запустите средство Mixed Reality Feature Tool из исполняемого файла. При первом запуске отобразится такая начальная страница:

Getting started

На этой странице можно выполнить следующие действия:

  • настроить параметры средства с помощью кнопки со значком шестеренки;
  • открыть веб-браузер, настроенный по умолчанию, и отобразить нашу документацию с помощью кнопки со значком вопросительного знака;
  • щелкнуть кнопку запуска, чтобы начать обнаружение пакетов функций.

2. Выбор проекта Unity

Чтобы все обнаруженные функции поддерживались в версии Unity вашего проекта, сначала укажите в проекте Mixed Reality Feature Tool, щелкнув кнопку с многоточием (справа от поля пути проекта).

Select the Unity project

Примечание

При просмотре папки проекта Unity отображается диалоговое окно, где в качестве имени файла указан символ "_". Чтобы получить возможность выбрать папку, для этого файла необходимо указать значение имени.

После того как вы нашли папку проекта, нажмите кнопку "Открыть", чтобы вернуться к средству Mixed Reality Feature Tool.

Важно!

Средство Mixed Reality Feature Tool выполнит проверку того, что оно направлено в папку проекта Unity. Папка должна содержать папки Assets, Packages и Project Settings.

3. Обнаружение и получение пакетов функций

Примечание

В бета-версии 1.0.2103 теперь кэшируется содержимое каталога компонентов при каждом доступе к серверу. Это изменение обеспечивает быстрый доступ к возможным функциям за счет отображения самых последних данных. Чтобы обновить каталог, нажмите кнопку Refresh (Обновить).

Функции группируются по категориям, чтобы их было проще найти. Например, категория Mixed Reality Toolkit содержит несколько вариантов для выбора:

Discovery and acquisition

Когда средство Mixed Reality Feature Tool обнаруживает ранее импортированные функции, оно отображает уведомление о каждой из них.

Notification of imported feature

Завершив выбор вариантов, щелкните Get features (Получить функции), чтобы извлечь из каталога все необходимые пакеты. Дополнительные сведения см. в статье Обнаружение и получение функций.

4. Импорт пакетов функций

После приобретения вам будет представлен полный набор пакетов и список необходимых зависимостей. Если вам нужно изменить выбранные функции или пакеты, это следует сделать сейчас:

Importing packages

Мы настоятельно рекомендуем использовать кнопку Validate (Проверить), чтобы проект Unity смог успешно импортировать выбранные функции. После проверки вы увидите всплывающее диалоговое окно с сообщением об успешном выполнении или списком выявленных проблем.

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

Примечание

После нажатия кнопки Import (Импортировать) отобразится простое сообщение, если остались нерешенные проблемы. Мы рекомендуем нажать здесь кнопку "Нет" и щелкнуть Validate (Проверить), чтобы просмотреть и устранить эти проблемы.

Дополнительные сведения см. в статье об импорте функций.

5. Просмотр и утверждение изменений в проекте

Последним шагом станет проверка и утверждение предложенных изменений в файлах манифеста и проекта:

  • Слева отображаются предлагаемые изменения в манифесте.
  • Справа приведены файлы, которые будут добавлены в проект.
  • Кнопка Compare (Сравнить) позволяет просматривать в двух соседних окнах текущую версию манифеста и предлагаемые изменения.

Authorization

Дополнительные сведения см. в статье Просмотр и утверждение изменений в проекте.

6. Обновленный проект

После утверждения предложенных изменений будет обновлен целевой проект Unity, чтобы он содержал ссылки на выбранные функции смешанной реальности.

Project updated

В папке Packages проекта Unity теперь содержится вложенная папка MixedReality с файлами пакетов функций, а манифест будет содержать соответствующие ссылки.

Вернитесь в Unity, дождитесь загрузки новых функций и приступайте к разработке.

См. также