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

Чтобы настроить сцену XR, добавьте XR Начало.

Эти объекты представляют собой коллекции GameObjects и компонентов, которые обеспечивают систему отсчета для преобразования данных пространственного отслеживания в сцену, включая управление камерой сцены. Когда вы добавляете XR Начало в сцену, он управляет подключенной камерой для отслеживания головного (VR) или ручного (AR) устройства пользователя. Кроме того, версии XR Origin, содержащие GameObjects для контроллеров, будут перемещать их для отслеживания контроллеров пользователя.

Примечания::

Старое имя XR Буровая установка было изменено с “rig” на “origin”, чтобы лучше отразить роль объекта в сцене Unity. Кроме того, компонент XR Начало заменил компонент Camera Перенос и предоставляет несколько дополнительных настроек. См. Компонент XR Origin для дополнительной информации.
Вариант Преобразовать Camera в XR Риг по-прежнему появляется в меню GameObject > XR, если в вашем проекте не установлен пакет XR Interaction Toolkit. Хотя этот вариант по-прежнему работает, Unity рекомендует использовать соответствующий вариант XR Начало из пакетов XR Interaction Toolkit или AR Foundation для наилучшей совместимости с другими возможностями XR.
Параметры AR Session Origin были заменены параметрами XR Происхождение (AR) и XR Происхождение (Мобильный AR) в версии 5 пакета Foundation AR.
Контроллер GameObjects, входящий в состав некоторых объектов XR Начало, не имеет визуальных компонентов, таких как сетка, и не настроен на получение ввода пользователя, кроме данных отслеживания. Вы должны добавить модели 3D и компоненты или скрипты, необходимые для действий по вводу пользователя, если это необходимо. Пакет XR Набор инструментов взаимодействия предоставляет компоненты для обработки ввода пользователя.

См. XR Начало для описания параметров XR Origin, доступных для использования в сцене.

Предварительные условия

Прежде чем настроить сцену для XR, вы должны сначала:

Настройка проекта для XR.
Добавьте AR Foundation в проект, если вы разрабатываете приложение AR.
Добавьте пакет XR Interaction Toolkit, если вы планируете его использовать (рекомендуется).
Если вы используете XR Interaction Toolkit, импортируйте Starter Assets. Эти ассеты содержат действия Input System и предварительные настройки, которые можно использовать для настройки входа контроллера XR.

Настройка сцены для XR

Основные шаги для создания сцены для XR включают в себя:

Создать или открыть сцену в Unity Editor.
Добавить одно из следующих: XR Происхождение варианты к сцене с GameObject > XR меню. Вы увидите различные варианты в меню в зависимости от того, XR пакетов, которые вы добавили в свой проект. См. XR Происхождение для описания имеющихся XR Варианты происхождения.
Настройка входа XR. Дополнительные сведения см. в разделе XR параметры входа.

Ваши проекты могут иметь дополнительные настройки в зависимости от типа проекта, платформы и пакетов Unity, которые вы планируете использовать:

Для проектов AR, обратитесь к Настройка сцены в руководстве AR Foundation для дополнительных шагов настройки и более подробных инструкций.
Для проектов VR, использующих XR Interaction Toolkit, см. General Setup в руководстве по Interaction Toolkit для дополнительной информации.
Для AR/MR проектов на Apple Vision Pro, используйте том Camera вместо XR источника. См. PolySpatial visionOS: Запуск нового visionOS проекта.
Для проектов VR на Apple Vision Pro, вы должны добавить объект AR Сессия из пакета AR Фонд в сцену, чтобы получить доступ к данным отслеживания головы и руки. Приложения VR на этом устройстве также имеют доступ к дополнительным данным ARKit, таким как обнаружение плоскости, меши реконструкции сцены и отслеживание изображения. См. Fully Immersive VR на visionOS.

Определить, включено ли XR

Если у вас есть сцена, которая может быть использована как в контексте XR, так и в контексте, не относящемся к XR, вы можете использовать свойства XRSettings.enabled для определения того, загружена ли и активна ли подсистема XR в данный момент. С помощью этой информации вы можете активировать или деактивировать соответствующие наборы GameObjects и компонентов.

public void CheckXRStatus()
{
    if (UnityEngine.XR.XRSettings.enabled)
    {
        Debug.Log("XR is active.");
    }
    else
    {
        Debug.Log("XR is not available.");
    }
}

Обратите внимание: вы можете прочитать значение свойства XRSettings.enabled для определения состояния XR. Однако установка значения больше не поддерживается и не делает ничего. Информацию о том, как динамически включать и выключать XR во время выполнения, см. в Управление жизненными циклами загрузчика XR.