Set Value As String
BlackboardComponent
0
Что это
Устанавливает значение строковой переменной (String) в заданном компоненте Blackboard по имени ключа. Функция exec (не pure, не async). Изменяет состояние Blackboard непосредственно при выполнении.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения после установки значения
Входы (данные):
- Target (BlackboardComponent) — компонент Blackboard, в котором меняется значение
- KeyName (Name) — имя ключа Blackboard (должен быть типа String)
- StringValue (String) — новое строковое значение
Выходы (данные):
- нет (void)
Когда используется
- Для сохранения строковых данных (имена NPC, названия локаций, текст диалогов) в Blackboard, чтобы другие задачи Behaviour Tree могли их читать.
- При переключении состояний ИИ, когда нужно передать строковый параметр (например, текущий анимационный стейт) между нодами.
Типичные проблемы
- Несовпадение типа ключа: если в Blackboard создан ключ типа не String (например, Name или Object), вызов функции завершится ошибкой на этапе выполнения. Всегда проверяйте соответствие типа.
- Имя ключа с опечаткой: Blackboard не выдаст предупреждение на этапе компиляции, но значение не изменится, если KeyName не совпадает с существующим ключом. Используйте константу, созданную из Blackboard Key Selector.
- Изменение строки в нескольких потоках: если один и тот же Blackboard используется в параллельных задачах (например, в нескольких Concurrent-нодах), непредсказуемый порядок записи может привести к гонке данных.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.