第 10 天：UE5 交互系统，拾取物品 & 触发机关！

🎯 目标：

✅ 理解 UE5 交互系统（Interaction System）

✅ 使用 C++ 让玩家拾取物品

✅ 创建交互触发器（Trigger）激活机关

✅ 使用射线检测（Raycast）触发交互

1️⃣ UE5 交互系统概述

在 Unreal Engine 5 中，交互系统允许玩家 拾取物品、开门、触发机关、启动事件 等。常见的交互方式包括：

方式	描述	适用场景
Overlap（重叠检测）	进入某个区域时自动触发	触发机关、进入房间
Raycast（射线检测）	通过鼠标/键盘瞄准并触发	拾取物品、开门、射击
按键交互（Key Press）	按 E 或 F 触发	NPC 对话、拾取物品

今天，我们将实现 拾取物品 和 触发机关，并使用 E 键进行交互！🚀

2️⃣ 创建可拾取物品（PickupItem）

🔹 新建 PickupItem 类

1. 在 UE5 ，点击 "工具" → "新建 C++ 类"
2. 选择 Actor 作为基类，命名为 PickupItem
3. 点击"创建并添加到项目"，等待 UE5 生成代码

🔹 修改 PickupItem.h

📌 添加 StaticMeshComponent 作为物品的模型，并设置重叠检测

#pragma once

#include "CoreMinimal.h"
#include "GameFramework/Actor.h"
#include "Components/StaticMeshComponent.h"
#include "PickupItem.generated.h"

UCLASS()
class MYGAME_API APickupItem : public AActor
{
    GENERATED_BODY()

public:
    APickupItem();

protected:
    virtual void BeginPlay() override;

private:
    UPROPERTY(VisibleAnywhere)
    UStaticMeshComponent* MeshComponent;

    UFUNCTION()
    void OnOverlap(AActor* OverlappedActor, AActor* OtherActor);
};

🔹 修改 PickupItem.cpp

📌 初始化 MeshComponent，并绑定 Overlap 事件

#include "PickupItem.h"
#include "GameFramework/Actor.h"

APickupItem::APickupItem()
{
    PrimaryActorTick.bCanEverTick = true;

    // 创建 StaticMesh 组件
    MeshComponent = CreateDefaultSubobject<UStaticMeshComponent>(TEXT("MeshComponent"));
    RootComponent = MeshComponent;

	static ConstructorHelpers::FObjectFinder<UStaticMesh> MeshAsset(TEXT("/Engine/BasicShapes/Cube.Cube"));
	if (MeshAsset.Succeeded()) {
		MeshComponent->SetStaticMesh(MeshAsset.Object);
	}

    // 设置为可触发重叠事件
    MeshComponent->SetCollisionProfileName(TEXT("OverlapAllDynamic"));
    OnActorBeginOverlap.AddDynamic(this, &APickupItem::OnOverlap);
}

void APickupItem::BeginPlay()
{
    Super::BeginPlay();
}

void APickupItem::OnOverlap(AActor* OverlappedActor, AActor* OtherActor)
{
    if (OtherActor && OtherActor != this)
    {
        UE_LOG(LogTemp, Warning, TEXT("%s 被 %s 拾取！"), *GetName(), *OtherActor->GetName());

        // 销毁物品（模拟拾取）
        Destroy();
    }
}

✅ 现在，玩家走近 PickupItem，物品会消失并打印拾取信息！

3️⃣ 使用射线检测（Raycast）拾取物品

有时候，我们希望 玩家按 E 键瞄准并拾取物品，可以使用 射线检测（Raycast） 来实现。

📌 修改 PlayerCharacter.h

void Interact();

📌 修改 PlayerCharacter.cpp

void APlayerCharacter::SetupPlayerInputComponent(UInputComponent* PlayerInputComponent)
{
    Super::SetupPlayerInputComponent(PlayerInputComponent);

    PlayerInputComponent->BindAction("Interact", IE_Pressed, this, &APlayerCharacter::Interact);
}

void APlayerCharacter::Interact()
{
    FVector Start = FirstPersonCamera->GetComponentLocation();
    FVector End = Start + (FirstPersonCamera->GetForwardVector() * 500.0f);

    FHitResult HitResult;
    FCollisionQueryParams CollisionParams;

    if (GetWorld()->LineTraceSingleByChannel(HitResult, Start, End, ECC_Visibility, CollisionParams))
    {
        if (HitResult.GetActor())
        {
            UE_LOG(LogTemp, Warning, TEXT("拾取物品: %s"), *HitResult.GetActor()->GetName());

            // 销毁物品
            HitResult.GetActor()->Destroy();
        }
    }
}

📌 修改 PickupItem.cpp

MeshComponent->SetCollisionProfileName(TEXT("BlockAllDynamic"));

✅ 现在，按 E 键可以瞄准并拾取物品！

4️⃣ 创建触发机关（Trigger Mechanism）

我们将创建一个 TriggerSwitch，当玩家靠近时 打开机关（比如门）。

🔹 新建 TriggerSwitch 类

1. 在 UE5 ，点击 "工具" → "新建 C++ 类"
2. 选择 Actor 作为基类 ，命名为 TriggerSwitch
3. 点击"创建并添加到项目" ，等待 UE5 生成代码

🔹 修改 TriggerSwitch.h

📌 添加 BoxComponent 作为触发区域

#pragma once

#include "CoreMinimal.h"
#include "GameFramework/Actor.h"
#include "Components/BoxComponent.h"
#include "TriggerSwitch.generated.h"

UCLASS()
class MYGAME_API ATriggerSwitch : public AActor
{
    GENERATED_BODY()

public:
    ATriggerSwitch();

protected:
    virtual void BeginPlay() override;

private:
    UPROPERTY(VisibleAnywhere)
    UBoxComponent* TriggerBox;

    UFUNCTION()
    void OnOverlap(UPrimitiveComponent* OverlappedComponent, AActor* OtherActor,UPrimitiveComponent* OtherComp, int32 OtherBodyIndex,bool bFromSweep, const FHitResult& SweepResult);
};

🔹 修改 TriggerSwitch.cpp

📌 初始化触发器，并在玩家进入时触发事件

#include "TriggerSwitch.h"
#include "GameFramework/Actor.h"

ATriggerSwitch::ATriggerSwitch()
{
    PrimaryActorTick.bCanEverTick = true;

    // 创建 BoxComponent 作为触发区域
    TriggerBox = CreateDefaultSubobject<UBoxComponent>(TEXT("TriggerBox"));
    RootComponent = TriggerBox;
    TriggerBox->SetCollisionProfileName(TEXT("Trigger"));

    // 绑定重叠事件
    TriggerBox->OnComponentBeginOverlap.AddDynamic(this, &ATriggerSwitch::OnOverlap);
}

void ATriggerSwitch::BeginPlay()
{
    Super::BeginPlay();
}

void ATriggerSwitch::OnOverlap(UPrimitiveComponent* OverlappedComponent, AActor* OtherActor,UPrimitiveComponent* OtherComp, int32 OtherBodyIndex,bool bFromSweep, const FHitResult& SweepResult)
{
    if (OtherActor)
    {
        UE_LOG(LogTemp, Warning, TEXT("触发机关: %s"), *OtherActor->GetName());
    }
}

✅ 当玩家进入 TriggerBox 区域，控制台会打印触发信息！

5️⃣ 常见问题 & 解决方案

问题	解决方案
物品不消失	确保 Destroy() 被调用
E 键无效	确保 Interact() 正确绑定到 SetupPlayerInputComponent
触发器没反应	BoxComponent 需设置 Trigger 碰撞模式

🎯 总结

✅ 实现 Overlap 事件，让物品可拾取

✅ 使用 E 键 + 射线检测拾取物品

✅ 创建 TriggerSwitch 触发机关

✅ 使用 BoxComponent 检测玩家进入区域

🎮 明天我们将学习 AI 交互系统，创建一个智能 NPC！ 🚀