atriggervolume

ATriggerVolume

🎯 Unreal Engine - ATriggerVolume


🏷 定义

  • ATriggerVolume继承自 AVolume 的特殊体积类
  • 用于在场景中检测 Actor 进入 / 停留 / 离开 某个区域。
  • 常用于触发事件(如开门、播放音效、切换关卡)。

🧩 类继承关系

UObject

└── AActor

  └── AVolume

       └── ATriggerVolume

  • AVolume:带有体积边界(Brush)的 Actor。
  • ATriggerVolume:在 Volume 的基础上,专门用于触发逻辑。

⚙️ 关键特性

  • 不可见:游戏运行时默认不可见,不会渲染。
  • 碰撞检测:只检测重叠事件(Overlap),不产生物理阻挡。
  • 事件绑定:可在蓝图或 C++ 中响应以下事件:
    • OnActorBeginOverlap
    • OnActorEndOverlap
    • OnActorHit(如果设置了碰撞响应)

📝 使用场景

  • 🚪 开门:玩家进入触发区 → 门自动打开。
  • 🎶 音效/音乐:进入区域播放环境音。
  • 💡 光效/特效:进入某区域触发粒子或灯光。
  • 📌 关卡逻辑:进入触发区后切换关卡、更新任务状态。

🛠️ 示例代码

关键函数

  • OnActorBeginOverlap(AActor* OverlappedActor, AActor* OtherActor)