Add AR Environment Probe
ARBlueprintLibraryЧто это
Exec-функция для добавления ручной (созданной в редакторе) AR-сцены в сессию дополненной реальности. Позволяет указать локацию и размеры куба-зонда, который будет использоваться для захвата окружения (environment probe) в ARKit/ARCore.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- Location (Vector) — мировые координаты центра зонда
- Extent (Vector) — размеры зонда (половина размера по каждой оси, т.е. Box Half Extent)
Выходы (данные):
- ReturnValue (UAREnvironmentProbeComponent*) — созданный компонент зонда (или null, если не удалось)
Когда используется
При создании статичных AR-зондов окружения (например, для отражений на виртуальных объектах в реальной среде). Обычно вызывается один раз при старте AR-сессии или при размещении зонда вручную.
Типичные проблемы
- Extent задан как полный размер, а не половина — функция ожидает Half Extent (как Box Collision), передача полного размера приводит к зонду в 2 раза больше нужного.
- Зонд не обновляется — ручной зонд не захватывает окружение автоматически, требуется явный вызов
RefreshEnvironmentCaptureProbeили ожидание обновления от AR-системы. - Location вне диапазона AR-трекинга — зонд должен находиться в пределах отслеживаемого пространства (например, в зоне видимости камеры для ARKit).