SuperAPI AI 工具集

ue-physics-collision

通用与其它

查看项目

更新于 10-16 04:56

技能介绍

用途:在虚幻引擎项目中处理碰撞与物理,包括碰撞通道与配置文件设置、线性/扫描/重叠查询、命中与重叠事件绑定以及刚体模拟。目标引擎为 UE 5.8,相关 API 已对照 5.8 头文件。

主要能力:

  1. 碰撞通道与配置文件:ECollisionChannel 共 64 个(8 个引擎通道、6 个隐藏槽、50 个项目槽)。对象通道表示组件“是什么”,用 SetCollisionObjectType 设置;追踪通道供 *ByChannel 查询使用。响应为 ECR_Ignore/ECR_Overlap/ECR_Block。可调用 SetCollisionProfileName 一次性设置,注意它会覆盖手动响应,应先设配置文件再逐通道覆盖。自定义通道与配置文件只能通过配置(DefaultEngine.ini)创建,无运行时 API。
  2. 查询:UWorld 的 const 成员,分 ByChannel、ByObjectType、ByProfile 三族,各有 Test/Single/Multi 形式;扫描需传旋转与 FCollisionShape(Sphere/Box/Capsule);重叠返回 FOverlapResult。异步追踪本帧入队、下帧可读。
  3. FHitResult:提供 bBlockingHit、Time、Location、ImpactPoint、Normal、ImpactNormal、BoneName、PhysMaterial 等,Actor 需通过 GetActor() 访问。Multi 查询中仅最后一个元素可能是阻塞命中。
  4. 碰撞事件:委托为稀疏动态多播,处理函数必须在头文件用 UFUNCTION() 声明且参数完全匹配,否则 AddDynamic 绑定失败。重叠需至少一方 ECR_Overlap、非 Ignore 组合且双方 SetGenerateOverlapEvents(true);模拟命中需双方 ECR_Block、QueryAndPhysics 或 PhysicsOnly,并在模拟组件上 SetNotifyRigidBodyCollision(true)。
  5. 刚体与力:SetSimulatePhysics、SetEnableGravity、SetMassOverrideInKg、线/角阻尼、SetUseCCD、约束模式、AddImpulse 等。

使用方式:多数游戏代码在 Build.cs 中只需 Engine 与 PhysicsCore。可先阅读 .agents/ue-project-context.md 获取模块与约定(缺失可跳过)。

适用场景:射线检测、近战扫描、交互、地面检测、AoE、视线检查、异步传感器、触发器、刚体受力与角色布娃娃等。

限制:自定义通道与配置文件无法运行时创建;bGenerateOverlapEvents 为私有;bReturnFaceIndex 开销较大。其余细节(完整配置文件集合、调试清单、模式与性能指南)见其配套文档 collision-channel-setup.md 与 trace-patterns.md。