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

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

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

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

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

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

Примечание.

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

1. Откройте средство компонента Microsoft Смешанная реальность и нажмите кнопку "Пуск".

   

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

   

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

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

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

   

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

Импорт функций

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

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

Дополнительные сведения о средстве компонента Смешанная реальность.

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

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

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

В этом случае может появиться кнопка "Установить подключаемый модуль XR ". Если да, перейдите к приведенным ниже шагам. Если у вас уже установлена система управления XR, можно пропустить остальные действия, описанные в этом разделе, и перейти к следующему разделу :"Windows Смешанная реальность".

1. Нажмите кнопку "Установить подключаемый модуль XR".

2. Откроется диалоговое окно с именем "Встроенная виртуальная реальность" , и запрашивает, нужно ли удалить встроенный пакет виртуальной реальности. Нажмите кнопку ОК.

   

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

4. Откроется окно настройки проекта MRTK и запросы, которые можно включить конвейер XR. Выберите второй вариант, пакет SDK XR или УПРАВЛЕНИЕ SR.

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

3. Выберите "Windows Смешанная реальность"

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

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

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. Используйте средство компонента Смешанная реальность для установки дополнительных пакетов

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

1. Откройте раскрывающийся список поддержки платформы и выберите последнюю версию подключаемого модуля OpenXR Смешанная реальность.
2. После загрузки пакетов появится диалоговое окно "Предупреждение ", запрашивающее, нужно ли перезапустить редактор Unity, чтобы включить серверные части. Выберите Да.
3. При повторном открытии Unity появится модуль настройки проекта MRTK. Ознакомьтесь с объяснениями в окне, а затем нажмите кнопку "Применить".
4. Появится диалоговое окно, указывающее, что 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