1. 项目概述为什么Unity.Physics的碰撞查询值得深挖如果你正在用Unity的DOTS技术栈做项目尤其是涉及到大量动态物体、需要实时物理交互的游戏比如RTS、大战场射击、模拟经营那你肯定绕不开Unity.Physics这个包。但不知道你有没有这种感觉官方文档看完了API也调用了射线检测Raycast和形状检测ShapeCast好像也能跑起来但心里就是没底。性能瓶颈在哪为什么有时候检测结果“飘忽不定”面对成千上万的查询请求怎么组织代码才最合理这就是我们今天要拆解的核心。Unity.Physics的碰撞查询远不止是调用几个方法那么简单。它底层是彻头彻尾的ECS实体组件系统和数据导向设计它的高效来自于对CPU缓存和并行计算的极致利用但这也意味着如果你还用面向对象那套思维去理解它必然会处处碰壁。这篇内容就是把我自己从“能用”到“敢用在生产环境”过程中踩过的坑、捋清的脉络以及一些官方文档没写的性能玄学一次性讲清楚。无论你是想优化现有项目的物理性能还是正在架构一个基于DOTS的新项目这里面的细节都能帮你省下大量调试和重构的时间。2. 核心架构与设计哲学数据在哪里计算就在哪里要理解Unity.Physics的碰撞查询必须先忘掉GameObject和MonoBehaviour。在这里一切皆是数据。2.1 ECS视角下的物理世界构成在Unity.Physics的世界里一个可被检测的物体主要由以下几部分数据构成PhysicsCollider这是核心。它不是一个“碰撞器组件”而是一个BlobAssetReferenceCollider。BlobAsset是一种不可变的数据块可以被多个实体安全地共享。一个BoxCollider的几何数据大小、中心就存储在这里。这种设计意味着一千个相同大小的盒子在内存中只存一份Collider数据极大地节省了内存。PhysicsWorld这是物理世界的单例容器你可以把它理解为一个数据库。它内部维护着几个关键数组Bodies所有刚体的数组每个刚体包含其Collider的引用、位置Translation、旋转Rotation以及世界空间的CollisionFilter碰撞过滤层。StaticBodies所有静态刚体的数组。静态刚体通常不会移动因此它们的碰撞体数据可以直接以世界变换后的形式缓存查询效率更高。BroadPhase广义阶段Broad Phase数据结构。这是碰撞查询性能的关键。它通常是一个Bounding Volume Hierarchy (BVH)树用于快速剔除那些明显不会发生碰撞的物体对将需要精细检测的物体对数量降低几个数量级。当你执行一次射线检测时系统并不是傻傻地用射线去和场景中的每一个碰撞体求交。它首先会去查询BroadPhase快速找到那些包围盒AABB与射线相交的物体这个过程非常快。然后只对这些候选物体进行下一步的Narrow Phase狭义阶段即精确的几何相交测试。2.2 碰撞查询的两种模式立即Immediate与命令式Commands这是最容易混淆也最影响性能设计的一点。立即查询Immediate Queries比如PhysicsWorld.Raycast。你在主线程或任何一个线程上直接调用它立即同步地执行完整个查询流程BroadPhase - Narrow Phase并返回结果。这很简单直观但它会阻塞当前线程并且无法利用Burst编译器和JobSystem的并行能力。它只适用于每帧查询次数很少比如玩家角色的单次射线拾取的场景。命令式查询Commands这是DOTS物理的精髓。你不再直接调用查询而是创建一个PhysicsWorld.CollisionWorld的RaycastInput、ColliderCastInput或PointDistanceInput结构体然后将这个Input提交给一个ISimulation物理模拟器的ScheduleStepJobs方法所生成的Dependency作业依赖链。具体流程是你创建一个NativeListRaycastInput。在你的System里根据游戏逻辑比如所有子弹的发射点、方向向这个列表填充大量的查询请求。调用var handle Simulation.ScheduleStepJobs(...).Schedule(...)来调度物理模拟作业。这个作业内部会并行地处理你提交的所有查询命令。在后续的System中通过JobHandle.CombineDependencies将你的逻辑作业与物理作业的handle连接确保物理查询完成后你才能安全地读取NativeListRaycastHit中的结果。命令式查询将查询请求的收集主线程与查询的执行子线程并行解耦完美契合ECS的数据导向和并行思想。对于大规模查询比如成百上千颗子弹的碰撞检测性能提升是数量级的。实操心得很多开发者刚开始会习惯性地用立即查询因为写法简单。但一旦你的项目规模上去这就会成为主要的性能热点。我的经验法则是除了玩家角色交互等极少数情况其他所有在System中批量进行的物理检测都应优先考虑命令式查询。这需要你改变思维从“现在就要结果”转变为“我声明需要这些查询等物理系统算好了告诉我”。3. 核心查询类型深度解析与实战代码Unity.Physics提供了几种核心的查询类型每种都有其特定的应用场景和性能特征。3.1 射线检测Raycast最常用的穿透性视线射线检测是从一个点沿一个方向发射一条无限长的线段实际上你通常会指定最大距离检测其路径上第一个或所有碰到的碰撞体。// 立即查询示例不推荐用于批量操作 var rayInput new RaycastInput { Start startPos, End endPos, Filter new CollisionFilter { BelongsTo CollisionFilter.Default.BelongsTo, // 我属于哪个层 CollidesWith CollisionFilter.Default.CollidesWith, // 我能和哪些层碰撞 GroupIndex 0 } }; if (physicsWorld.CastRay(rayInput, out RaycastHit hit)) { // 命中处理hit.Entity 包含命中的实体 var hitPosition hit.Position; var hitNormal hit.SurfaceNormal; }关键参数解析Filter碰撞过滤器。这是控制“谁和谁检测”的核心。BelongsTo是发射射线的物体所在的层掩码CollidesWith是射线希望检测的层。它们进行按位与()操作结果为0则跳过检测。合理分层是优化性能的第一步比如子弹层只检测敌人和场景静态层不检测其他子弹和特效。Hit结构包含Entity命中的实体、Fraction起点到命中点的距离占总长度的比例用于计算Position、SurfaceNormal命中点法线对于反弹计算至关重要。命令式批量射线检测示例// 在System的OnUpdate中 public partial struct BulletRaycastSystem : ISystem { private NativeListRaycastInput _raycastCommands; private NativeListRaycastHit _raycastResults; public void OnCreate(ref SystemState state) { _raycastCommands new NativeListRaycastInput(Allocator.Persistent); _raycastResults new NativeListRaycastHit(Allocator.Persistent); } [BurstCompile] public void OnUpdate(ref SystemState state) { // 1. 清空上一帧的命令和结果 _raycastCommands.Clear(); _raycastResults.Clear(); // 2. 收集本帧所有需要射线检测的请求例如从所有Bullet组件 foreach (var (transform, bullet) in SystemAPI.QueryLocalTransform, BulletComponent()) { _raycastCommands.Add(new RaycastInput { Start transform.Position, End transform.Position bullet.Direction * bullet.MaxDistance, Filter bullet.CollisionFilter }); } // 3. 获取物理世界的CollisionWorld和模拟器 var physicsWorld SystemAPI.GetSingletonPhysicsWorldSingleton(); var simulation SystemAPI.GetSingletonSimulationSingleton(); // 4. 调度物理模拟作业并传入我们的射线命令 // ScheduleStepJobs 会处理模拟如刚体运动和所有排队的查询 var handle simulation.ScheduleStepJobs( ref physicsWorld.PhysicsWorld, state.Dependency, _raycastCommands.AsArray(), _raycastResults.AsArray() ); // 5. 创建一个Job来处理命中结果并依赖于物理作业完成 var processHitsJob new ProcessRaycastHitsJob { Hits _raycastResults.AsDeferredJobArray() }.Schedule(handle); // 依赖于handle // 6. 将处理Job的句柄赋给state.Dependency确保后续System等待它完成 state.Dependency processHitsJob; } } // 处理命中结果的Job [BurstCompile] public partial struct ProcessRaycastHitsJob : IJob { [ReadOnly] public NativeArrayRaycastHit Hits; public void Execute() { for (int i 0; i Hits.Length; i) { var hit Hits[i]; if (hit.Entity ! Entity.Null) { // 处理命中逻辑例如造成伤害 // 注意这里不能直接访问ComponentData因为是在Job中。 // 通常需要将Entity记录到另一个NativeList在后续System中处理。 } } } }3.2 形状投射ShapeCast带体积的扫描检测射线是零宽度的而ShapeCast允许你用一个碰撞体形状如球体、胶囊体、盒子沿着一条线段“扫描”空间检测其扫过体积内是否与其他碰撞体相交。这是实现角色移动碰撞避免、子弹体积碰撞、车辆行驶预测的利器。// 创建一个球体形状的投射 var sphere SphereCollider.Create(float3.zero, 0.5f); // 半径0.5米的球 var shapeInput new ColliderCastInput { Collider (Collider*)sphere.GetUnsafePtr(), // 注意需要获取Collider指针 Start startPose, // 包含起始位置和旋转的RigidTransform End endPose, // 包含结束位置和旋转的RigidTransform Filter filter }; if (physicsWorld.CastCollider(shapeInput, out ColliderCastHit hit)) { // hit.Fraction 是扫描的进度0-1在此时发生碰撞 // hit.Position 和 hit.SurfaceNormal 是碰撞点的信息和法线 }注意事项与性能陷阱形状复用绝对不要在每一帧、每一次查询中都Create一个新的Collider。Collider是BlobAsset创建开销较大。正确的做法是在初始化时OnCreate创建好需要的形状如玩家的胶囊体并将其BlobAssetReference存储在一个Singleton或Component中供所有查询复用。旋转处理ShapeCast的Start和End是RigidTransform包含了旋转。这意味着你的形状在扫描过程中是会旋转的。如果你需要形状保持方向不变只需将Start和End的Rotation设为相同的值。性能消耗ShapeCast的计算成本远高于Raycast。Narrow Phase的几何相交测试要复杂得多。务必通过BroadPhase和精细的CollisionFilter来减少不必要的测试。3.3 最近点查询Closest Point距离检测与近似碰撞这个查询用于寻找空间中某个点到指定碰撞体形状的最近点以及该点的距离和法线。它不要求点与形状相交因此常用于AI感知判断敌人是否进入警戒范围球形最近点查询。引力场效果计算物体受到的非接触力方向。运动预测在真正发生碰撞前提前预警。var pointInput new PointDistanceInput { Position queryPoint, MaxDistance 10.0f, // 只搜索10米范围内的最近点 Filter filter }; if (physicsWorld.CalculateDistance(pointInput, out DistanceHit hit)) { // hit.Distance 是查询点到碰撞体表面的最近距离 // hit.Position 是碰撞体表面上的最近点 // hit.SurfaceNormal 是该点的法线方向从碰撞体内部指向外部 }一个实用技巧用CalculateDistance实现高效的“范围内实体”查找。相比用OverlapSphere重叠球体检测返回所有在球内的实体再逐个计算距离CalculateDistance配合一个合理的MaxDistance可以直接得到最近的一个或几个实体通过遍历所有实体或结合BroadPhase在很多情况下更高效尤其是你只关心最近的那个目标时。4. 性能优化实战从“能用”到“高效”理解了基本操作我们进入实战优化环节。以下是几个直接影响帧率和稳定性的关键点。4.1 碰撞层CollisionFilter的策略设计这是成本最低、收益最高的优化。不要所有物体都在同一层。推荐的分层策略示例层名位掩码碰撞对象CollidesWith典型物体Static1 0Everything (Default)地形、建筑、不可移动的景物Dynamic1 1Static, Dynamic, Player, Enemy可移动的箱子、载具Player1 2Static, Dynamic, Enemy, Pickup玩家角色Enemy1 3Static, Dynamic, Player, PlayerProjectile敌人角色PlayerProjectile1 4Enemy, Static玩家发射的子弹EnemyProjectile1 5Player, Static敌人发射的子弹Pickup1 6Player可拾取物品Trigger1 7Player, Enemy触发器区域设计原则静态层与所有层碰撞因为静态物体是BroadPhase优化的基础且通常不可绕过。动态物体之间选择性碰撞比如箱子Dynamic之间可以碰撞但子弹Projectile之间通常不需要碰撞避免不必要的计算。同阵营物体不碰撞玩家的子弹不检测玩家敌人的子弹不检测敌人。这能砍掉近一半的无用检测。使用GroupIndex进行特殊覆盖CollisionFilter中的GroupIndex可以覆盖BelongsTo和CollidesWith的规则。如果GroupIndex大于0则只有GroupIndex相等的物体会碰撞用于特定机关联动如果小于0则GroupIndex相等的物体永不碰撞用于实现同一物体的多个碰撞体不自我碰撞比如角色的多个胶囊体。4.2 BroadPhase的调优与自定义Unity.Physics默认使用Bounding Volume Hierarchy (BVH)作为BroadPhase。BVH的性能很大程度上取决于包围盒AABB的紧密程度和树的平衡度。问题对于高速运动的物体如果它的AABB更新不及时比如每帧只根据当前位置计算那么在进行查询时由于物体已经移动它的AABB可能无法完全覆盖其运动轨迹导致查询漏检“子弹穿墙”。解决方案PhysicsMotionVelocity组件中的Linear和Angular速度会被物理系统用来预测性扩大物体的AABB称为“扩展AABB”或“Swept AABB”。确保为高速运动的物体正确设置速度分量。激进优化对于超大规模、分布特定的场景如开放世界可以考虑实现自定义的BroadPhase。例如基于网格Grid的空间划分对于均匀分布的大量小物体可能比BVH更高效。但这属于高级话题需要你实现IBroadPhase接口并谨慎评估收益。4.3 查询命令的批处理与Job化这是将性能榨干的关键。永远不要在主线程上循环调用立即查询。使用NativeList/NativeArray收集输入如上文的批量射线检测示例在OnUpdate中使用SystemAPI.Query或IJobEntity来遍历所有需要查询的实体将查询参数写入一个共享的NativeListRaycastInput。利用ScheduleStepJobs的并行处理这是核心。将收集好的命令数组传递给SimulationSingleton.ScheduleStepJobs。物理引擎内部会将这些查询Job化并充分利用多核CPU并行执行。结果处理也需Job化查询结果NativeArrayRaycastHit也应该在Burst编译的Job中处理而不是在主线程循环读取。将命中实体的Entity记录到另一个NativeListEntity中然后在另一个System里用SystemAPI.GetComponent等方式处理伤害、音效等逻辑。一个常见的架构模式PhysicsCommandCollectSystem负责收集本帧所有物理查询命令和修改请求如施加力。PhysicsStepSystem调用ScheduleStepJobs调度物理模拟和查询。PhysicsResponseSystem依赖于物理步进作业在Job中处理查询结果如计算伤害、触发事件并输出一个“事件”列表如NativeListDamageEvent。GameplayResponseSystem在主线程或另一个Job中消费“事件”列表执行实际的游戏逻辑如播放受击动画、更新UI血条。5. 疑难杂症与调试技巧实录即使理解了原理在实际开发中还是会遇到各种诡异问题。下面是我遇到的一些典型坑和解决方法。5.1 “检测不到”或“检测飘忽”的常见原因问题现象可能原因排查与解决射线偶尔穿墙1.高速物体帧间位移过大射线从墙缝穿过。2.Collider未正确附加实体缺少PhysicsCollider或LocalTransform。3.Filter配置错误射线层与目标层不匹配。1. 对高速物体使用ShapeCast胶囊体代替Raycast。2. 在System中查询并Debug.Log关键实体的组件是否存在。3. 使用PhysicsDebugDisplay系统可视化碰撞体和射线。ShapeCast结果异常1.Collider引用错误使用了错误或未初始化的BlobAssetReference。2.起始/结束姿态错误RigidTransform的位置或旋转单位不对如用了度数而非弧度。1. 确保Collider在OnCreate中创建并存储在OnUpdate中复用。2. 检查RigidTransform的值用Debug.DrawLine或Debug.DrawMesh可视化扫描体积。性能突然下降1.查询数量爆炸某一帧产生了远超平时的查询请求。2.BroadPhase失衡大量物体集中在很小区域导致BVH树深度激增。3.触发了GC Alloc在OnUpdate中意外创建了托管对象如new List。1. 使用Profiler的Physics模块查看每帧的Raycast/ShapeCast计数。2. 考虑对密集物体使用不同的碰撞层或简化碰撞体。3. 确保所有Native容器在OnCreate中分配在OnUpdate中只做Clear和Add。5.2 使用PhysicsDebugDisplay进行可视化调试这是Unity.Physics包自带的调试神器但需要手动开启。// 在某个System的OnUpdate中或使用一个调试用的MonoBehaviour if (Input.GetKeyDown(KeyCode.F1)) { // 切换物理调试显示的开关 var debugDisplay SystemAPI.GetSingletonRWPhysicsDebugDisplayData(); debugDisplay.ValueRW.DrawColliders !debugDisplay.ValueRW.DrawColliders; debugDisplay.ValueRW.DrawBroadPhase !debugDisplay.ValueRW.DrawBroadPhase; }开启后你可以在Scene视图中看到所有碰撞体的线框静态体是白色动态体是绿色触发器是蓝色。BroadPhase的BVH包围盒帮助你理解空间划分的效率。查询的射线和形状如果你在代码中绘制了调试图形可以结合查看。5.3 处理复杂碰撞体与复合形状一个实体只能附加一个PhysicsCollider但这个Collider可以是CompoundCollider复合碰撞体即由多个简单几何体BoxSphereCapsuleConvexHull等组合而成。创建复合碰撞体var children new NativeListCompoundCollider.ColliderBlobInstance(Allocator.Temp); children.Add(new CompoundCollider.ColliderBlobInstance { Collider BoxCollider.Create(new float3(-0.5f, 0, 0), quaternion.identity, new float3(1,2,1)), Transform new RigidTransform(quaternion.identity, new float3(0, 1, 0)) }); children.Add(new CompoundCollider.ColliderBlobInstance { Collider SphereCollider.Create(float3.zero, 0.5f), Transform new RigidTransform(quaternion.identity, new float3(0, 2.5f, 0)) }); var compoundCollider CompoundCollider.Create(children); // 将 compoundCollider.BlobAssetReference 赋值给实体的 PhysicsCollider性能影响对复合碰撞体进行查询成本是其所有子碰撞体查询成本之和。物理引擎需要对每一个子形状进行测试。因此对于性能敏感的角色应尽量使用单一的CapsuleCollider或BoxCollider来近似而非高精度的ConvexHull或复杂的CompoundCollider。5.4 与渲染、动画的同步问题在DOTS架构下物理变换LocalTransform和渲染变换LocalToWorld是分离的。通常一个拥有PhysicsCollider的实体也会有一个LocalTransform物理系统会更新这个LocalTransform。渲染系统则通过LocalToWorld来渲染。问题如果你通过动画系统如Unity.Animation驱动骨骼运动并希望碰撞体随之移动比如角色攻击时的武器碰撞体你需要手动将骨骼的世界矩阵同步到代表武器碰撞体的实体的LocalTransform上。这个过程需要在PhysicsStepSystem之前完成否则物理查询使用的将是上一帧的位置。解决方案创建一个System在PhysicsStepSystem之前运行使用IJobEntity遍历所有需要跟随动画的物理实体从动画组件中读取最新的骨骼变换并写入其LocalTransform和PhysicsCollider的变换如果是复合碰撞体可能需要更新其子变换。这确保了物理查询基于的是当前帧最新的视觉位置。最后关于性能没有什么比Unity Profiler的Physics模块更直观的了。密切关注Contacts、Raycasts、ColliderCasts的数量和耗时。如果BroadPhase耗时占比过高说明你的空间划分效率低如果NarrowPhase耗时高说明有太多复杂的形状在进行精细检测需要考虑简化碰撞体或优化过滤层。记住在DOTS物理的世界里性能优化是一场关于数据布局、并行度和算法选择的持续战斗理解其核心设计才能打好这场仗。 Unity.Physics碰撞查询深度解析：从ECS架构到性能优化实战
1. 项目概述为什么Unity.Physics的碰撞查询值得深挖如果你正在用Unity的DOTS技术栈做项目尤其是涉及到大量动态物体、需要实时物理交互的游戏比如RTS、大战场射击、模拟经营那你肯定绕不开Unity.Physics这个包。但不知道你有没有这种感觉官方文档看完了API也调用了射线检测Raycast和形状检测ShapeCast好像也能跑起来但心里就是没底。性能瓶颈在哪为什么有时候检测结果“飘忽不定”面对成千上万的查询请求怎么组织代码才最合理这就是我们今天要拆解的核心。Unity.Physics的碰撞查询远不止是调用几个方法那么简单。它底层是彻头彻尾的ECS实体组件系统和数据导向设计它的高效来自于对CPU缓存和并行计算的极致利用但这也意味着如果你还用面向对象那套思维去理解它必然会处处碰壁。这篇内容就是把我自己从“能用”到“敢用在生产环境”过程中踩过的坑、捋清的脉络以及一些官方文档没写的性能玄学一次性讲清楚。无论你是想优化现有项目的物理性能还是正在架构一个基于DOTS的新项目这里面的细节都能帮你省下大量调试和重构的时间。2. 核心架构与设计哲学数据在哪里计算就在哪里要理解Unity.Physics的碰撞查询必须先忘掉GameObject和MonoBehaviour。在这里一切皆是数据。2.1 ECS视角下的物理世界构成在Unity.Physics的世界里一个可被检测的物体主要由以下几部分数据构成PhysicsCollider这是核心。它不是一个“碰撞器组件”而是一个BlobAssetReferenceCollider。BlobAsset是一种不可变的数据块可以被多个实体安全地共享。一个BoxCollider的几何数据大小、中心就存储在这里。这种设计意味着一千个相同大小的盒子在内存中只存一份Collider数据极大地节省了内存。PhysicsWorld这是物理世界的单例容器你可以把它理解为一个数据库。它内部维护着几个关键数组Bodies所有刚体的数组每个刚体包含其Collider的引用、位置Translation、旋转Rotation以及世界空间的CollisionFilter碰撞过滤层。StaticBodies所有静态刚体的数组。静态刚体通常不会移动因此它们的碰撞体数据可以直接以世界变换后的形式缓存查询效率更高。BroadPhase广义阶段Broad Phase数据结构。这是碰撞查询性能的关键。它通常是一个Bounding Volume Hierarchy (BVH)树用于快速剔除那些明显不会发生碰撞的物体对将需要精细检测的物体对数量降低几个数量级。当你执行一次射线检测时系统并不是傻傻地用射线去和场景中的每一个碰撞体求交。它首先会去查询BroadPhase快速找到那些包围盒AABB与射线相交的物体这个过程非常快。然后只对这些候选物体进行下一步的Narrow Phase狭义阶段即精确的几何相交测试。2.2 碰撞查询的两种模式立即Immediate与命令式Commands这是最容易混淆也最影响性能设计的一点。立即查询Immediate Queries比如PhysicsWorld.Raycast。你在主线程或任何一个线程上直接调用它立即同步地执行完整个查询流程BroadPhase - Narrow Phase并返回结果。这很简单直观但它会阻塞当前线程并且无法利用Burst编译器和JobSystem的并行能力。它只适用于每帧查询次数很少比如玩家角色的单次射线拾取的场景。命令式查询Commands这是DOTS物理的精髓。你不再直接调用查询而是创建一个PhysicsWorld.CollisionWorld的RaycastInput、ColliderCastInput或PointDistanceInput结构体然后将这个Input提交给一个ISimulation物理模拟器的ScheduleStepJobs方法所生成的Dependency作业依赖链。具体流程是你创建一个NativeListRaycastInput。在你的System里根据游戏逻辑比如所有子弹的发射点、方向向这个列表填充大量的查询请求。调用var handle Simulation.ScheduleStepJobs(...).Schedule(...)来调度物理模拟作业。这个作业内部会并行地处理你提交的所有查询命令。在后续的System中通过JobHandle.CombineDependencies将你的逻辑作业与物理作业的handle连接确保物理查询完成后你才能安全地读取NativeListRaycastHit中的结果。命令式查询将查询请求的收集主线程与查询的执行子线程并行解耦完美契合ECS的数据导向和并行思想。对于大规模查询比如成百上千颗子弹的碰撞检测性能提升是数量级的。实操心得很多开发者刚开始会习惯性地用立即查询因为写法简单。但一旦你的项目规模上去这就会成为主要的性能热点。我的经验法则是除了玩家角色交互等极少数情况其他所有在System中批量进行的物理检测都应优先考虑命令式查询。这需要你改变思维从“现在就要结果”转变为“我声明需要这些查询等物理系统算好了告诉我”。3. 核心查询类型深度解析与实战代码Unity.Physics提供了几种核心的查询类型每种都有其特定的应用场景和性能特征。3.1 射线检测Raycast最常用的穿透性视线射线检测是从一个点沿一个方向发射一条无限长的线段实际上你通常会指定最大距离检测其路径上第一个或所有碰到的碰撞体。// 立即查询示例不推荐用于批量操作 var rayInput new RaycastInput { Start startPos, End endPos, Filter new CollisionFilter { BelongsTo CollisionFilter.Default.BelongsTo, // 我属于哪个层 CollidesWith CollisionFilter.Default.CollidesWith, // 我能和哪些层碰撞 GroupIndex 0 } }; if (physicsWorld.CastRay(rayInput, out RaycastHit hit)) { // 命中处理hit.Entity 包含命中的实体 var hitPosition hit.Position; var hitNormal hit.SurfaceNormal; }关键参数解析Filter碰撞过滤器。这是控制“谁和谁检测”的核心。BelongsTo是发射射线的物体所在的层掩码CollidesWith是射线希望检测的层。它们进行按位与()操作结果为0则跳过检测。合理分层是优化性能的第一步比如子弹层只检测敌人和场景静态层不检测其他子弹和特效。Hit结构包含Entity命中的实体、Fraction起点到命中点的距离占总长度的比例用于计算Position、SurfaceNormal命中点法线对于反弹计算至关重要。命令式批量射线检测示例// 在System的OnUpdate中 public partial struct BulletRaycastSystem : ISystem { private NativeListRaycastInput _raycastCommands; private NativeListRaycastHit _raycastResults; public void OnCreate(ref SystemState state) { _raycastCommands new NativeListRaycastInput(Allocator.Persistent); _raycastResults new NativeListRaycastHit(Allocator.Persistent); } [BurstCompile] public void OnUpdate(ref SystemState state) { // 1. 清空上一帧的命令和结果 _raycastCommands.Clear(); _raycastResults.Clear(); // 2. 收集本帧所有需要射线检测的请求例如从所有Bullet组件 foreach (var (transform, bullet) in SystemAPI.QueryLocalTransform, BulletComponent()) { _raycastCommands.Add(new RaycastInput { Start transform.Position, End transform.Position bullet.Direction * bullet.MaxDistance, Filter bullet.CollisionFilter }); } // 3. 获取物理世界的CollisionWorld和模拟器 var physicsWorld SystemAPI.GetSingletonPhysicsWorldSingleton(); var simulation SystemAPI.GetSingletonSimulationSingleton(); // 4. 调度物理模拟作业并传入我们的射线命令 // ScheduleStepJobs 会处理模拟如刚体运动和所有排队的查询 var handle simulation.ScheduleStepJobs( ref physicsWorld.PhysicsWorld, state.Dependency, _raycastCommands.AsArray(), _raycastResults.AsArray() ); // 5. 创建一个Job来处理命中结果并依赖于物理作业完成 var processHitsJob new ProcessRaycastHitsJob { Hits _raycastResults.AsDeferredJobArray() }.Schedule(handle); // 依赖于handle // 6. 将处理Job的句柄赋给state.Dependency确保后续System等待它完成 state.Dependency processHitsJob; } } // 处理命中结果的Job [BurstCompile] public partial struct ProcessRaycastHitsJob : IJob { [ReadOnly] public NativeArrayRaycastHit Hits; public void Execute() { for (int i 0; i Hits.Length; i) { var hit Hits[i]; if (hit.Entity ! Entity.Null) { // 处理命中逻辑例如造成伤害 // 注意这里不能直接访问ComponentData因为是在Job中。 // 通常需要将Entity记录到另一个NativeList在后续System中处理。 } } } }3.2 形状投射ShapeCast带体积的扫描检测射线是零宽度的而ShapeCast允许你用一个碰撞体形状如球体、胶囊体、盒子沿着一条线段“扫描”空间检测其扫过体积内是否与其他碰撞体相交。这是实现角色移动碰撞避免、子弹体积碰撞、车辆行驶预测的利器。// 创建一个球体形状的投射 var sphere SphereCollider.Create(float3.zero, 0.5f); // 半径0.5米的球 var shapeInput new ColliderCastInput { Collider (Collider*)sphere.GetUnsafePtr(), // 注意需要获取Collider指针 Start startPose, // 包含起始位置和旋转的RigidTransform End endPose, // 包含结束位置和旋转的RigidTransform Filter filter }; if (physicsWorld.CastCollider(shapeInput, out ColliderCastHit hit)) { // hit.Fraction 是扫描的进度0-1在此时发生碰撞 // hit.Position 和 hit.SurfaceNormal 是碰撞点的信息和法线 }注意事项与性能陷阱形状复用绝对不要在每一帧、每一次查询中都Create一个新的Collider。Collider是BlobAsset创建开销较大。正确的做法是在初始化时OnCreate创建好需要的形状如玩家的胶囊体并将其BlobAssetReference存储在一个Singleton或Component中供所有查询复用。旋转处理ShapeCast的Start和End是RigidTransform包含了旋转。这意味着你的形状在扫描过程中是会旋转的。如果你需要形状保持方向不变只需将Start和End的Rotation设为相同的值。性能消耗ShapeCast的计算成本远高于Raycast。Narrow Phase的几何相交测试要复杂得多。务必通过BroadPhase和精细的CollisionFilter来减少不必要的测试。3.3 最近点查询Closest Point距离检测与近似碰撞这个查询用于寻找空间中某个点到指定碰撞体形状的最近点以及该点的距离和法线。它不要求点与形状相交因此常用于AI感知判断敌人是否进入警戒范围球形最近点查询。引力场效果计算物体受到的非接触力方向。运动预测在真正发生碰撞前提前预警。var pointInput new PointDistanceInput { Position queryPoint, MaxDistance 10.0f, // 只搜索10米范围内的最近点 Filter filter }; if (physicsWorld.CalculateDistance(pointInput, out DistanceHit hit)) { // hit.Distance 是查询点到碰撞体表面的最近距离 // hit.Position 是碰撞体表面上的最近点 // hit.SurfaceNormal 是该点的法线方向从碰撞体内部指向外部 }一个实用技巧用CalculateDistance实现高效的“范围内实体”查找。相比用OverlapSphere重叠球体检测返回所有在球内的实体再逐个计算距离CalculateDistance配合一个合理的MaxDistance可以直接得到最近的一个或几个实体通过遍历所有实体或结合BroadPhase在很多情况下更高效尤其是你只关心最近的那个目标时。4. 性能优化实战从“能用”到“高效”理解了基本操作我们进入实战优化环节。以下是几个直接影响帧率和稳定性的关键点。4.1 碰撞层CollisionFilter的策略设计这是成本最低、收益最高的优化。不要所有物体都在同一层。推荐的分层策略示例层名位掩码碰撞对象CollidesWith典型物体Static1 0Everything (Default)地形、建筑、不可移动的景物Dynamic1 1Static, Dynamic, Player, Enemy可移动的箱子、载具Player1 2Static, Dynamic, Enemy, Pickup玩家角色Enemy1 3Static, Dynamic, Player, PlayerProjectile敌人角色PlayerProjectile1 4Enemy, Static玩家发射的子弹EnemyProjectile1 5Player, Static敌人发射的子弹Pickup1 6Player可拾取物品Trigger1 7Player, Enemy触发器区域设计原则静态层与所有层碰撞因为静态物体是BroadPhase优化的基础且通常不可绕过。动态物体之间选择性碰撞比如箱子Dynamic之间可以碰撞但子弹Projectile之间通常不需要碰撞避免不必要的计算。同阵营物体不碰撞玩家的子弹不检测玩家敌人的子弹不检测敌人。这能砍掉近一半的无用检测。使用GroupIndex进行特殊覆盖CollisionFilter中的GroupIndex可以覆盖BelongsTo和CollidesWith的规则。如果GroupIndex大于0则只有GroupIndex相等的物体会碰撞用于特定机关联动如果小于0则GroupIndex相等的物体永不碰撞用于实现同一物体的多个碰撞体不自我碰撞比如角色的多个胶囊体。4.2 BroadPhase的调优与自定义Unity.Physics默认使用Bounding Volume Hierarchy (BVH)作为BroadPhase。BVH的性能很大程度上取决于包围盒AABB的紧密程度和树的平衡度。问题对于高速运动的物体如果它的AABB更新不及时比如每帧只根据当前位置计算那么在进行查询时由于物体已经移动它的AABB可能无法完全覆盖其运动轨迹导致查询漏检“子弹穿墙”。解决方案PhysicsMotionVelocity组件中的Linear和Angular速度会被物理系统用来预测性扩大物体的AABB称为“扩展AABB”或“Swept AABB”。确保为高速运动的物体正确设置速度分量。激进优化对于超大规模、分布特定的场景如开放世界可以考虑实现自定义的BroadPhase。例如基于网格Grid的空间划分对于均匀分布的大量小物体可能比BVH更高效。但这属于高级话题需要你实现IBroadPhase接口并谨慎评估收益。4.3 查询命令的批处理与Job化这是将性能榨干的关键。永远不要在主线程上循环调用立即查询。使用NativeList/NativeArray收集输入如上文的批量射线检测示例在OnUpdate中使用SystemAPI.Query或IJobEntity来遍历所有需要查询的实体将查询参数写入一个共享的NativeListRaycastInput。利用ScheduleStepJobs的并行处理这是核心。将收集好的命令数组传递给SimulationSingleton.ScheduleStepJobs。物理引擎内部会将这些查询Job化并充分利用多核CPU并行执行。结果处理也需Job化查询结果NativeArrayRaycastHit也应该在Burst编译的Job中处理而不是在主线程循环读取。将命中实体的Entity记录到另一个NativeListEntity中然后在另一个System里用SystemAPI.GetComponent等方式处理伤害、音效等逻辑。一个常见的架构模式PhysicsCommandCollectSystem负责收集本帧所有物理查询命令和修改请求如施加力。PhysicsStepSystem调用ScheduleStepJobs调度物理模拟和查询。PhysicsResponseSystem依赖于物理步进作业在Job中处理查询结果如计算伤害、触发事件并输出一个“事件”列表如NativeListDamageEvent。GameplayResponseSystem在主线程或另一个Job中消费“事件”列表执行实际的游戏逻辑如播放受击动画、更新UI血条。5. 疑难杂症与调试技巧实录即使理解了原理在实际开发中还是会遇到各种诡异问题。下面是我遇到的一些典型坑和解决方法。5.1 “检测不到”或“检测飘忽”的常见原因问题现象可能原因排查与解决射线偶尔穿墙1.高速物体帧间位移过大射线从墙缝穿过。2.Collider未正确附加实体缺少PhysicsCollider或LocalTransform。3.Filter配置错误射线层与目标层不匹配。1. 对高速物体使用ShapeCast胶囊体代替Raycast。2. 在System中查询并Debug.Log关键实体的组件是否存在。3. 使用PhysicsDebugDisplay系统可视化碰撞体和射线。ShapeCast结果异常1.Collider引用错误使用了错误或未初始化的BlobAssetReference。2.起始/结束姿态错误RigidTransform的位置或旋转单位不对如用了度数而非弧度。1. 确保Collider在OnCreate中创建并存储在OnUpdate中复用。2. 检查RigidTransform的值用Debug.DrawLine或Debug.DrawMesh可视化扫描体积。性能突然下降1.查询数量爆炸某一帧产生了远超平时的查询请求。2.BroadPhase失衡大量物体集中在很小区域导致BVH树深度激增。3.触发了GC Alloc在OnUpdate中意外创建了托管对象如new List。1. 使用Profiler的Physics模块查看每帧的Raycast/ShapeCast计数。2. 考虑对密集物体使用不同的碰撞层或简化碰撞体。3. 确保所有Native容器在OnCreate中分配在OnUpdate中只做Clear和Add。5.2 使用PhysicsDebugDisplay进行可视化调试这是Unity.Physics包自带的调试神器但需要手动开启。// 在某个System的OnUpdate中或使用一个调试用的MonoBehaviour if (Input.GetKeyDown(KeyCode.F1)) { // 切换物理调试显示的开关 var debugDisplay SystemAPI.GetSingletonRWPhysicsDebugDisplayData(); debugDisplay.ValueRW.DrawColliders !debugDisplay.ValueRW.DrawColliders; debugDisplay.ValueRW.DrawBroadPhase !debugDisplay.ValueRW.DrawBroadPhase; }开启后你可以在Scene视图中看到所有碰撞体的线框静态体是白色动态体是绿色触发器是蓝色。BroadPhase的BVH包围盒帮助你理解空间划分的效率。查询的射线和形状如果你在代码中绘制了调试图形可以结合查看。5.3 处理复杂碰撞体与复合形状一个实体只能附加一个PhysicsCollider但这个Collider可以是CompoundCollider复合碰撞体即由多个简单几何体BoxSphereCapsuleConvexHull等组合而成。创建复合碰撞体var children new NativeListCompoundCollider.ColliderBlobInstance(Allocator.Temp); children.Add(new CompoundCollider.ColliderBlobInstance { Collider BoxCollider.Create(new float3(-0.5f, 0, 0), quaternion.identity, new float3(1,2,1)), Transform new RigidTransform(quaternion.identity, new float3(0, 1, 0)) }); children.Add(new CompoundCollider.ColliderBlobInstance { Collider SphereCollider.Create(float3.zero, 0.5f), Transform new RigidTransform(quaternion.identity, new float3(0, 2.5f, 0)) }); var compoundCollider CompoundCollider.Create(children); // 将 compoundCollider.BlobAssetReference 赋值给实体的 PhysicsCollider性能影响对复合碰撞体进行查询成本是其所有子碰撞体查询成本之和。物理引擎需要对每一个子形状进行测试。因此对于性能敏感的角色应尽量使用单一的CapsuleCollider或BoxCollider来近似而非高精度的ConvexHull或复杂的CompoundCollider。5.4 与渲染、动画的同步问题在DOTS架构下物理变换LocalTransform和渲染变换LocalToWorld是分离的。通常一个拥有PhysicsCollider的实体也会有一个LocalTransform物理系统会更新这个LocalTransform。渲染系统则通过LocalToWorld来渲染。问题如果你通过动画系统如Unity.Animation驱动骨骼运动并希望碰撞体随之移动比如角色攻击时的武器碰撞体你需要手动将骨骼的世界矩阵同步到代表武器碰撞体的实体的LocalTransform上。这个过程需要在PhysicsStepSystem之前完成否则物理查询使用的将是上一帧的位置。解决方案创建一个System在PhysicsStepSystem之前运行使用IJobEntity遍历所有需要跟随动画的物理实体从动画组件中读取最新的骨骼变换并写入其LocalTransform和PhysicsCollider的变换如果是复合碰撞体可能需要更新其子变换。这确保了物理查询基于的是当前帧最新的视觉位置。最后关于性能没有什么比Unity Profiler的Physics模块更直观的了。密切关注Contacts、Raycasts、ColliderCasts的数量和耗时。如果BroadPhase耗时占比过高说明你的空间划分效率低如果NarrowPhase耗时高说明有太多复杂的形状在进行精细检测需要考虑简化碰撞体或优化过滤层。记住在DOTS物理的世界里性能优化是一场关于数据布局、并行度和算法选择的持续战斗理解其核心设计才能打好这场仗。