Get Actor Of Class
GameplayStaticsЧто это
Pure-функция, возвращающая один актёр указанного класса в текущем мире. При наличии нескольких актёров возвращает любой (неопределённый). Используется для быстрого доступа без перебора.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- World Context Object (Object) — контекст мира (обычно self)
- Actor Class (Actor Class Reference) — класс искомого актёра
Выходы (данные):
- Return Value (Actor) — найденный актёр или None, если не найден
Когда используется
Когда нужно быстро получить ссылку на единственный экземпляр класса (например, GameMode, PlayerController, уникальный менеджер) без использования Get All Actors Of Class и последующего взятия первого элемента.
Типичные проблемы
- Если в мире несколько актёров заданного класса, функция возвращает произвольного — порядок не гарантирован.
- Передача неправильного класса (например, класса, не унаследованного от Actor) приводит к None; проверка класса обязательна.
- Возвращаемый актёр может быть помеченным на удаление или невалидным — рекомендуется проверять IsValid.