블루프린트에 게임플레이 요소 노출하기

프로그래머 입장에서 블루프린트 작업을 하면 코드가 엄청 유연해지는 여러가지 장점이 있습니다. 예를 들어 게임플레이 디자이너가 게임에 새로운 유형의 무기를 구현하고 싶을 수가 있습니다. 그러면 프로그래머는 이전처럼 무기를 코딩하지만, 발사 속도라던가 Fire() 함수 등 중요한 함수성 몇을 노출시킵니다. 플레이테스트 이후 디자이너가 총 발사속도를 바꿔야 겠다 결정하고 커브 작업을 합니다. 총 발사속도를 다시 코딩하고 게임을 컴파일하기 보다, 디자이너가 그냥 블루프린트로 들어가서 직접 발사속도를 변경하면 되니, 디자이너에게도 프로그래머에게도 시간 절약입니다.

프로젝트의 C++/블루프린트 배포 최적화 관련 상세 정보, 또는 블루프린트에 노출되는 API 제작시 유념할 팁에 대해서는 블루프린트에 c++ 노출하기 페이지를 참고하세요.

Blueprintable 클래스 만들기

어느 한 클래스를 확장하여 블루프린트를 만들기 위해서는, 해당 클래스는 Blueprintable 키워드로 정의해야 합니다. 그러기 위해서는 클래스 정의부에 선행하는 UCLASS() 매크로 안에 해당 키워드를 추가해 줘야 합니다. 이 키워드는 해당 클래스를 블루프린트 시스템에 인식시켜 새 블루프린트 대화창의 클래스 목록에 표시되도록 하며, 블루프린트 생성시 부모로 선택할 수 있도록 만듭니다.

Blueprintable 클래스에 대한 가장 단순한 형태의 선언은 다음과 이렇습니다:

	UCLASS(Blueprintable)
	class AMyBlueprintableClass : AActor
	{
		GENERATED_BODY()
	}
Copy full snippet

UCLASS(Blueprintable) class AMyBlueprintableClass : AActor { GENERATED_BODY() }

읽기가능 및 쓰기가능 프로퍼티

C++ 클래스에서 정의된 변수를 해당 클래스에서 확장된 블루프린트에 노출시키기 위해서는, 변수 정의부 앞 UPROPERTY() 매크로 안에서 아래 나열된 키워드 중 하나를 사용해서 변수를 정의해 줘야 합니다. 이 키워드는 블루프린트 시스템에 변수를 알려 내 블루프린트 패널에 표시되도록 하여 그 값을 설정하고 접근할 수 있습니다.

	//Character's Health
	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Character")
	float health;

Copy full snippet

//Character's Health UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Character") float health;

실행가능 및 덮어쓰기가능 함수

블루프린트에서 네이티브 함수를 호출하기 위해서는, 함수 정의부 앞에 오는 UFUNCTION() 매크로 안애서 아래 나열된 키워드 중 하나를 사용하여 함수를 정의해 줘야 합니다. 이 키워드는 블루프린트 시스템에 함수를 인식시켜 컨텍스트 메뉴나 팔레트에 나타나도록 함으로써 그래프에 추가하여 실행되도록 할 수도 있고, 이벤트의 경우 덮어쓰거나 실행되도록 할 수도 있습니다.

BlueprintCallable 함수의 가장 단순한 형태의 선언은 다음과 같습니다:

	//무기 발사
	UFUNCTION(BlueprintCallable, Category="Weapon")
	void Fire();

Copy full snippet

//무기 발사 UFUNCTION(BlueprintCallable, Category="Weapon") void Fire();

참고로 함수의 시그너처를 만들 때, 파라미터를 레퍼런스 전달하도록 만들면 블루프린트에서 출력 핀이 됩니다. 파라미터를 레퍼런스 전달하도록 하면서 동시에 입력으로 표시하려면, UPARAM() 매크로를 사용하세요.

	UFUNCTION(BlueprintCallable, Category = "Example Nodes")
	static void HandleTargets(UPARAM(ref) TArray<FVector>& InputLocations, TArray<FVector>& OutputLocations);

Copy full snippet

UFUNCTION(BlueprintCallable, Category = "Example Nodes") static void HandleTargets(UPARAM(ref) TArray<FVector>& InputLocations, TArray<FVector>& OutputLocations);

또한 UPARAM() 을 사용하여 핀 표시면을 변경할 수도 있습니다. 예를 들어 KismetMathLibrary 의 MakeRotator 함수는 UPARAM() 과 DisplayName 키워드를 사용하여 블루프린트에 Roll, Pitch, Yaw 파라미터가 나타나는 방식을 변경합니다.

	/** Makes a rotator {Roll, Pitch, Yaw} from rotation values supplied in degrees */
	UFUNCTION(BlueprintPure, Category="Math|Rotator", meta=(Keywords="construct build rotation rotate rotator makerotator", NativeMakeFunc))
	static FRotator MakeRotator(
	UPARAM(DisplayName="X (Roll)") float Roll,
	UPARAM(DisplayName="Y (Pitch)") float Pitch,
	UPARAM(DisplayName="Z (Yaw)") float Yaw);
Copy full snippet

/** Makes a rotator {Roll, Pitch, Yaw} from rotation values supplied in degrees */ UFUNCTION(BlueprintPure, Category="Math|Rotator", meta=(Keywords="construct build rotation rotate rotator makerotator", NativeMakeFunc)) static FRotator MakeRotator( UPARAM(DisplayName="X (Roll)") float Roll, UPARAM(DisplayName="Y (Pitch)") float Pitch, UPARAM(DisplayName="Z (Yaw)") float Yaw);