충돌 채널과 프로파일 설정
오브젝트·트레이스 채널과 충돌 프로파일의 Block·Overlap·Ignore 응답을 읽고, 오버랩 이벤트를 받는 트리거 볼륨으로 응답 조합을 확인합니다.
캐릭터는 벽을 뚫고 지나가면 안 되지만, 바닥에 떨어진 아이템 위로는 지나가면서 "주웠다"는 사실을 알려야 합니다. 총알은 적에게 맞아야 하지만 총을 쏜 무기 자신에게 맞아서는 안 됩니다. 이처럼 물체마다 무엇과 부딪히고, 무엇과 겹치기만 하고, 무엇을 무시할지가 다릅니다. 이 관계를 물체마다 따로 설정하면 실수가 생기기 쉽고, 규칙이 바뀔 때 고칠 곳도 많아집니다.
이 글을 읽고 나면 다음을 할 수 있습니다.
- 컴포넌트의 디테일 패널에서 충돌 프리셋과 채널별 응답을 읽습니다.
- 플레이어가 들어오고 나갈 때 로그를 남기는 C++ 트리거 볼륨
AMyTriggerVolume을 만듭니다. - 두 컴포넌트의 응답을 보고 막힘, 겹침, 무시 가운데 무엇이 될지 예상하고 플레이로 확인합니다.
이 장은 첫 번째 C++ 프로젝트 생성에서 만든 Third Person 템플릿 프로젝트를 씁니다. 템플릿의 캐릭터 블루프린트 BP_ThirdPersonCharacter(콘텐츠 브라우저의 Content/ThirdPerson/Blueprints)와 기본 레벨을 그대로 쓰고, 5장의 글마다 이 레벨에 상호작용할 물체를 하나씩 더해 갑니다. Pawn, Character, Controller 이해에서 이 레벨의 World Settings에 GameMode Override를 BP_MyGameMode로 정해 두었다면, 그 칸을 None으로 되돌리고 레벨을 저장해 템플릿 캐릭터가 나오게 합니다. C++ 클래스를 만들고 빌드하는 순서는 C++로 Blueprint 클래스 확장에서 본 것과 같습니다. 예제 헤더의 MYPROJECT_API는 모듈 이름이 MyProject일 때의 매크로이므로, 프로젝트 이름이 다르면 마법사가 만든 헤더에 적힌 매크로를 씁니다. 로그는 Window > Output Log로 여는 Output Log 창에서 봅니다.
막을 것인가, 겹침만 알릴 것인가
언리얼에서 충돌은 액터가 아니라 컴포넌트 사이에서 판정됩니다. 캡슐, 박스, 메시처럼 충돌 형상을 가진 컴포넌트(UPrimitiveComponent의 자식)가 다른 컴포넌트를 만나면, 엔진은 둘이 서로에게 어떻게 응답하기로 했는지 보고 결과를 정합니다.
응답은 세 가지입니다. 블록(Block)은 이동이나 물리 접촉에서 통과를 막는 응답으로, 캐릭터가 벽에 부딪혀 멈추는 경우입니다. 오버랩(Overlap)은 막지 않고 겹쳤다는 사실만 감지하는 응답으로, 플레이어가 아이템 위에 서는 경우입니다. 무시(Ignore)는 아무 반응도 하지 않습니다. 이 글의 실습은 이 세 응답이 실제 플레이에서 어떻게 다르게 보이는지 차례로 확인하는 것입니다.
캐릭터 캡슐의 충돌 설정 읽기
먼저 이미 있는 캐릭터가 어떻게 설정되어 있는지 봅니다.
- 콘텐츠 브라우저에서
Content/ThirdPerson/Blueprints의BP_ThirdPersonCharacter를 더블 클릭해 블루프린트 에디터를 엽니다. - 왼쪽 위 컴포넌트(Components) 패널에서
CapsuleComponent를 선택합니다. - 오른쪽 디테일 패널의 검색창에
Collision을 입력하고,Collision Presets왼쪽의 화살표를 눌러 펼칩니다.
여기까지 하면 Collision Presets에 Pawn이 선택되어 있고, 그 아래에 Collision Enabled, Object Type, 그리고 채널 이름이 줄지어 있는 응답 표가 회색으로 보입니다. 프리셋을 고른 상태에서는 표를 직접 고칠 수 없기 때문에 회색입니다.
| 다를 때 | 먼저 볼 곳 |
|---|---|
BP_ThirdPersonCharacter가 보이지 않음 | 프로젝트를 Third Person 템플릿으로 만들었는지, 콘텐츠 브라우저 검색창에 이름을 입력해 찾을 수 있는지 |
디테일 패널에 Collision 항목이 없음 | 컴포넌트 패널에서 CapsuleComponent가 아니라 액터 전체(맨 위 항목)를 고른 것은 아닌지 |
| 응답 표가 보이지 않음 | Collision Presets 왼쪽의 화살표를 펼쳤는지 |
응답 표의 세로줄은 채널 이름이고, 가로로 Ignore, Overlap, Block 칸이 있어 체크된 칸이 그 채널에 대한 응답입니다. Pawn 프리셋의 표에서는 Visibility 줄만 Ignore이고 나머지 채널은 모두 Block입니다. 이 표를 읽으려면 채널과 프리셋이 무엇인지부터 알아야 합니다.
채널: 물체의 종류와 질문의 종류
충돌 채널(collision channel)은 물체를 종류별로 나눈 이름표입니다. 표의 위쪽에 있는 오브젝트 채널(object channel)은 "이 컴포넌트가 어떤 종류의 물체인가"를 나타내고, 각 컴포넌트는 Object Type으로 그중 하나를 가집니다. 엔진이 기본으로 주는 오브젝트 채널은 다음과 같습니다.
| 채널 | 쓰임 |
|---|---|
WorldStatic | 벽, 바닥, 천장처럼 움직이지 않는 월드 지오메트리 |
WorldDynamic | 문, 엘리베이터처럼 움직이는 월드 물체 |
Pawn | 플레이어 캐릭터나 AI 폰 |
PhysicsBody | 부서지는 상자처럼 물리 시뮬레이션되는 물체 |
Vehicle | 차량 |
Destructible | 디스트럭터블 메시가 기본으로 받는 채널 |
표의 아래쪽에 있는 Visibility와 Camera는 트레이스 채널(trace channel)입니다. 트레이스는 보이지 않는 선을 쏘아 맞은 물체를 찾는 질문인데, 트레이스 채널은 "이 질문에 이 컴포넌트가 어떻게 답하는가"를 정합니다. 캡슐이 Visibility를 Ignore하는 것은 "보이는 물체를 찾는" 선이 캡슐을 그냥 지나간다는 뜻입니다. 트레이스는 이 장의 마지막 글 라인 트레이스 (Trace) 시스템에서 다룹니다.
같은 캐릭터의 Mesh를 선택해 보면 Collision Presets가 CharacterMesh로 되어 있습니다. CharacterMesh는 채널 이름이 아니라 캐릭터 메시용 충돌 프리셋의 이름이고, 이 프리셋의 Object Type도 Pawn입니다.
프리셋: 응답을 한 번에 묶어 두기
충돌 프로파일(collision profile)은 한 컴포넌트가 각 채널에 어떻게 응답할지를 미리 정해 둔 묶음이고, 에디터에서는 충돌 프리셋(Collision Presets)이라고 부릅니다. 같은 종류의 물체에 같은 프리셋을 주면 모두 같은 규칙을 따르고, 규칙을 바꿀 때도 한곳만 고치면 됩니다. 프리셋은 세 가지를 함께 정합니다.
| 항목 | 정하는 것 |
|---|---|
Collision Enabled | 충돌에 어떤 경로로 참여할지. NoCollision은 참여하지 않음, QueryOnly는 트레이스·스윕·오버랩 같은 쿼리에만, PhysicsOnly는 강체 시뮬레이션에만, QueryAndPhysics는 둘 다 |
Object Type | 이 컴포넌트가 속한 오브젝트 채널 |
| 채널별 응답 | 각 채널에 Ignore, Overlap, Block 가운데 무엇으로 응답할지 |
프리셋 목록에서 Custom...을 고르면 회색이던 표가 풀려 응답을 칸마다 직접 고를 수 있습니다. 새 채널이나 새 프리셋은 Edit > Project Settings의 Engine > Collision에서 만듭니다. New Object Channel이나 New Trace Channel로 Bullet 같은 채널을 만들고 기본 응답(Default Response)을 정하거나, Collision Presets의 New로 PlayerWeapon 같은 프리셋을 만들어 위 세 항목을 정합니다. C++에서는 새로 만든 채널을 이름 대신 ECC_GameTraceChannel1 같은 슬롯 값으로 가리킵니다. 프로젝트의 Config/DefaultEngine.ini에서 채널 이름과 Channel=ECC_GameTraceChannel...의 대응을 확인합니다.
트리거 볼륨 만들기
이제 응답을 직접 바꿔 볼 물체를 만듭니다. 플레이어가 상자 모양의 영역에 들어오고 나갈 때 로그를 남기는 액터입니다.
- 에디터 메뉴에서
Tools > New C++ Class...를 열고, 부모 클래스로Actor를 고른 뒤Next를 누릅니다. - 이름에
MyTriggerVolume을 입력하고Create Class를 누릅니다.Source폴더에MyTriggerVolume.h와MyTriggerVolume.cpp가 생깁니다. - 두 파일의 내용을 아래 코드로 바꿉니다.
#pragma once
#include "CoreMinimal.h"
#include "GameFramework/Actor.h"
#include "MyTriggerVolume.generated.h"
class UBoxComponent;
UCLASS()
class MYPROJECT_API AMyTriggerVolume : public AActor
{
GENERATED_BODY()
public:
AMyTriggerVolume();
protected:
virtual void BeginPlay() override;
UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Collision")
TObjectPtr<UBoxComponent> TriggerBox;
UFUNCTION()
void OnOverlapBegin(UPrimitiveComponent* OverlappedComp, AActor* OtherActor, UPrimitiveComponent* OtherComp, int32 OtherBodyIndex, bool bFromSweep, const FHitResult& SweepResult);
UFUNCTION()
void OnOverlapEnd(UPrimitiveComponent* OverlappedComp, AActor* OtherActor, UPrimitiveComponent* OtherComp, int32 OtherBodyIndex);
};헤더에는 박스 컴포넌트 하나와, 겹침이 시작되고 끝날 때 불릴 함수 두 개를 선언했습니다. 두 함수에 붙은 UFUNCTION()은 빼면 안 됩니다. 뒤에서 쓰는 AddDynamic은 리플렉션으로 함수를 찾기 때문에, 리플렉션에 등록되지 않은 함수는 연결할 수 없습니다. 매개변수가 긴 것도 같은 이유입니다. 연결할 이벤트가 정한 형식과 순서를 그대로 따라야 하므로, 이 글에서 쓰지 않는 매개변수도 지우지 않습니다.
#include "MyTriggerVolume.h"
#include "Components/BoxComponent.h"
#include "GameFramework/Pawn.h"
AMyTriggerVolume::AMyTriggerVolume()
{
PrimaryActorTick.bCanEverTick = false;
TriggerBox = CreateDefaultSubobject<UBoxComponent>(TEXT("TriggerBox"));
RootComponent = TriggerBox;
TriggerBox->SetBoxExtent(FVector(100.0f, 100.0f, 100.0f));
TriggerBox->SetCollisionProfileName(TEXT("OverlapAllDynamic"));
TriggerBox->SetGenerateOverlapEvents(true);
}
void AMyTriggerVolume::BeginPlay()
{
Super::BeginPlay();
TriggerBox->OnComponentBeginOverlap.AddDynamic(this, &AMyTriggerVolume::OnOverlapBegin);
TriggerBox->OnComponentEndOverlap.AddDynamic(this, &AMyTriggerVolume::OnOverlapEnd);
}
void AMyTriggerVolume::OnOverlapBegin(UPrimitiveComponent* OverlappedComp, AActor* OtherActor, UPrimitiveComponent* OtherComp, int32 OtherBodyIndex, bool bFromSweep, const FHitResult& SweepResult)
{
if (OtherActor && OtherActor != this && OtherActor->IsA(APawn::StaticClass()))
{
UE_LOG(LogTemp, Warning, TEXT("Pawn entered trigger volume!"));
}
}
void AMyTriggerVolume::OnOverlapEnd(UPrimitiveComponent* OverlappedComp, AActor* OtherActor, UPrimitiveComponent* OtherComp, int32 OtherBodyIndex)
{
if (OtherActor && OtherActor != this && OtherActor->IsA(APawn::StaticClass()))
{
UE_LOG(LogTemp, Warning, TEXT("Pawn exited trigger volume!"));
}
}생성자는 박스를 루트로 만들고 세 가지를 정합니다. SetBoxExtent는 각 축의 반길이라서, 100을 주면 스케일 1에서 한 변이 200cm인 상자가 됩니다. SetCollisionProfileName(TEXT("OverlapAllDynamic"))은 프로젝트 설정에 정의된 프리셋을 이름으로 적용합니다. OverlapAllDynamic은 Object Type이 WorldDynamic이고 모든 채널에 Overlap으로 응답하는 프리셋입니다. SetGenerateOverlapEvents(true)는 이 컴포넌트가 겹침 이벤트를 만들게 합니다.
BeginPlay에서는 박스의 OnComponentBeginOverlap과 OnComponentEndOverlap에 두 함수를 연결합니다. 이 둘은 델리게이트(delegate)라고 부르는 이벤트 통로로, 함수를 연결해 두면 겹침이 시작되거나 끝날 때 그 함수가 불립니다. 연결 전에 발생한 이벤트는 나중에 연결한 함수로 다시 전달되지 않습니다. 시작 시 겹침이 갱신되는 시점도 있으므로, 초기 겹침의 콜백 여부만으로 실험하지 않습니다. 그래서 시험할 때는 캐릭터가 박스 밖에서 출발해야 합니다. 두 콜백은 겹친 액터가 자기 자신이 아닌 폰(Pawn)일 때만 로그를 남깁니다.
빌드하고 레벨에 놓기
- 에디터를 닫고 Visual Studio에서
Development Editor구성으로 프로젝트를 빌드한 뒤 에디터를 다시 엽니다. - 콘텐츠 브라우저의
C++ Classes폴더에서MyTriggerVolume을 오른쪽 클릭하고Create Blueprint class based on MyTriggerVolume을 골라BP_MyTriggerVolume을 만듭니다. BP_MyTriggerVolume을 레벨로 끌어다 놓습니다. 캐릭터의 시작 위치에서 몇 미터 앞, 바닥 위에 상자 아랫면이 걸치도록 놓습니다.- Play를 누르고 캐릭터를 상자 안으로 걸어 들어갔다가 나옵니다.
여기까지 하면 캐릭터는 상자를 막힘 없이 지나가고, Output Log에 다음 두 줄이 차례로 찍힙니다.
LogTemp: Warning: Pawn entered trigger volume!
LogTemp: Warning: Pawn exited trigger volume!| 다를 때 | 먼저 볼 곳 |
|---|---|
| 빌드 오류 | 헤더의 MYPROJECT_API가 내 프로젝트의 매크로와 같은지, .cpp에 Components/BoxComponent.h를 포함했는지 |
| 레벨에서 상자가 보이지 않음 | 플레이 중에는 박스가 그려지지 않습니다. 에디터 뷰포트에서 선택했을 때 선으로 된 상자가 보이는지 |
| 로그가 한 줄도 없음 | Output Log 창을 열었는지, 캐릭터가 박스 밖에서 출발했는지, 박스가 캐릭터 높이와 겹치는지 |
| 플레이를 시작하자마자 entered가 찍힘 | 박스가 다른 폰과 처음부터 겹쳐 있지 않은지 |
응답 하나만 바꿔 결과 예상하기
이제 박스의 Pawn 채널 응답 하나만 바꿔 가며 결과를 비교합니다. 레벨에 놓인 BP_MyTriggerVolume을 선택하고, 디테일 패널에서 TriggerBox 컴포넌트를 고른 뒤 Collision Presets를 Custom...으로 바꿉니다. 표가 풀리면 Pawn 줄만 아래 세 값으로 바꿔 보고, 나머지 줄은 Overlap 그대로 둡니다. 캐릭터 캡슐은 앞에서 본 대로 Pawn 프리셋이라 WorldDynamic에 Block으로 응답합니다.
바꾸기 전에 세 경우마다 캐릭터가 상자를 지나가는지, 로그가 찍히는지를 먼저 예상해 보세요.
박스의 Pawn 응답 | 캡슐의 WorldDynamic 응답 | 지나가는가 | 로그 |
|---|---|---|---|
Overlap | Block | ? | ? |
Ignore | Block | ? | ? |
Block | Block | ? | ? |
결과 확인하기
박스의 Pawn 응답 | 캡슐의 WorldDynamic 응답 | 지나가는가 | 로그 |
|---|---|---|---|
Overlap | Block | 지나감 | entered, exited |
Ignore | Block | 지나감 | 없음 |
Block | Block | 상자 앞에서 막힘 | 없음 |
두 응답 가운데 약한 쪽이 결과를 정합니다. 한쪽이라도 Ignore이면 이 쌍은 서로 없는 것처럼 지나가고, 한쪽이 Overlap이면 다른 쪽이 Block이어도 겹침이 됩니다. 양쪽이 모두 Block일 때만 막힙니다. 세 번째 경우는 이 걷기 실험에서 상자 앞에 막히는 결과를 예상한 것입니다. Block이 오버랩 이벤트를 항상 금지한다는 뜻은 아니며, 고속 이동 등에서는 막힘과 겹침 알림이 함께 생길 수도 있습니다. 실험이 끝나면 Collision Presets를 다시 OverlapAllDynamic으로 돌려 둡니다.
실험에서 본 규칙을 그림으로 정리하면 다음과 같습니다.
UNREAL C++ · CH5-1
충돌 응답과 이벤트 알림의 조건을 함께 확인합니다
두 컴포넌트가 서로의 Object Type에 어떻게 응답하는지 먼저 봅니다. 응답 조합과 Overlap·Hit 콜백을 받기 위한 조건은 별도입니다.
응답 조합은 세 대안 중 하나입니다. 표의 활성 경로와 이벤트 수신 조건을 함께 확인하며, Overlap→Block으로 다음 단계가 진행한다는 연결은 없습니다.
| 상호 응답 | 결과 | 이벤트를 위한 추가 조건 |
|---|---|---|
| 한쪽이라도 Ignore | 이 쌍의 상호작용 무시 | Overlap·Hit 콜백 대상으로 삼지 않음 |
| Overlap + Overlap 또는 Block | 겹침으로 처리 | 쿼리 활성화와 양쪽 GenerateOverlapEvents, 올바른 콜백 연결 |
| Block + Block | 막힘으로 처리 | 실제 스윕 이동 또는 물리 접촉이 필요. 물리 시뮬레이션 Hit 알림은 보고할 컴포넌트의 설정도 필요 |
- 한쪽이라도 Ignore
- 결과: 이 쌍의 상호작용 무시이벤트를 위한 추가 조건: Overlap·Hit 콜백 대상으로 삼지 않음
- Overlap + Overlap 또는 Block
- 결과: 겹침으로 처리이벤트를 위한 추가 조건: 쿼리 활성화와 양쪽 GenerateOverlapEvents, 올바른 콜백 연결
- Block + Block
- 결과: 막힘으로 처리이벤트를 위한 추가 조건: 실제 스윕 이동 또는 물리 접촉이 필요. 물리 시뮬레이션 Hit 알림은 보고할 컴포넌트의 설정도 필요
기본 응답 조합을 비교한 표입니다. 프리셋 이름만 보지 말고 런타임의 쿼리·물리 참여와 두 컴포넌트의 실제 설정을 확인합니다. 구독 전 사건을 콜백이 다시 통지하지는 않습니다.
컴포넌트 A는 B의 Object Type에, B는 A의 Object Type에 각자 응답을 가지고 있고, 두 응답을 조합해 무시, 겹침, 막힘 가운데 하나가 됩니다. 세 결과는 응답에 따라 갈리는 대안이지, 겹침 다음에 막힘으로 넘어가는 순서가 아닙니다. 그림의 표는 결과마다 이벤트를 받으려면 더 필요한 것을 적어 두었습니다. 겹침 이벤트에는 쿼리 참여, 양쪽의 GenerateOverlapEvents, 콜백 연결이 모두 필요하고, 막힘에서 오는 Hit 이벤트는 실제 이동이나 물리 접촉이 있어야 생깁니다.
표의 둘째 줄에서 "양쪽"이라는 말이 중요합니다. 박스만이 아니라 캐릭터 캡슐도 Generate Overlap Events가 켜져 있어야 로그가 찍힙니다. BP_ThirdPersonCharacter의 CapsuleComponent에서 Generate Overlap Events의 체크를 끄고 다시 들어가 보면, 응답은 그대로 Overlap인데 로그가 사라집니다. 응답은 "어떻게 만나는가"를, 이벤트 설정은 "만난 사실을 알릴 것인가"를 정하는 별개의 설정입니다. 확인했으면 체크를 다시 켭니다.
C++에서 응답을 정하는 함수
블루프린트에서 바꾼 값들은 C++에서도 같은 이름의 함수로 정합니다. 트리거 생성자에서 쓴 SetCollisionProfileName이 프리셋 전체를 적용하는 가장 흔한 방법이고, 프리셋 없이 값을 하나씩 정할 때는 다음 함수를 씁니다.
TriggerBox->SetCollisionEnabled(ECollisionEnabled::QueryOnly);
TriggerBox->SetCollisionObjectType(ECC_WorldDynamic);
TriggerBox->SetCollisionResponseToAllChannels(ECR_Overlap);
TriggerBox->SetCollisionResponseToChannel(ECC_Pawn, ECR_Ignore);순서대로 쿼리에만 참여하게 하고, 자기 채널을 WorldDynamic으로 두고, 모든 채널에 Overlap으로 응답하게 한 뒤 Pawn 채널만 Ignore로 바꿉니다. 앞 실험의 둘째 줄과 같은 설정입니다. 프리셋을 적용한 뒤 일부만 이렇게 고치면 그 컴포넌트는 사실상 Custom 설정이 되므로, 같은 규칙을 여러 물체에 쓴다면 프로젝트 설정에 프리셋을 따로 만드는 편이 관리하기 쉽습니다.
정리
- 충돌은 컴포넌트 사이에서 판정되고, 응답은 막는
Block, 겹침만 알리는Overlap, 반응하지 않는Ignore의 세 가지입니다. - 오브젝트 채널은 물체의 종류를, 트레이스 채널은 트레이스라는 질문의 종류를 나타냅니다. 새 채널은
Project Settings의Engine > Collision에서 만듭니다. - 충돌 프리셋은
Collision Enabled,Object Type, 채널별 응답을 묶은 것이며, C++에서는SetCollisionProfileName()으로, 에디터에서는Collision Presets로 적용합니다. - 두 응답 가운데 하나라도
Ignore면 무시, 하나라도Overlap이면 겹침, 둘 다Block일 때만 막힘입니다. - 겹침 이벤트를 받으려면 응답과 별개로 양쪽의
Generate Overlap Events와UFUNCTION()함수의AddDynamic연결이 필요하고, 연결 전에 발생한 이벤트는 다시 전달되지 않습니다.
연습 문제
1. 응답 조합 계산하기
컴포넌트 A는 B의 채널에 Block, B는 A의 채널에 Ignore로 응답합니다. 둘이 만나면 어떻게 될까요? B의 응답을 Overlap으로 바꾸면 어떻게 될까요?
해설 보기
처음 설정에서는 B가 Ignore이므로 이 쌍은 무시되어 서로 통과하고, 아무 이벤트도 생기지 않습니다. A가 Block인 것은 결과를 바꾸지 못합니다.
B를 Overlap으로 바꾸면 한쪽이 Overlap이므로 겹침이 됩니다. 이때도 A는 막히지 않습니다. 막히게 하려면 양쪽이 모두 Block이어야 하고, 겹침 이벤트를 받으려면 양쪽의 Generate Overlap Events와 콜백 연결도 맞아야 합니다.
2. 메시만 고쳤을 때
트리거가 반응하지 않아 BP_ThirdPersonCharacter의 Mesh에서 Generate Overlap Events를 켜고 응답을 Overlap으로 바꿨습니다. 그런데 꺼져 있던 것은 CapsuleComponent의 Generate Overlap Events였습니다. 이 수정으로 원래 문제가 풀렸다고 볼 수 있을까요?
해설 보기
볼 수 없습니다. 메시와 캡슐은 서로 다른 컴포넌트이고 충돌은 컴포넌트마다 따로 판정됩니다. 메시를 고친 뒤에 로그가 찍히더라도 그것은 메시가 박스와 겹쳐서 생긴 이벤트이고, 캡슐은 여전히 이벤트를 만들지 않습니다.
고쳐야 할 곳은 캡슐의 Generate Overlap Events입니다. 메시의 설정은 원래대로 돌려 둡니다. 메시까지 이벤트를 만들면 한 번 들어갈 때 로그가 두 번 찍힐 수 있는데, 이 문제는 다음 글에서 직접 다룹니다.
3. 연결이 되지 않는 콜백 고치기
다음 헤더는 함수의 매개변수 형식이 맞아 컴파일되어도, 실행 중 AddDynamic으로 콜백을 연결하지 못합니다. 원인을 찾아 고쳐 보세요.
protected:
virtual void BeginPlay() override;
UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Collision")
TObjectPtr<UBoxComponent> TriggerBox;
void OnOverlapBegin(UPrimitiveComponent* OverlappedComp, AActor* OtherActor, UPrimitiveComponent* OtherComp, int32 OtherBodyIndex, bool bFromSweep, const FHitResult& SweepResult);해설 보기
OnOverlapBegin 위에 UFUNCTION()이 없습니다. OnComponentBeginOverlap은 동적 델리게이트라서 함수를 이름으로 찾아 연결하는데, 그러려면 함수가 리플렉션에 등록되어 있어야 합니다. 선언 바로 위에 UFUNCTION() 한 줄을 넣고 다시 빌드합니다.
UFUNCTION()
void OnOverlapBegin(UPrimitiveComponent* OverlappedComp, AActor* OtherActor, UPrimitiveComponent* OtherComp, int32 OtherBodyIndex, bool bFromSweep, const FHitResult& SweepResult);이와 달리 매개변수의 개수나 형식이 다르면 AddDynamic의 타입 검사에서 컴파일 오류가 납니다. 리플렉션 등록 누락과 함수 형식 불일치를 구별해서 확인합니다.
4. 무엇이 겹쳤는지 이름 찍기
다음 글에서는 "캐릭터의 어느 부품이 겹쳤는가"가 중요해집니다. 그 준비로 OnOverlapBegin과 OnOverlapEnd의 로그에 겹친 액터의 이름과 겹친 컴포넌트의 이름을 함께 찍어 보세요.
- 진입 로그는
Entered: 액터 이름 / 컴포넌트 이름형식입니다. - 이탈 로그는
Exited: 액터 이름 / 컴포넌트 이름형식입니다. - Play에서 박스를 한 번 지나가면 두 줄이 찍힙니다.
힌트: 겹친 상대 컴포넌트는 매개변수 OtherComp에 들어옵니다. GetName()이 돌려주는 FString은 앞에 *를 붙여 %s에 넘깁니다.
해설 보기
두 콜백의 UE_LOG 줄만 바꿉니다.
void AMyTriggerVolume::OnOverlapBegin(UPrimitiveComponent* OverlappedComp, AActor* OtherActor, UPrimitiveComponent* OtherComp, int32 OtherBodyIndex, bool bFromSweep, const FHitResult& SweepResult)
{
if (OtherActor && OtherActor != this && OtherActor->IsA(APawn::StaticClass()))
{
UE_LOG(LogTemp, Warning, TEXT("Entered: %s / %s"), *OtherActor->GetName(), *OtherComp->GetName());
}
}
void AMyTriggerVolume::OnOverlapEnd(UPrimitiveComponent* OverlappedComp, AActor* OtherActor, UPrimitiveComponent* OtherComp, int32 OtherBodyIndex)
{
if (OtherActor && OtherActor != this && OtherActor->IsA(APawn::StaticClass()))
{
UE_LOG(LogTemp, Warning, TEXT("Exited: %s / %s"), *OtherActor->GetName(), *OtherComp->GetName());
}
}빌드하고 박스를 지나가면 Entered: BP_ThirdPersonCharacter_C_0 / CollisionCylinder처럼 찍힙니다. 액터 이름 끝의 번호는 실행마다 다를 수 있습니다. 컴포넌트 이름이 블루프린트에서 본 CapsuleComponent가 아니라 CollisionCylinder인 것은, GetName()이 C++에서 컴포넌트를 만들 때 준 객체 이름을 돌려주기 때문입니다. 블루프린트 에디터에 보이는 CapsuleComponent는 그 컴포넌트를 가리키는 변수의 이름입니다.
충돌 응답의 조합 규칙과 채널, 프리셋 설정은 Epic의 Collision Overview 문서와 Collision Response Reference에서 확인할 수 있습니다.
다음 글 트리거 박스와 오버랩 이벤트에서는 이 트리거를 문 앞의 안내 영역으로 키워, 캐릭터의 여러 부품이 겹칠 때도 안내가 제때 켜지고 꺼지게 만듭니다.