游戏客户端架构 / 系统课时

实现触发区域

实现触发区域

触发区域复用碰撞检测,却不执行位置或速度修正。本课将用跨帧集合记录重叠关系,准确区分进入、停留和离开事件,为传送门、拾取物和任务区域提供统一机制。

学习目标

  • 区分普通碰撞体与触发区域的处理职责
  • 使用上一帧和当前帧重叠集合生成三类事件
  • 实现可运行的二维 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 重叠。

本课总结

  • 触发器复用碰撞检测,但不执行任何物理阻挡或冲量响应
  • 进入、停留和离开事件来自上一帧集合与当前帧集合的差异
  • 延迟分发事件并正确清理状态,可以避免迭代失效和幽灵事件

下一课预告

下一课将继续扩展基础物理系统,讨论如何组织多个碰撞体的检测顺序,并为更复杂的接触关系准备统一的数据结构。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

实现触发区域

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通