游戏客户端架构 / 系统课时
实现触发区域
实现触发区域
触发区域复用碰撞检测,却不执行位置或速度修正。本课将用跨帧集合记录重叠关系,准确区分进入、停留和离开事件,为传送门、拾取物和任务区域提供统一机制。
学习目标
- 区分普通碰撞体与触发区域的处理职责
- 使用上一帧和当前帧重叠集合生成三类事件
- 实现可运行的二维 AABB 触发器示例
触发区域的本质
普通碰撞体用于阻挡和推动物体,触发区域只关心“谁与我重叠”。两者可以共享包围盒检测,但触发器命中后必须跳过位置修正、速度冲量和摩擦计算。
常见用途包括进入房间后加载内容、角色停留在毒区时持续扣血,以及离开交互范围时隐藏提示。触发事件描述的是关系变化,不是单次检测结果。
用跨帧状态生成事件
只检查当前帧是否重叠,无法判断这是首次进入还是持续停留。系统需要同时保存上一帧集合与当前帧集合,并按下面的关系产生事件。

- 上一帧未重叠、当前帧重叠:
TriggerEnter - 上一帧重叠、当前帧仍重叠:
TriggerStay - 上一帧重叠、当前帧未重叠:
TriggerExit
两个集合都不包含对象时不产生事件。事件判断完成后,再用当前集合替换上一帧集合,供下一帧比较。
完整示例:跟踪一个角色穿过区域
下面的 C++ 程序模拟实体 42 连续四帧移动。触发器会扫描当前重叠对象,并与上一帧记录比较后输出事件。
cpp
#include <cmath>
#include <iostream>
#include <unordered_set>
#include <utility>
#include <vector>
struct Vec2 {
float x;
float y;
};
struct Aabb {
int entityId;
Vec2 center;
Vec2 halfSize;
bool isTrigger;
};
bool overlaps(const Aabb& a, const Aabb& b) {
const bool overlapX =
std::abs(a.center.x - b.center.x) <= a.halfSize.x + b.halfSize.x;
const bool overlapY =
std::abs(a.center.y - b.center.y) <= a.halfSize.y + b.halfSize.y;
return overlapX && overlapY;
}
class TriggerTracker {
public:
void update(const Aabb& trigger, const std::vector<Aabb>& actors) {
if (!trigger.isTrigger) {
return;
}
std::unordered_set<int> current;
for (const Aabb& actor : actors) {
if (!overlaps(trigger, actor)) {
continue;
}
current.insert(actor.entityId);
if (previous_.contains(actor.entityId)) {
std::cout << "TriggerStay entity=" << actor.entityId << '\n';
} else {
std::cout << "TriggerEnter entity=" << actor.entityId << '\n';
}
}
// 上一帧存在但当前帧消失的对象,应触发离开事件
for (int entityId : previous_) {
if (!current.contains(entityId)) {
std::cout << "TriggerExit entity=" << entityId << '\n';
}
}
previous_ = std::move(current);
}
private:
std::unordered_set<int> previous_;
};
int main() {
const Aabb trigger{100, {0.0f, 0.0f}, {1.0f, 1.0f}, true};
const std::vector<float> positions{-2.0f, -0.5f, 0.2f, 2.0f};
TriggerTracker tracker;
for (std::size_t frame = 0; frame < positions.size(); ++frame) {
std::cout << "Frame " << frame + 1 << '\n';
const Aabb player{
42,
{positions[frame], 0.0f},
{0.4f, 0.4f},
false
};
tracker.update(trigger, {player});
}
}预期输出:
text
Frame 1
Frame 2
TriggerEnter entity=42
Frame 3
TriggerStay entity=42
Frame 4
TriggerExit entity=42第一帧角色位于区域外,所以没有事件;第二帧首次重叠,第三帧继续重叠,第四帧离开。该示例使用了 C++20 的 unordered_set::contains,编译时需要启用 C++20 标准。
接入引擎时的关键边界
触发检测应在对象位置更新后执行,否则事件会滞后一帧。事件最好先写入队列,待本轮检测结束后统一分发,避免回调中删除实体或修改碰撞体集合导致迭代失效。
实体被销毁、场景切换或触发器被禁用时,也要清理上一帧记录。若业务要求补发离开事件,应在清理前遍历集合;若场景整体卸载,则通常直接丢弃状态即可。
高速物体可能一帧跨过很窄的触发区而从未产生重叠。此时需要连续碰撞检测、线段扫描或扩大检测范围,不能仅依赖离散帧中的 AABB 重叠。
本课总结
- 触发器复用碰撞检测,但不执行任何物理阻挡或冲量响应
- 进入、停留和离开事件来自上一帧集合与当前帧集合的差异
- 延迟分发事件并正确清理状态,可以避免迭代失效和幽灵事件
下一课预告
下一课将继续扩展基础物理系统,讨论如何组织多个碰撞体的检测顺序,并为更复杂的接触关系准备统一的数据结构。
按自己的节奏,确认真正理解。