Get Item Score
EnvQueryInstanceBlueprintWrapper
0
Что это
Pure-функция, возвращающая оценку (score) элемента в результатах завершённого EQS-запроса. Вызывается на экземпляре EnvQueryInstanceBlueprintWrapper после того, как запрос выполнен. Позволяет получить числовое значение, присвоенное элементу по указанному индексу.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Item Index (Integer) — индекс элемента в массиве результатов запроса (от 0 до
GetNumItems– 1).
Выходы (данные):
- Return Value (Float) — оценка элемента. Чем выше значение, тем «лучше» элемент по условиям запроса.
Когда используется
- После выполнения EQS-запроса (например, в ноде
Run EQS Queryс выходомOnFinished) — для получения оценки конкретного элемента по его индексу. - В комбинации с
GetQueryResultsAsLocationsилиGetQueryResultsAsActors— чтобы отфильтровать или отсортировать результаты по их оценке.
Типичные проблемы
- Выход за границы массива — если передан
Item Index, превышающий количество элементов в результатах (GetNumItems), вызов приведёт к ошибке доступа (обычно возвращается 0.0). Всегда проверяйте количество элементов перед вызовом. - Вызов до завершения запроса — функция возвращает корректные данные только после того, как EQS-запрос завершился (событие
OnFinished). Попытка получить оценку до этого момента вернёт неопределённое значение. - Неверная интерпретация оценки — значение оценки зависит от настроек тестов в EQS-запросе (нормализация, вес, скоринг). Нельзя сравнивать оценки из разных запросов без учёта их контекста.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.