본문 바로가기

블루프린트 인터페이스를 통한 통신

인터페이스 메시지로 서로 다른 블루프린트에 공통 기능을 요청하고 직접 참조·디스패처와의 차이를 비교합니다.

밟으면 터지는 발판을 만들고, 주변의 적 인형과 부서지는 상자에 피해를 주고 싶다고 해 봅시다. 적은 체력이 줄고, 상자는 체력이 바닥나면 사라지고, 벽은 아무 일도 없어야 합니다. 직접 참조를 통한 블루프린트 통신처럼 구체 타입으로 부르려면 발판이 "적인가? 상자인가?"를 하나씩 캐스트해 봐야 합니다. 이벤트 디스패처의 기본 사용법의 디스패처는 미리 등록한 수신자에게 알리는 방법이라서, "지금 이 대상"에게 요청하는 일에는 맞지 않습니다.

이 글을 읽고 나면 다음을 할 수 있습니다.

  • 대미지 인터페이스를 정의하고 종류가 다른 두 블루프린트에 각자의 방식으로 구현합니다.
  • 대상의 타입을 모르는 발판에서 인터페이스 메시지로 피해를 요청합니다.
  • 직접 참조, 디스패처, 인터페이스 가운데 상황에 맞는 통신 방법을 고릅니다.

준비물은 앞 글들에서 쓴 Level_1입니다. 인터페이스를 만들고 구현하는 기본 절차는 블루프린트 인터페이스 활용에서 익혔으므로, 이 글은 그 절차를 통신에 적용하는 데 집중합니다.


같은 요청을 다른 대상에게 보내기

인터페이스는 여러 클래스가 구현할 함수의 이름과 입력, 출력만 담고, 실제 처리는 각 클래스에 맡깁니다. 부르는 쪽은 대상이 그 인터페이스를 구현했는지만 따지고, 구현했다면 대상의 클래스와 상관없이 같은 메시지를 보냅니다. 발판은 맞은 것이 적인지 상자인지 몰라도 "피해를 받을 수 있다"는 약속만 보고 요청하고, 적은 적의 방식으로, 상자는 상자의 방식으로 처리합니다.


BPI_Damageable 정의하고 두 대상에 구현하기

  1. 콘텐츠 브라우저에서 Blueprint 메뉴의 Blueprint Interface로 BPI_Damageable을 만듭니다. 함수 ApplyDamage를 추가하고 Float 입력 DamageAmount를 둡니다. 출력은 두지 않습니다. 엔진에도 Apply Damage라는 기본 노드가 따로 있으므로, 뒤에서 노드를 검색할 때 헷갈리지 않게 구별합니다.
  2. Actor를 부모로 BP_Enemy를 만들고 Static Mesh에 큐브를 넣습니다. 툴바의 Class Settings에서 Implemented Interfaces에 BPI_Damageable을 추가하고 컴파일합니다.
  3. Float 변수 CurrentHealth를 만들고 기본값을 50.0으로 둡니다. 마이 블루프린트 패널의 Interfaces 아래 ApplyDamage를 오른쪽 클릭해 Implement Event를 고르고, 아래 그래프를 잇습니다.
  4. 같은 방법으로 BP_DestructibleBox를 만듭니다. CurrentHealth 기본값은 30.0이고, 체력이 0 이하가 되면 Destroy Actor로 사라집니다.
BP_Enemy — 이벤트 그래프
[Event ApplyDamage]  (DamageAmount)
  ─▶ [Set CurrentHealth] ◀ CurrentHealth - DamageAmount
  ─▶ [Print String]  "적 체력: " + CurrentHealth
BP_DestructibleBox — 이벤트 그래프
[Event ApplyDamage]  (DamageAmount)
  ─▶ [Set CurrentHealth] ◀ CurrentHealth - DamageAmount
  ─▶ [Print String]  "상자 체력: " + CurrentHealth
  ─▶ [Branch]  Condition ◀ CurrentHealth <= 0
       True ─▶ [Destroy Actor]  Target ◀ self

두 클래스는 서로 상속 관계가 없지만 같은 인터페이스를 구현합니다. 이제 둘 다 ApplyDamage 메시지를 받을 수 있습니다.


발판에서 메시지 보내기

발판은 앞 글의 스위치와 같은 판에 피해를 줄 대상 목록을 더한 것입니다.

  1. BP_Switch와 같은 방법으로 Static Mesh와 Box Collision을 가진 BP_BlastPad를 만듭니다.
  2. Actor Object Reference 변수 Targets를 만들고, 변수 타입 옆의 컨테이너 아이콘으로 배열(Array)로 바꾼 뒤 Instance Editable을 켭니다.
  3. 아래 그래프를 잇습니다. ApplyDamage를 검색하면 여러 노드가 보이는데, ApplyDamage (Message)를 고릅니다.
  4. 레벨에 BP_BlastPad, BP_Enemy, BP_DestructibleBox를 하나씩 놓습니다. 발판의 디테일 패널에서 Targets에 요소 세 개를 추가하고 차례로 적, 상자, 그리고 레벨에 원래 있던 벽이나 바닥 같은 Static Mesh 액터 하나를 지정합니다. 레벨을 저장합니다.
BP_BlastPad — 이벤트 그래프
[Event ActorBeginOverlap]
  ─▶ [For Each Loop]  Array ◀ Targets
       Loop Body ─▶ [Branch]
                      Condition ◀ [Does Implement Interface]
                                    Test Object ◀ Array Element
                                    Interface   ◀ BPI_Damageable
                      True  ─▶ [ApplyDamage (Message)]
                                 Target       ◀ Array Element
                                 DamageAmount ◀ 20.0
                      False ─▶ [Print String]  "피해를 받지 않는 대상이 있습니다"

Does Implement Interface는 연결된 오브젝트가 그 인터페이스를 구현했는지를 불리언으로 돌려줍니다. 플레이해서 발판을 한 번 밟으면 출력 로그에 무엇이 어떤 순서로 남을까요? 한 번 더 밟으면 어떻게 될까요? 숫자까지 먼저 예상해 보세요.

결과 확인하기

첫 번째로 밟으면 "적 체력: 30.0", "상자 체력: 10.0", "피해를 받지 않는 대상이 있습니다" 순서로 남습니다. For Each Loop가 배열 순서대로 하나씩 처리하고, 메시지를 받은 대상의 이벤트가 그 자리에서 실행되기 때문입니다. 벽은 유효한 액터이지만 인터페이스를 구현하지 않았으므로 False로 갑니다.

두 번째로 밟으면 "적 체력: 10.0", "상자 체력: -10.0"이 나오고 상자가 사라집니다. 세 번째 요소인 벽에서는 다시 "피해를 받지 않는 대상이 있습니다"가 나옵니다. 같은 메시지와 같은 20.0이 갔지만, 상자만 자기 구현에 따라 사라졌습니다.

ApplyDamage (Message) 한 번은 Target에 연결한 오브젝트 하나에만 갑니다. BPI_Damageable을 구현한 모든 액터에 방송되지 않으므로, 여러 대상에게 보내려면 이 글처럼 대상마다 메시지를 보냅니다. 또 메시지 노드는 구현하지 않은 대상에게 보내도 오류 없이 조용히 무시되므로, Branch 없이 메시지만 연결해도 벽에서는 아무 일도 없습니다. 명시적으로 확인해 두면 "피해를 받지 않는 대상"을 따로 처리할 자리가 생깁니다.

이 예제에는 방어력이나 사망 연출, 네트워크 권한이 들어 있지 않습니다. 네트워크 권한은 블루프린트에서의 리플리케이션에서 다룹니다.

증상먼저 볼 곳
세 줄 모두 "피해를 받지 않는 대상이 있습니다"입니다.Does Implement Interface의 Interface 핀에 BPI_Damageable을 골랐는지, 적과 상자의 Class Settings에 인터페이스가 추가되었는지 봅니다.
True로 가는데 체력 줄이 안 나옵니다.엔진의 Apply Damage가 아니라 ApplyDamage (Message)를 골랐는지, 대상 쪽에 Event ApplyDamage를 구현했는지 봅니다.
출력이 하나도 없습니다.레벨에 놓은 발판의 Targets 배열이 비어 있지 않은지 봅니다.

인터페이스 통신이 주는 것

ApplyDamage (Message) 하나가 BP_Enemy와 BP_DestructibleBox에 같은 방식으로 동작하고, 발판은 둘의 구체 클래스를 모릅니다. 이것이 다형성(polymorphism)이자 느슨한 결합입니다. 나중에 깨지는 유리 BP_Glass가 BPI_Damageable을 구현하면, 발판 그래프를 고치지 않고 Targets에 넣기만 해도 같은 피해를 받습니다. 적의 피해 공식을 바꾸는 일도 적의 구현 안에서 끝납니다. 반대로 ApplyDamage의 입력이나 출력을 바꾸면 인터페이스와 모든 구현, 호출부를 함께 고쳐야 합니다.

부딪친 대상에게 피해를 주는 발사체도 같은 구조입니다. 발사체의 Event Hit에서 Other 핀으로 들어온 상대 액터에 같은 확인과 메시지를 보내면 됩니다. 다만 Hit 이벤트가 오려면 콜리전 응답이 Block이어야 하고, 물리 시뮬레이션으로 부딪친다면 Simulation Generates Hit Events도 켜져 있어야 합니다.


세 통신 방법 비교하기

지금까지 본 세 방법은 누구에게 보내는지와 어떻게 연결되는지가 다릅니다.

REFERENCE · SUBSCRIPTION · INTERFACE

호출 대상과 연결 조건으로 통신 방식을 선택합니다

직접 참조와 인터페이스 메시지는 지정한 객체 하나를 대상으로 합니다. 이벤트 디스패처는 소유자에 현재 바인드된 수신자들에게 사건을 알립니다.

통신 대상과 연결 조건 비교
방식연결과 호출 범위선택할 상황·확인할 조건
직접 참조구체 타입의 인스턴스 하나를 참조하여 호출그 타입의 변수·기능이 필요할 때. 호출 전 유효성과 접근 권한 확인
이벤트 디스패처수신자가 소유자 참조로 바인드하고, 호출 시 현재 구독자들에게 알림사건에 여러 대상이 반응할 때. 등록 전 알림은 재생되지 않으며 해제 시점 관리
인터페이스대상 참조 하나에 공통 인터페이스의 메시지 호출서로 다른 클래스의 같은 능력을 요청할 때. 미구현 대상의 Message는 조용히 무시됨
방식: 직접 참조
연결과 호출 범위: 구체 타입의 인스턴스 하나를 참조하여 호출
선택할 상황·확인할 조건: 그 타입의 변수·기능이 필요할 때. 호출 전 유효성과 접근 권한 확인
방식: 이벤트 디스패처
연결과 호출 범위: 수신자가 소유자 참조로 바인드하고, 호출 시 현재 구독자들에게 알림
선택할 상황·확인할 조건: 사건에 여러 대상이 반응할 때. 등록 전 알림은 재생되지 않으며 해제 시점 관리
방식: 인터페이스
연결과 호출 범위: 대상 참조 하나에 공통 인터페이스의 메시지 호출
선택할 상황·확인할 조건: 서로 다른 클래스의 같은 능력을 요청할 때. 미구현 대상의 Message는 조용히 무시됨

인터페이스에도 대상 참조가 필요합니다. 세 방식 모두 자동 네트워크 RPC는 아니며, 멀티플레이어 동기화는 별도로 설계합니다.

직접 참조는 구체 타입의 인스턴스 하나를 불러 그 타입만의 기능을 쓸 때, 디스패처는 한 사건에 등록된 여러 수신자가 반응할 때, 인터페이스는 종류가 다른 대상에게 같은 능력을 요청할 때 고릅니다. 그림 아래의 설명처럼 인터페이스에도 대상 참조는 필요하며, 세 방법 모두 네트워크 동기화를 자동으로 하지 않습니다. 어느 한 방법이 항상 낫지는 않으므로, 대상이 하나인지 여럿인지와 대상의 구체 타입을 알아야 하는지를 먼저 따집니다.


정리

  • 인터페이스 통신은 대상이 인터페이스를 구현했는지만 보고 같은 메시지를 보내며, 실제 처리는 대상의 구현이 맡습니다.
  • Does Implement Interface와 Branch로 확인하면 피해를 받지 않는 대상을 따로 처리할 수 있습니다.
  • 메시지 한 번은 Target의 오브젝트 하나에만 가고, 구현하지 않은 대상에서는 조용히 무시됩니다.
  • 직접 참조는 특정 인스턴스와 그 타입의 기능이, 디스패처는 한 사건의 여러 수신자가, 인터페이스는 여러 클래스의 같은 능력이 필요할 때 알맞습니다.

연습 문제

1. 유효한 벽

Targets의 세 번째 요소인 벽은 유효한 액터입니다. 유효한 액터라면 대미지를 처리할 수 있다는 뜻일까요? Branch를 빼고 메시지를 바로 보냈다면 벽에서는 무슨 일이 일어날까요?

해설 보기

아닙니다. 유효한 오브젝트인지와 인터페이스를 구현했는지는 서로 다른 조건이므로, 벽은 유효하지만 Does Implement Interface는 거짓을 돌려줍니다. Branch를 빼면 벽에 보낸 메시지는 오류 없이 무시되고 아무 출력도 없습니다. 그래서 피드백이 필요할 때만 명시적인 확인이 의미가 있습니다.

2. 한 번 밟았는데 두 번 깎인 적

발판을 한 번 밟았는데 "적 체력: 30.0"과 "적 체력: 10.0"이 연달아 나왔습니다. 상자 줄은 한 번만 나왔습니다. 무엇을 확인하고 어떻게 고칠까요?

해설 보기

Targets 배열에 같은 적이 두 번 들어 있을 가능성이 큽니다. 겹침이 두 번 일어났다면 상자 줄도 두 번 나와야 하는데, 적만 두 번이므로 반복의 대상 목록을 의심합니다. 레벨에 놓은 발판의 디테일 패널에서 Targets의 중복 요소를 지웁니다. 겹침 자체가 두 번 일어나는 문제라면 모든 줄이 두 번씩 나오며, 이때는 판과 상자 영역이 따로 겹치는지 봅니다.

3. 상황에 맞는 통신 방법

다음 세 상황에 직접 참조, 이벤트 디스패처, 인터페이스 가운데 무엇이 알맞은지 골라 보세요. 보스가 죽으면 출구 문과 HUD, 배경 음악이 각자 반응하는 경우, 스위치가 바로 옆의 특정 문 하나를 여는 경우, 폭발이 범위 안의 나무와 적, 상자에 각자 다른 피해를 주는 경우.

해설 보기

보스의 죽음은 한 사건에 여러 대상이 반응하므로 디스패처가 알맞습니다. 스위치와 특정 문은 일대일이고 스위치가 그 문을 정확히 알고 있으므로 4장 첫 글처럼 직접 참조가 가장 간단합니다. 폭발은 종류가 다른 대상에게 같은 요청을 보내고 각자 다르게 반응하게 해야 하므로 인터페이스가 알맞습니다. 이때도 범위 안의 대상을 찾아 각각에 메시지를 보내야 합니다.

4. 발판을 밟은 캐릭터도 피해 받기

발판을 밟은 캐릭터도 피해를 받게 만들어 보세요.

  • BP_ThirdPersonCharacter에 BPI_Damageable을 추가하고, CurrentHealth(기본값 100.0)를 줄여 "캐릭터 체력: "과 함께 출력합니다.
  • BP_BlastPad는 Targets 처리를 마친 뒤, 겹친 Other Actor에도 같은 확인을 거쳐 20.0을 보냅니다.
  • 발판을 한 번 밟으면 캐릭터 줄은 80.0으로 한 번 나옵니다.
해설 보기
BP_ThirdPersonCharacter — 이벤트 그래프에 추가
[Event ApplyDamage]  (DamageAmount)
  ─▶ [Set CurrentHealth] ◀ CurrentHealth - DamageAmount
  ─▶ [Print String]  "캐릭터 체력: " + CurrentHealth
BP_BlastPad — For Each Loop의 Completed에 추가
[For Each Loop]
  Completed ─▶ [Branch]
                 Condition ◀ [Does Implement Interface]
                               Test Object ◀ Other Actor
                               Interface   ◀ BPI_Damageable
                 True ─▶ [ApplyDamage (Message)]
                           Target       ◀ Other Actor
                           DamageAmount ◀ 20.0

Completed는 반복이 모두 끝난 뒤 한 번 실행되므로, 적과 상자 줄 다음에 "캐릭터 체력: 80.0"이 나옵니다. 발판 그래프는 대상이 캐릭터라는 사실을 전혀 모릅니다. 캐릭터가 인터페이스를 구현했다는 것만으로 같은 메시지를 받습니다. 캐릭터의 Class Settings에 인터페이스를 추가하지 않으면 False로 가서 아무 일도 없습니다.

통신 방법별로 알맞은 상황은 언리얼 엔진 공식 문서의 블루프린트 통신 사용법에서 확인할 수 있습니다.

다음 글 게임 인스턴스 활용 데이터 공유에서는 레벨이 바뀌어도 사라지지 않는 게임 인스턴스에 점수를 두고, 두 레벨이 함께 쓰게 합니다.