SuperAPI AI 工具集

unity-physics

通用与其它

查看项目

更新于 10-15 17:25

技能介绍

用途:该模块提供 Unity 编辑器内的物理相关技能,包括单帧物理查询(射线、球体/盒体投射、重叠检测)、重力读写、PhysicMaterial 资产创建与设置,以及层碰撞矩阵读写。所有技能在编辑器线程同步运行,真实物理模拟(积分与碰撞响应)仅在 Play mode 推进,本模块不启动模拟。

主要能力:physics_raycast(单次射线命中)、physics_raycast_all(穿透返回全部命中)、physics_spherecast、physics_boxcast、physics_check_overlap(球体重叠)、physics_overlap_box(盒体重叠)、physics_get_gravity / physics_set_gravity、physics_create_material、physics_set_material、physics_get_layer_collision / physics_set_layer_collision。射线结果为世界空间坐标。

使用方式:查询类技能可直接执行;变更类(set_gravity、create_material、set_material、set_layer_collision)需用户授权后执行。调用前应先读取 schema 获取准确参数与默认值,示例:unity_skills.call_skill("physics_raycast", originX=0, originY=5, originZ=0, dirX=0, dirY=-1, dirZ=0, maxDistance=10)。参数与返回值以 GET /skills/schema 或 unity_skills.get_skill_schema() 为准。

适用场景:编辑器内空间查询、重力与物理材质配置、层碰撞矩阵调整。

限制:不包含添加刚体/碰撞体或模拟步骤,需用 component_add 添加 Rigidbody/BoxCollider 等组件;physics_simulate 不存在;常见错误含 SEMANTIC_INVALID、TARGET_NOT_FOUND、MISSING_PARAM。