UE4 C++ Interface + Anim Notify 사용법
게임 구현하면서 서로 다른 클래스끼리 통신을 할때 각 클래스에 Interface클래스를 상속시켜서 쉽게 통신을 할 수 있습니다.
해당 게시글에서는 Interface + Notify를 이용하여 장전하는 애니메이션에서 장전되는 순간 함수가 호출되는 기능을 만들어 보겠습니다.
1. TPS 샘플 프로젝트에 장전하는 애니메이션 기능 추가
ACharacther.h
#include "EngineMinimal.h"
#include "GameFramework/Character.h"
#include "TestCharacter.generated.h"
UCLASS(config=Game)
class ATestCharacter : public ACharacter
{
GENERATED_BODY()
...
...
...
private :
//! 애니메이션 시퀸스 변수
UPROPERTY(EditDefaultsOnly, Category = Animation, Meta = (AllowPrivateAccess = true))
class UAnimSequenceBase* m_pAnimSequence_Reload;
ACharacter.cpp
ACharacter::ACharacter()
{
...
...
...
static ConstructorHelpers::FObjectFinder<UAnimSequenceBase> Asset_AnimMtg(TEXT("AnimSequence'/Game/Reload_Rifle_Ironsights.Reload_Rifle_Ironsights'")); //! 경로 입력
if (Asset_AnimMtg.Succeeded())
{
m_pAnimSequence_Reload = Asset_AnimMtg.Object; //! 시퀸스 변수 세팅
}
...
...
...
}
//! 키바인딩 함수 -> 애니메이션을 Default Slot에 재생
void ACharacter::Action_Reload()
{
UAnimMontage* pAnimationMtg = GetMesh()->GetAnimInstance()->PlaySlotAnimationAsDynamicMontage(m_pAnimSequence_Reload, TEXT("DefaultSlot"), 0.3f, 0.3f, 1.0f);
PlayAnimMontage(pAnimationMtg, 1.0f);
}
애니메이션 블루프린트의 Anim Grap에 Default Slot 노드 추가합니다, Slot을 이용해서 Full Body 애니메이션을 돌릴 예정입니다.
장전 애니메이션 재생기능 세팅 완료
2. Interface Class 제작
Itf_AnimationNotify.h
#include "CoreMinimal.h"
#include "UObject/Interface.h"
#include "Itf_AnimationNotify.generated.h"
// This class does not need to be modified.
UINTERFACE(MinimalAPI)
class UItf_AnimationNotify : public UInterface
{
GENERATED_BODY()
};
/**
*
*/
class TEST_API IItf_AnimationNotify
{
GENERATED_BODY()
public:
//! 사용할 Interface 함수 코드 추가 (여러 개 가능)
UFUNCTION(BlueprintNativeEvent, BlueprintCallable, Category = "Itf_Reload") //! Blueprint상에서 사용할 수 있도록 UFunction세팅
void Itf_ReloadDone(int nTestValue);
};
Itf_AnimationNotify.cpp 파일은 따로 수정하지 않습니다,
ACharacter.h
#include "Itf_AnimationNotify.h" //! Interface클래스 Include
#include "EngineMinimal.h"
#include "GameFramework/Character.h"
#include "TestCharacter.generated.h"
UCLASS(config=Game)
class ATestCharacter : public ACharacter, public IItf_AnimationNotify //! Interface 클래스 상속
{
GENERATED_BODY()
...
...
...
public :
//! 실제 구현 부 함수 정의
UFUNCTION(BlueprintCallable, BlueprintNativeEvent, Category = "Itf_Reload")
void Itf_ReloadDone(int nTestValue);
virtual void Itf_ReloadDone_Implementation(int nTestValue) override;
...
...
...
}
ACharacter.cpp
...
...
//! Interface함수 호출시 호출될 함수 선언
void ACharacter::Itf_ReloadDone_Implementation(int nTestValue)
{
UE_LOG(LogTemp, Warning, TEXT("Reload Done_%d"), nTestValue);
}
...
...
정의부분에서는 "Implementation"가 붙은 함수와 붙지 않은 함수 2개를 만들었지만 cpp선언에서는 "Implementation"가 붙은 함수만 작성합니다.
이것으로 Interface함수 세팅은 완료입니다.
인터페이스 함수 호출하는 법
ACharacter* pCharacter = FindActor("Charactor"); //! 해당 클래스 포인터 가져오기
if (ACharacter->GetClass()->ImplementsInterface(UItf_AnimationNotify::StaticClass()) == true) //! 해당 클래스에 해당 Interface클래스가 존재하는지 확인
{
IItf_AnimationNotify::Execute_Itf_ReloadDone(pCharacter, 123456); //! 함수 호출,
//! 1번 인자 : 호출할 클래스
//! 2번 인자 뒤 : 정의한 함수 인자
}다른 클래스에서 호출할때는 정의한 함수 명 앞에 "Execute_"를 붙여야 합니다.
2. Anim Notify 제작 후 Interface 연동
Anim Notify Blueprint 클래스를 제작합니다.
Override함수를 생성하여 위 사진과 같이 Interface함수를 호출하는 노드를 제작합니다.
장전 애니메이션에서 장전이 완료되는 부분에 Notify 추가하고 우측 디테일 패널에서 인자값을 넣을 수 있습니다.
로그로 테스트 결과 성공적으로 Notify + Interface가 동작되는 것을 확인 했습니다.
참고자료
https://wiki.unrealengine.com/Interfaces_in_C%2B%2B