SuperAPI AI 工具集

unity-physics-queries

通用与其它

查看项目

更新于 10-16 01:37

技能介绍

用途:整理 Unity 物理查询中最常见的正确性陷阱,覆盖查询类型选择、分配、默认值等易错点,帮助开发者写出更可靠的物理检测代码。

主要能力:提供查询类型决策树(CheckSphere/CheckBox/CheckCapsule 用于二元检测,Raycast 用于最近命中,SphereCast/BoxCast/CapsuleCast 用于体积扫掠,RaycastAll/RaycastNonAlloc 用于全部命中,OverlapSphere/OverlapBox/OverlapCapsule 用于区域检测);说明起点位于碰撞体内部时所有 cast 查询会忽略该碰撞体,应改用 Overlap* 或 Check*;指出 RaycastAll/RaycastNonAlloc 结果不按距离排序,需手动排序;NonAlloc 缓冲区过小会静默丢弃结果,应预分配并只遍历返回数量;LayerMask.GetMask 返回位掩码,NameToLayer 返回索引,混用会静默过滤错误层;QueryTriggerInteraction 默认 UseGlobal 且 queriesHitTriggers 为 true,查询会命中触发器,需显式指定 Ignore;SphereCast 的 radius 是球体大小而非检测距离,hit.distance 是球心移动距离;CapsuleCast 的 point1/point2 是两端半球中心;非凸 MeshCollider 默认不检测背面,可设置 Physics.queriesHitBackfaces;多场景物理需通过 PhysicsScene 限定查询范围。

使用方式:作为技能参考,在编写或审查 Unity 物理查询代码时对照模式与反模式清单。

适用场景:地面检测、视线检测、子弹轨迹、爆炸范围、角色控制器等物理查询相关开发。

限制:资料未提供具体安装命令、收费信息或平台支持细节;部分 API 行为依赖 Unity 版本,需以官方文档为准。