[Unreal] 인터페이스

🟩 인터페이스

객체가 반드시 구현해야 할 행동을 지정하는데 활용되는 타입

다형성의 구현, 의존성이 분리된 설계에 유용하게 활용

 

🌟 특징

1. 인터페이스를 생성하면 두 개의 클래스가 생성됨

• U로 시작하는 타입 클래스 : 클래스 타입 정보 제공
• I로 시작하는 인터페이스 클래스 : 실질적인 설계 및 구현

2. 객체를 설계할 때 I 인터페이스를 사용

• U 타입 클래스 정보는 런타임에서 인터페이스 구현 여부를 파악하는 용도로 사용됨
• 실제로 U 타입 클래스에서 작업할 일은 없음
• 인터페이스에 관련된 구성 및 구현은 I 인터페이스 클래스에서 진행

3. C++ 인터페이스의 특징

• 추상 타입으로만 선언할 수 있는 Java, C#과 달리 언리얼은 인터페이스에도 구현이 가능함

 

🌟 언리얼 엔진에서 게임 컨텐츠를 구성하는 오브젝트의 설계 예시

월드에 배치되는 모든 오브젝트, 안 움직이는 오브젝트를 포함(actor)

움직이는 오브젝트(pawn) : 길찾기 시스템을 반드시 사용하면서 움직이는 오브젝트

 

 

🍧 예제 : 수업에 참여하는 사람과 참여하지 않는 사람의 구분

• 수업에 반드시 참여해야 하는 학교 구성원 : 학생, 선생
• 수업에 참여하지 않는 학교 구성원 : 교직원
• 수업 행동에 관련된 인터페이스 : ILessonInterface

---

다른 프로젝트에 있는 스크립트 복사해서 붙이기(윈도우 창 내에서) 👉 붙인 후에 refresh 처리해야 제대로 들어옴

 

복사해온 코드를 바로 사용하지 못한다.

해당 코드의 헤더에서 class명을 현재 클래스 헤더로 바꿔주어야 한다.

 

🌟 언리얼 인터페이스

 

생성된 인터페이스 헤더

체크 부분에 인터페이스 기능들을 넣을 수 있다.

 

✨ 인터페이스 헤더(cpp는 수정하지 않음)

// Fill out your copyright notice in the Description page of Project Settings.

#pragma once

#include "CoreMinimal.h"
#include "UObject/Interface.h"
#include "LessonInterface.generated.h"

// This class does not need to be modified.
UINTERFACE(MinimalAPI)
class ULessonInterface : public UInterface
{
	GENERATED_BODY()
};

/**
 * 
 */
class UNREALINTERFACE_API ILessonInterface
{
	GENERATED_BODY()

public:
	// virtual void DoLesson() = 0;

	// 아래와 같이 비어두지 않고 쓸 수도 있다.
	// 이 경우 더이상 추상 클래스가 아니기 때문에 하위 클래스에서 강제로 구현하지 않아도 된다.
	virtual void DoLesson() 
	{
		UE_LOG(LogTemp, Log, TEXT("수업에 입장합니다."));
	}
};

 

✨ Person(h & cpp)

// Fill out your copyright notice in the Description page of Project Settings.

#pragma once

#include "CoreMinimal.h"
#include "UObject/NoExportTypes.h"
#include "Person.generated.h"

/**
 * 
 */
UCLASS()
class UNREALINTERFACE_API UPerson : public UObject
{
	GENERATED_BODY()
	
public:
	UPerson();
	FORCEINLINE FString& GetName() { return Name; }
	FORCEINLINE void SetName(const FString& InName) { Name = InName; }

protected:
	UPROPERTY()
	FString Name;
};

// Fill out your copyright notice in the Description page of Project Settings.


#include "Person.h"

UPerson::UPerson()
{
	Name = TEXT("홍길동");
}

✨ Student (h & cpp)

// Fill out your copyright notice in the Description page of Project Settings.

#pragma once

#include "CoreMinimal.h"
#include "Person.h"
#include "LessonInterface.h"
#include "Student.generated.h"

/**
 * 
 */
UCLASS()
class UNREALINTERFACE_API UStudent : public UPerson, public ILessonInterface
{
	GENERATED_BODY()
	
public:
	UStudent();

	virtual void DoLesson() override;
};

// Fill out your copyright notice in the Description page of Project Settings.


#include "Student.h"

UStudent::UStudent()
{
	Name = TEXT("이학생");
}

void UStudent::DoLesson()
{
	// 상속받는 것이 Person이기 때문에 Super 키워드를 사용하지 못한다.
	ILessonInterface::DoLesson();
	UE_LOG(LogTemp, Log, TEXT("%s님은 공부합니다."), *Name);
}

 

✨ MyGameInstance(h & cpp)

// Fill out your copyright notice in the Description page of Project Settings.

#pragma once

#include "CoreMinimal.h"
#include "Engine/GameInstance.h"
#include "MyGameInstance.generated.h"

/**
 * 
 */
UCLASS()
class UNREALINTERFACE_API UMyGameInstance : public UGameInstance
{
	GENERATED_BODY()
	
public:
	UMyGameInstance();
	virtual void Init() override;

private:
	UPROPERTY();
	FString SchoolName;
};

// Fill out your copyright notice in the Description page of Project Settings.

#include "MyGameInstance.h"
#include "Student.h"
#include "Teacher.h"
#include "Staff.h"

UMyGameInstance::UMyGameInstance() // 생성자 코드
{
	SchoolName = TEXT("기본학교"); // CDO의 기본값 설정
}

void UMyGameInstance::Init()
{
	Super::Init();

	UE_LOG(LogTemp, Log, TEXT("=========="));
	TArray<UPerson*> Persons = { NewObject<UStudent>(), NewObject<UTeacher>(), NewObject<UStaff>()};
	for (const auto Person : Persons) {
		UE_LOG(LogTemp, Log, TEXT("구성원 이름 : %s"), *Person->GetName());
	}
	UE_LOG(LogTemp, Log, TEXT("=========="));

	// 형변환 : 인터페이스를 상속받았는지 여부를 확인할 수 있다(아닐 경우 null 반환)
	for (const auto Person : Persons) {
		ILessonInterface* LessonInterface = Cast<ILessonInterface>(Person);
		
		// 인터페이스가 구현되어 있는 경우
		if (LessonInterface) {
			UE_LOG(LogTemp, Log, TEXT("%s님은 수업에 참여할 수 있습니다."), *Person->GetName());
			LessonInterface->DoLesson();
		}
		else {
			UE_LOG(LogTemp, Log, TEXT("%s님은 수업에 참여할 수 없습니다."), *Person->GetName());
		}
	}
	UE_LOG(LogTemp, Log, TEXT("=========="));
}

---

🍧 언리얼 C++ 인터페이스

• 클래스가 반드시 구현해야 하는 기능을 지정하는데 사용
• C++은 기본적으로 다중상속을 지원하지만, 언리얼 C++의 인터페이스를 사용해 가급적 축소된 다중상속의 형태로 구현하는 것이 향후 유지보수에 도움된다.
• 언리얼 C++ 인터페이스는 두 개의 클래스를 생성한다.
• 언리얼 C++ 인터페이스는 추상 타입으로 강제되지 않고, 내부에 기본 함수를 구현할 수 있다.
• 언리얼 C++ 인터페이스를 사용하면, 클래스가 수행해야 할 의무를 명시적으로 지정할 수 있어 좋은 객체 설계를 만드는데 도움을 줄 수 있다.