Включение поддержки шлемов в проекте EasyAR
В этом документе объясняется, как включить поддержку шлемов в существующей сцене Unity с EasyAR.
Начиная
- Прочтите Поддержка шлемов в EasyAR, чтобы узнать о типах шлемов, поддерживаемых EasyAR, и функциях EasyAR, которые могут работать на шлемах.
- Прочтите Поддержка шлемов EasyAR в Unity, чтобы понять общую архитектуру поддержки шлемов EasyAR в Unity.
В этой статье предполагается, что у вас уже есть сцена, работающая с EasyAR. Если вам нужно создать такую сцену или добавить компоненты EasyAR в сцену для шлема, обратитесь к следующим документам:
Добавление компонентов шлема в сцену
Перед добавлением компонентов шлема в сцену обычно требуется удалить существующую камеру и XR Origin.
Удаление камеры и XR Origin
Удалите существующую камеру в сцене.

Если в сцене уже присутствует XR Origin, независимо от того, происходит ли он из EasyAR или фреймворка Unity XR, в большинстве случаев его необходимо удалить.

Совет
В некоторых продвинутых случаях вы можете решить, удалять ли его, исходя из своих потребностей.
Добавление компонентов шлема
Следуйте официальным инструкциям шлема для добавления его компонентов. Здесь в качестве примера используется шлем Pico; в случае конфликта с официальными инструкциями приоритет имеют они.
Добавьте XR Interaction Manager через меню:

Добавьте XR Origin через меню:

Перед запуском убедитесь, что вы прочитали официальные инструкции шлема, чтобы понять, как следует настраивать и запускать сцену с SDK шлема.
Настройка источника кадров
Устройства со встроенной поддержкой
Выберите AR Session (EasyAR), щелкните правой кнопкой мыши и через меню EasyAR Sense > Head Mounted Display (Built-in) > Frame Source : [Name] (keep it only) создайте источник кадров для [Name] и оставьте только его.
Например, настройка источника кадров для Apple Vision Pro:

После этого источник кадров в сеансе будет выглядеть так:

Совет
Если сеанс уже содержит соответствующий источник кадров устройства, и он является первым доступным источником кадров на устройстве (например, на изображении выше VisionOS ARKit является первым доступным источником кадров в системе visionOS), изменения могут не потребоваться. Некоторые сеансы, созданные по умолчанию через меню, попадают в эту категорию.
Устройства с расширенной поддержкой
Выберите AR Session (EasyAR), щелкните правой кнопкой мыши и через меню EasyAR Sense > Extensions > Frame Source : [Name] (keep it only) создайте источник кадров для [Name] и оставьте только его.
Например, настройка источника кадров для шлема Pico:

После этого источник кадров в сеансе будет выглядеть так:

Поддержка нескольких устройств
Если требуется, чтобы сцена работала на разных устройствах, необходимо оставить другие источники кадров и убедиться, что на текущем устройстве источник кадров может быть выбран.
Использование пунктов меню без (keep it only) позволяет добавить источник кадров, не удаляя другие. Например, EasyAR Sense > Extensions > Frame Source : Pico создаст источник кадров для Pico в конце списка всех источников кадров сеанса. Обычно после добавления источника кадров этим способом его необходимо переместить в нужное положение.
Совет
В некоторых продвинутых случаях вы можете настроить положение источника кадров по своему усмотрению или изменить его в коде.
Следующие шаги
- Настройка проекта для Vision Pro
- Настройка проекта для XREAL
- Настройка проекта для других устройств Android