[UE5] #01 GameInstance 상속 받고 Log 출력해보기! (+ 언리얼 코드 컴파일 주의 사항)

결과물

Output Log에 log 띄우기

1단계. Game Instance 상속 받기

- Game Instance?

언리얼 엔진이 제공해주는 게임의 뼈대이다. 그냥 언리얼이 제공해주는 싱글톤 게임 매니저라고 생각하면 쉽다.

이 Game Instance를 상속받아 자신의 게임의 뼈대를 만들 수 있다. 엔진이 초기화된 뒤에 가장 먼저 생성되고 실행되는 객체이며, 게임의 시작되고 종료될 때까지 존재한다. 

- Game Instance 상속 받기

1. tools > New C++ Class 선택하면 다음과 같은 창이 뜬다. All Classes에서 GameInstance를 검색하고, 아래 이미지와 같이 GameInstance를 클릭하면 상속받을 수 있다.

2. Visual Studio로 이동하고 팝업창이 뜨면 'Reload All' 을 선택하면 된다.

3. Solution Explorer 창을 보면 아래 이미지와 같이 내가 상속한 MyGameInstance 클래스를 찾아 볼 수 있다.

2단계. Init() 함수 오버라이드하기

GameInstance의 Init() 함수는 게임이 시작되고 가장 먼저 호출되는 함수이다.

이 함수에서 log를 출력해보자.

1. MyGameInstance 헤더에서 Init()을 오버라이드하자.

2. Init()을 구현하자.

- 부모 클래스의 Init()을 호출해주는 것을 잊지 말자. 주석에 적어 놓은 것처럼 부모 클래스의 이름을 몰라도 혹은 다 적기 귀찮아도 Super를 사용하여 부모 클래스의 함수를 호출할 수 있다.

3단계. UE_LOG() 매크로를 활용하여 Output Log창에 로그 출력하기

UE_LOG(category, verbosity, format) : Output Log창에 문자열을 출력해주는 메크로
- category : 로그 종류. DEFINE_LOG_CATEGORY() 매크로를 통해 직접 정의할 수도 있다. -> 나중에 자세히
- verbosity : 로그 등급. ELogVerbosity를 참고하자!
- format : 출력할 문자열의 형태를 정의한다. printf의 출력 형식(예를 들어, %d) 같은 느낌.
TEXT()->unreal에서 문자열을 사용하기 위한 매크로 함수. 일관적인 문자 인코딩을 위해 사용한다.

4단계. 로그 창 확인하기

에디터에서 게임을 실행한 뒤, OutputLog 창에서 LogTemp를 검색하면 출력한 로그를 확인할 수 있다.

Output Log에 log 띄우기

+) 언리얼 엔진 컴파일 주의 사항

1. 헤더 파일을  수정할 땐 에디터를 끄고 비주얼 스튜디오에서 컴파일한다.

헤더 파일에 변경점이 생긴 경우 언리얼 라이브 코딩에서 오류가 발생할 수 있기 때문이다.

2. 소스 파일만 수정했다면 에디터에서 라이브 코딩으로 컴파일한다. (Ctrl + Alt + F11) 더 빠르다.

3. 비주얼 스튜디오에서 수동으로 클래스 추가하지 말고 에디터에서 tools > New C++ Class 을 통해 클래스를 추가하자.

 

강의 : 이득우 언리얼 프로그래밍 강좌