Add Runtime Candidate Image
ARBlueprintLibrary
0
Что это
Статическая exec-функция, добавляющая кандидата изображения для AR-трекинга во время выполнения (runtime). Позволяет динамически загружать и использовать изображения-маркеры без предварительной компиляции в контент. Возвращает созданный объект UARCandidateImage.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- Target (ARSessionConfig) — конфигурация AR-сессии, в которую добавляется кандидат
- Candidate Texture (Texture2D) — текстура изображения-кандидата (должна быть в формате, поддерживаемом ARKit/ARCore)
- Friendly Name (String) — удобочитаемое имя для идентификации кандидата
- Physical Width (Float) — физическая ширина изображения в метрах (используется для оценки расстояния)
Выходы (данные):
- Return Value (ARCandidate Image) — созданный объект кандидата (можно использовать для дальнейшей настройки или проверки)
Когда используется
- Динамическая загрузка изображений-маркеров из интернета или пользовательского контента.
- Обновление набора трекинг-изображений без перезапуска AR-сессии.
- Создание AR-опыта, где пользователь сам выбирает или загружает изображение для трекинга.
Типичные проблемы
- Неподходящий формат текстуры — текстура должна быть сжата в формат, поддерживаемый платформой (например, RGBA8, с MIP-картами). Использование несжатых или неподдерживаемых форматов приведёт к ошибке создания кандидата.
- Некорректная физическая ширина — слишком маленькое или нулевое значение
Physical Widthнарушает логику трекинга; рекомендуется задавать реальную ширину физического объекта. - Дублирование имени —
Friendly Nameдолжен быть уникальным в рамках сессии; повторное добавление с тем же именем может перезаписать предыдущего кандидата или вызвать конфликт.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.