Перенос проекта Unity 2019 в Unity 2020 + OpenXR

Для максимальной плавности миграции рекомендуется выполнить все действия, описанные в этой статье, в указанном порядке. Ниже приведен обзор основных шагов.

1. Обновите MRTK до последней стабильной версии.
2. Переместите проект в Unity 2019 XR Plug-in Management.
3. Выберите "Windows Mixed Reality".
4. Обновление до Unity 2020.3 LTS.
5. Используйте средство Смешанная реальность Feature Tool для установки дополнительных пакетов.
6. Настройка управления подключаемыми модулями XR для OpenXR.

1. Обновление MRTK до последней стабильной версии

Если вы уже используете MRTK, рекомендуется сначала запустить средство Смешанная реальность Feature Tool и выполнить обновление до последней стабильной версии MRTK.

Выберите нужные функции

Примечание

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

1. Откройте microsoft Смешанная реальность Feature Tool и нажмите кнопку Пуск.

   

2. Нажмите кнопку обзора (это кнопка с трем точками на рисунке ниже), перейдите к проекту и откройте его.

   

3. Выберите Обнаружение компонентов.

   Примечание. Может потребоваться подождать несколько секунд, пока средство обновит пакеты из каналов.

4. На странице Discover Features обратите внимание на то, что имеется список из шести групп пакетов.

   

5. Нажмите кнопку "+" слева от Смешанная реальность Toolkit и выберите последнюю версию Смешанная реальность Toolkit Foundation.

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

1. Выполнив выбор, щелкните Get Features (Получить компоненты).
2. На странице Import Features (Импорт компонентов) в левом столбце в списке Components (Компоненты) отображаются только что выбранные пакеты. В правом столбце Required dependencies (Обязательные зависимости) нет ни одной зависимости. Чтобы узнать больше о них, щелкните ссылку Details (Сведения) для любого из этих элементов.
3. Когда вы будете готовы продолжить, выберите Import (Импорт). На странице Review and Approve (Проверка и утверждение) можно просматреть сведения о пакетах.
4. Выберите Утвердить. В средстве создания компонентов отображается сообщение о том, что проект обновлен.
5. Вернитесь в редактор Unity и щелкните пустую область в пользовательском интерфейсе. Вы увидите сообщение о том, что ваши пакеты импортируются.

Выполняя это обновление при использовании Unity 2019, вы сможете просмотреть конфигуратор проектов MRTK и просмотреть все предупреждения о том, как перейти к актуальной версии API. В предупреждениях будет показано, что нужно изменить. Если сначала не выполнить обновление MRTK, старый API может исчезнуть, и у вас не будет таких предупреждений.

Узнайте больше о средстве функций Смешанная реальность.

2. Перемещение проекта в Unity 2019 XR Plug-in Management

После обновления MRTK можно указать Unity 2019 использовать управление подключаемыми модулями XR.

1. В редакторе Unity в строке меню выберите Изменить>параметры проекта.
2. В левом столбце окна Параметры проекта выберите Управление подключаемым модулем XR.

На этом этапе может появиться кнопка Install XR Plugin Management button (Установить управление подключаемыми модулями XR ). Если это так, перейдите к приведенным ниже действиям. Если у вас уже установлена система управления XR, вы можете пропустить остальные действия, описанные в этом разделе, и перейти к следующему разделу " Выберите "Windows Mixed Reality".

1. Нажмите кнопку Install XR Plugin Management (Установить управление подключаемым модулем XR ).

2. Откроется диалоговое окно С именем Обнаружена встроенная виртуальная реальность и появится запрос на удаление встроенного пакета виртуальной реальности. Нажмите кнопку ОК.

   

3. Откроется диалоговое окно Встроенная виртуальная реальность включена . Нажмите кнопку ОК. Это отключает встроенную виртуальную реальность.

4. Откроется окно Конфигуратор проекта MRTK и запросит включение конвейера XR. Выберите второй вариант, Управление пакетами SDK XR или SR.

5. На следующей странице конфигуратора нажмите кнопку Показать параметры.

3. Выберите "Windows Mixed Reality"

Мы еще не готовы установить OpenXR, но следующий набор действий поможет вам очистить все API, которые были доступны и поддерживаются только в пути "Встроенный XR". (Если вы используете MRTK, большинство из них абстрагируется за вас.)

1. В окне Параметры проекта редактора Unity убедитесь, что вы находитесь на странице Управление подключаемыми модулями XR .
2. Выполните одно из следующих действий.
   • Если вы нацеливание на HoloLens 2:
     Убедитесь, что вы находитесь на вкладке универсальная платформа Windows (это вторая вкладка с логотипом Windows), а затем в разделе Поставщики подключаемых модулей выберите Windows Mixed Reality.
   • Если вы нацелены на виртуальную реальность для настольных компьютеров:
     Убедитесь, что вы находитесь на вкладке Рабочий стол (это первая вкладка, где отображается изображение монитора), а затем в разделе Поставщики подключаемых модулей выберите Windows Mixed Reality.
3. Снова откроется окно Конфигуратор проектов MRTK . Нажмите кнопку Далее , а затем нажмите кнопку Далее еще раз. (Прежде чем переходить дальше, вы можете прочитать пояснения на этих страницах.)
4. Выберите Импорт основных компонентов TMP.
5. Нажмите кнопку Готово. Это закроет конфигуратор.
6. Закройте окно Параметры проекта , сохраните проект и закройте Unity.

Примечание

При использовании подключаемого модуля управления XR в Unity 2019 пространственные привязки Azure (ASA) не поддерживаются. Если в проекте есть код ASA, вы не сможете протестировать его до установки Unity 2020. В противном случае вы сможете проверить приложение на этом этапе.

4. Обновление до Unity 2020.3 LTS

1. Установите последний выпуск исправления LTS для Unity 2020.3.
2. Откройте проект Unity 2019 в Unity 2020.3.

Появится диалоговое окно с запросом на обновление проекта до более новой версии Unity. Нажмите кнопку ПОДТВЕРДИТЬ.

Если вы ранее использовали AR Foundation 2.0, проект автоматически переместится на AR Foundation 4.0.

5. Установка дополнительных пакетов с помощью средства Смешанная реальность Feature Tool

Используйте средство Смешанная реальность Feature Tool для импорта указанных ниже пакетов.

1. Если вы используете ASA, откройте раскрывающийся список Службы azure Смешанная реальность и выберите последнюю версию пакета SDK для пространственных привязок Azure Core и пакет SDK пространственных привязок Azure для Windows.
2. Откройте раскрывающийся список Поддержка платформы и выберите последнюю версию Смешанная реальность подключаемого модуля OpenXR.
3. После загрузки пакетов появится диалоговое окно Предупреждение с запросом на перезапуск редактора Unity, чтобы включить серверные части. Выберите Да.
4. При повторном открытии Unity отображается конфигуратор проектов MRTK . Уделите немного времени, чтобы прочитать объяснения в окне, а затем нажмите кнопку Применить.
5. Появится диалоговое окно с сообщением о том, что для того, чтобы система ввода вступила в силу, необходимо перезапустить Unity. Нажмите кнопку Применить.

6. Настройка управления подключаемыми модулями XR для OpenXR

После повторного открытия Unity можно задать OpenXR в качестве среды выполнения:

1. В строке меню выберите Изменить>параметры проекта.

   Найдите в левом столбце и убедитесь, что вы находитесь на странице управление подключаемыми модулями XR и на вкладке универсальная платформа Windows (на вкладке есть изображение логотипа Windows).

2. В списке Поставщики подключаемых модулей выберите OpenXR.

   

3. В том же разделе выберите Microsoft HoloLens группу компонентов.

4. Обратите внимание, что рядом с OpenXR появился желтый треугольник предупреждения. Наведите указатель мыши на треугольник, прочтите сообщение во всплывающем окне, а затем выберите треугольник.

   

5. В окне OpenXR Project Validation (Проверка проекта OpenXR) указано несколько проблем. Нажмите кнопку Fix All (Исправить все).

   

6. Одна из проблем останется — необходимо добавить по крайней мере один профиль взаимодействия. Для этого нажмите кнопку Изменить. Вы перейдете к параметрам подключаемого модуля OpenXR в окне Параметры проекта .

   

7. Нажмите кнопку "плюс" (+) три раза, каждый раз выбирая другой профиль:

   

   Eye Gaze Interaction Profile (Профиль взаимодействия с помощью взгляда);

   Microsoft Hand Interaction Profile (Профиль взаимодействия с помощью рук Майкрософт);

   Microsoft Motion Controller Profile (Профиль контроллера движений Майкрософт).

   

   Если рядом с Eye Gaze Interaction Profile или любым другим профилем появится желтый треугольник, выберите треугольник, а затем в окне OpenXR Project Validation нажмите кнопку Fix (Исправить).

   

8. В разделе Группы функций OpenXR выберите Microsoft HoloLens, а затем выберите Отслеживание рук и модель контроллера движения, если они еще не выбраны.

   

9. Щелкните раскрывающийся список Depth Submission Mode (Режим отправки глубины), а затем выберите Depth 16 Bit (Глубина 16 бит).

   

10. Закройте окно Параметры проекта и все остальные открытые окна.

Теперь проект полностью перенесен.

См. также раздел

• Обзор OpenXR
• Начало работы с OpenXR
• Дополнительные сведения об OpenXR
• Спецификация OpenXR 1.0
• Справочник по API OpenXR 1.0
• Краткое справочное руководство по OpenXR 1.0