UFunctions

UFunction 선언

UFunction 은 언리얼 엔진 리플렉션 시스템에 의해 인식되는 C++ 함수입니다. 모든 UObject 또는 블루프린트 함수 라이브러리는 UFUNCTION 매크로를 헤더 파일 내 함수 선언 윗줄에 배치하여 멤버 함수를 UFunction으로 선언할 수 있습니다. 이 매크로는 함수 지정자(Function Specifiers) 가 언리얼 엔진의 함수 해석 및 사용 방식을 변경하도록 지원합니다.

	UFUNCTION([specifier1=setting1, specifier2, ...], [meta(key1="value1", key2, ...)])
	ReturnType FunctionName([Parameter1, Parameter2, ..., ParameterN1=DefaultValueN1, ParameterN2=DefaultValueN2]) [const];

Copy full snippet

UFUNCTION([specifier1=setting1, specifier2, ...], [meta(key1="value1", key2, ...)]) ReturnType FunctionName([Parameter1, Parameter2, ..., ParameterN1=DefaultValueN1, ParameterN2=DefaultValueN2]) [const];

함수 지정자를 사용하면 UFunctions를 블루프린트 비주얼 스크립팅 그래프에 노출할 수 있으며, 이를 통해 개발자는 C++ 코드를 변경하지 않고도 블루프린트 에셋에서 UFunctions를 호출하거나 확장할 수 있습니다.

UFunctions는 클래스의 디폴트 프로퍼티에 있는 델리게이트에 바인딩 가능하여, 액션을 사용자 입력과 연결하는 등의 태스크를 수행할 수 있습니다. 또한 UFunctions는 네트워크 콜백 같은 역할을 할 수도 있는데, 이는 특정 변수가 네트워크 업데이트에 영향을 받을 때마다 UFunctions를 사용하여 알림을 수신하고 커스텀 코드를 실행할 수 있다는 것을 의미합니다.

또한 디버그, 환경설정 또는 치트 코드 명령이라고도 불리는 자신만의 콘솔 명령을 생성할 수도 있습니다. 이러한 콘솔 명령은 개발 빌드에서 게임 콘솔로부터 호출하거나, 레벨 에디터에서 게임 오브젝트에 커스텀 함수 기능이 있는 버튼을 추가할 수 있습니다.

함수 지정자

함수 파라미터 지정자

델리게이트

델리게이트(Delegates) 는 일반적이고, 타입이 안전한 방식으로 C++ 오브젝트에 관한 멤버 함수를 호출할 수 있습니다. 델리게이트는 임의 오브젝트의 멤버 함수에 동적으로 바인딩되어, 호출자가 오브젝트 타입을 모르더라도 미래의 어느 시점에 오브젝트에 관한 함수를 호출할 수 있습니다.

레퍼런스 및 사용 정보는 델리게이트 페이지를 참조하세요.

타이머

타이머(Timers) 는 액션이 딜레이 또는 일정 시간이 지난 후 수행되도록 예약합니다. 예를 들어, 플레이어가 파워업 아이템을 획득한 후 무적 상태가 되고, 10초가 지난 후 무적 상태가 되기 전으로 복원하고 싶을 수 있습니다. 아니면 플레이어가 유독 가스로 가득 찬 방에서 움직이는 동안 초당 1회씩 대미지를 적용하고 싶을 수도 있습니다. 타이머를 사용하여 이러한 액션을 구현할 수 있습니다.

레퍼런스 및 사용 정보는 게임플레이 타이머 페이지를 참조하세요.