Развертывание в Oculus Quest — MRTK2

Требуется поиск Oculus.

Поддержка MRTK для Oculus Quest поставляется через два разных источника: конвейер пакета SDK XR Unity и пакет Oculus Integration Unity. Поставщик данных Oculus XRSDK позволяет использовать оба источника и должен использоваться для развертывания MRTK в Oculus Quest.

Конвейер пакета SDK для Unity XR позволяет использовать контроллеры Oculus Touch и отслеживание головы с помощью Oculus Quest. Этот конвейер является стандартом для разработки приложений XR в Unity 2019.3 и выше. Чтобы использовать этот конвейер, убедитесь, что вы используете Unity 2019.3 или более поздней версии. Это необходимо для развертывания приложений MRTK в Oculus Quest.

Пакет Oculus Integration Unity позволяет использовать модели отслеживания рук и контроллеров с помощью Oculus Quest.

Настройка проекта для Oculus Quest

  1. Выполните следующие действия , чтобы убедиться, что проект готов к развертыванию в Oculus Quest.

  2. Включите на устройстве режим разработчика. Устанавливать драйверы ADB для Oculus необязательно.

Настройка конвейера пакета SDK XR для Oculus Quest

  1. Убедитесь, что подключаемый модуль Oculus XR установлен в окне —> диспетчер пакетов

    Пакет подключаемого модуля Oculus XR

  2. Убедитесь, что поставщик подключаемых модулей Oculus включен в проект, перейдя к разделу "Изменение> параметров проекта" -> "Управление подключаемым модулем XR"> — "Поставщики подключаемых модулей"

    Поставщик подключаемого модуля Oculus

Важно!

Подключаемый модуль OpenXR можно использовать для развертывания приложений MRTK в Oculus Quest. Однако визуализация контроллера и отслеживание рук в настоящее время не поддерживаются в OpenXR.

Рекомендуется использовать подключаемый модуль Oculus XR, пока не будет доступна полная поддержка пакета интеграции Oculus.

Настройка пакета Oculus Integration Unity для включения ручного отслеживания

  1. Скачайте и импортируйте интеграцию Oculus из хранилища активов Unity. Последняя версия, протестированная для работы, — 39.0.0. Предыдущие версии не будут работать из-за изменений, внесенных в API Oculus. Все версии пакета интеграции Oculus можно найти в этом архиве.

  2. Перейдите к Смешанная реальность Toolkit > Utilities > Oculus > Integration Oculus Integration Unity Modules. Это приведет к обновлению asmdefs с определениями и ссылками, необходимыми для работы соответствующего кода Oculus Quest. Он также обновит файл csc, чтобы отфильтровать устаревшие предупреждения, созданные ресурсами интеграции Oculus. Репозиторий MRTK содержит файл csc, который преобразует предупреждения в ошибки, это преобразование останавливает процесс настройки MRTK-Quest.

    Oculus Integration Asmdef

  3. В импортированной папке Oculus (его следует найти в Assets/Oculus), есть скриптируемый объект с именем OculusProjectConfig. В этом файле конфигурации необходимо присвоить HandTrackingSupport значение "Контроллеры и руки".

    Контроллер интеграции Oculus и руки

Настройка сцены

  1. Создайте новую сцену Unity или откройте существующую сцену, например HandInteractionExamples.
  2. Добавьте MRTK в сцену, перейдя к Смешанная реальность Toolkit>Add to Scene and Configure.

Использование поставщика данных пакета SDK Oculus XR

  1. Настройка профиля для использования поставщика данных пакета SDK Oculus XR
    • Если не планируется изменять профили конфигурации

      • Используйте любой из профилей MRTK по умолчанию, которые настраиваются в конвейерах XR Unity. Предыдущий defaultXRSDKConfigurationProfile теперь помечен как устаревший.
      • Перейдите к сборке и развертыванию проекта в Oculus Quest.
    • В противном случае выполните следующие действия:

      • Выберите объект игры MixedRealityToolkit в иерархии и выберите " Копировать и настроить ", чтобы клонировать профиль смешанной реальности по умолчанию.

      Клонирование профиля

      • Выберите профиль конфигурации ввода .

      Профиль конфигурации ввода

      • Выберите "Клонировать " в входном системном профиле, чтобы включить изменение.

      Клонирование профиля системы ввода

      • Откройте раздел "Поставщики входных данных" , выберите "Добавить поставщик данных " вверху, а новый поставщик данных будет добавлен в конце списка. Откройте новый поставщик данных и задайте для типаMicrosoft.MixedReality.Toolkit.XRSDK.Oculus OculusXRSDKDeviceManager>.

      Oculus Add XRSDK Data Provider

  1. Настройка профиля для использования поставщика данных пакета SDK Oculus XR
    • Если не планируется изменять профили конфигурации

    • В противном случае выполните следующие действия:

      • Выберите объект игры MixedRealityToolkit в иерархии и выберите " Копировать и настроить ", чтобы клонировать профиль смешанной реальности по умолчанию.

      Клонирование профиля

      • Выберите профиль конфигурации ввода .

      Профиль конфигурации ввода

      • Выберите "Клонировать " в входном системном профиле, чтобы включить изменение.

      Клонирование профиля системы ввода

      • Откройте раздел "Поставщики входных данных" , выберите "Добавить поставщик данных " вверху, а новый поставщик данных будет добавлен в конце списка. Откройте новый поставщик данных и задайте для типаMicrosoft.MixedReality.Toolkit.XRSDK.Oculus OculusXRSDKDeviceManager>.

      Oculus Add XRSDK Data Provider

  1. Поставщик данных пакета SDK Oculus XR включает префаб камеры OVR, который автоматически настраивает проект с помощью OVR Camera Rig и OVR Hands для правильного маршрутизации входных данных. Для добавления в сцену установки камеры OVR вручную потребуется настройка параметров и входных данных вручную.

Создание и развертывание проекта в Oculus Quest

  1. Подключите свой Oculus Quest с помощью кабеля USB 3.0 —> USB C

  2. Выберите File > Build Settings (Файл > Параметры сборки).

  3. Изменение развертывания на Android

  4. Убедитесь, что Oculus Quest выбран в качестве применимого устройства запуска

    Устройство запуска Oculus

  5. Выбор команды "Сборка и запуск"

    • Скорее всего, при первом нажатии кнопки "Сборка и запуск " вы столкнетесь со следующим набором ошибок сборки. При выборе команды "Сборка и запуск " вы сможете успешно выполнить развертывание.

    Ожидаемые ошибки сборки Oculus

  6. Примите запрос "Разрешить отладку USB " из квеста

  7. Просмотр сцены внутри Oculus Quest

Удаление интеграции Oculus из проекта

  1. Перейдите к Смешанная реальность Toolkit > Oculus Separate Oculus > Integration Unity Modules Oculus Separation Asmdef
  2. Пусть Unity обновляется как ссылки на Microsoft.MixedReality.Toolkit.Providers.Oculus.asmdef и другие файлы изменяются на этом шаге.
  3. Закрытие Unity
  4. Закройте Visual Studio, если оно открыто
  5. Откройте проводник и перейдите к корню проекта Unity MRTK
  6. Удаление каталога UnityProjectName/Library
  7. Удаление каталога UnityProjectName/Assets/Oculus
  8. Удаление файла UnityProjectName/Assets/Oculus.meta
  9. Повторное открытие Unity

Распространенные ошибки

Поиск не распознается Unity

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

Изменение > параметров внешних > инструментов > Android

Конфигурация инструментов Android