用途:当设计需要视线判定、体积重叠、地面探测或鼠标拾取时加载本技能。屏幕到 2D 世界的映射若未命中碰撞体,属于相机辅助,不算物理查询。
主要能力:组件持有探测半径或朝向标记,位置取自 GlobalTransform。相机拾取用 Camera::viewport_to_world_2d 配合 GlobalTransform 把光标映射为 2D 世界点,再对精灵做距离测试。探测选择包括:指针在世界中的位置取半径内最近实体;排除施法者自身实体;视锥用视线前向与目标方向点积,与余弦阈值比较。
使用方式:系统在移动之后读取变换;同一调度中两个系统运行时,用 .chain() 把探测排在写入 Transform 的系统之后。示例依赖为 bevy = "0.20"。半径探测遍历其他实体并跳过自身实体。朝向使用前向与余弦限值,移动先写 Transform,视线测试在链式下一系统读取 Transform,因为 GlobalTransform 仅在传播后更新。
限制:原版 Bevy 只测量点、半径与朝向;碰撞体投射、扫描与法线留在 bevy-physics-2d 与 bevy-physics-3d。探测不会报告自身,接受命中前需比较 Entity。不要在同一系统中读写刚写入的 Transform 与 GlobalTransform,不要在无 .chain() 的两个无序系统中可变查询同一组件。不要臆造物理、导航、网络或 XR crate,也不要臆造 intersect_ray 或掩码 API。文档 URL 不固定版本号,保持在 latest 页面。