PhysicsExamples2D API参考：Unity U2D.Physics命名空间核心类详解

PhysicsExamples2D API参考：Unity U2D.Physics命名空间核心类详解

【免费下载链接】PhysicsExamples2DExamples of various Unity 2D Physics components and features.项目地址: https://gitcode.com/gh_mirrors/ph/PhysicsExamples2D

PhysicsExamples2D是Unity官方提供的2D物理系统示例项目，通过直观的场景和组件展示了U2D.Physics命名空间下核心类的使用方法。本指南将详细解析TestWorld、TestBody和TestShape等核心类的功能特性、使用场景及关键API，帮助开发者快速掌握Unity 2D物理系统的基础架构与实践技巧。

物理系统架构概览

Unity 2D物理系统采用层级化架构设计，主要由物理世界、物理体、碰撞形状和关节等核心组件构成。这种模块化设计允许开发者灵活组合不同元素，构建复杂的物理交互场景。

核心类关系

• TestWorld：物理世界容器，管理所有物理体和碰撞检测
• TestBody：物理体组件，控制物体运动状态和物理属性
• TestShape：碰撞形状组件，定义物体的碰撞边界和物理材质
• TestJoint：关节组件，约束多个物理体之间的相对运动

TestWorld：物理世界管理

TestWorld作为物理模拟的顶级容器，负责协调所有物理体的更新和碰撞检测。每个场景可以有多个独立的TestWorld实例，实现隔离的物理模拟环境。

主要功能

• 维护物理世界的全局参数（重力、迭代次数等）
• 管理物理体的创建、销毁和更新
• 提供物理查询接口（射线检测、形状重叠等）

关键属性

public WorldDefinition WorldDefinition { get; set; } // 物理世界定义 public bool UseDefaultWorld { get; set; } // 是否使用默认世界 public object UserData { get; set; } // 用户自定义数据

使用示例

在场景中创建TestWorld实例后，可以通过代码访问其属性：

var testWorld = TestWorld.FindTestWorld(gameObject); testWorld.WorldDefinition.gravity = new Vector2(0, -9.8f); testWorld.UseDefaultWorld = false;

TestBody：物理体组件

TestBody代表物理世界中的一个实体，负责处理物体的运动状态和物理属性。通过调整BodyType属性，可以实现静态、动态或运动学等不同物理行为。

主要功能

• 控制物体的运动类型（静态/动态/运动学）
• 管理物体的物理属性（质量、摩擦、 restitution等）
• 处理物体的变换同步和物理回调

关键属性

public BodyType BodyType { get; set; } // 物理体类型 public float Mass { get; set; } // 质量 public float LinearDamping { get; set; } // 线性阻尼 public float AngularDamping { get; set; } // 角阻尼 public bool AllowSleep { get; set; } // 是否允许休眠

常用方法

// 查找物体层级中的TestBody组件 public static TestBody FindTestBody(GameObject obj) // 应用力到物理体 public void ApplyForce(Vector2 force) // 应用扭矩到物理体 public void ApplyTorque(float torque)

TestShape：碰撞形状组件

TestShape定义了物理体的碰撞边界，支持多种几何形状（圆形、胶囊形、多边形等）。通过组合多个TestShape，可以创建复杂的碰撞轮廓。

支持的形状类型

• Circle：圆形碰撞体，适合球类物体
• Capsule：胶囊形碰撞体，适合角色或胶囊状物体
• Polygon：多边形碰撞体，适合不规则形状
• Segment：线段碰撞体，适合地面或平台
• ChainSegment：链条碰撞体，适合复杂路径

关键属性

public ShapeType ShapeType { get; set; } // 形状类型 public float Density { get; set; } // 密度 public float Friction { get; set; } // 摩擦系数 public float Restitution { get; set; } // 弹性系数 public bool IsTrigger { get; set; } // 是否为触发器

形状配置示例

// 获取TestShape组件 var testShape = GetComponent<TestShape>(); // 配置圆形形状 testShape.ShapeType = ShapeType.Circle; testShape.CircleGeometry.radius = 0.5f; testShape.CircleGeometry.center = new Vector2(0, 0); // 设置物理材质属性 testShape.Friction = 0.3f; testShape.Restitution = 0.5f;

实际应用场景

1. 创建物理场景

通过组合TestWorld、TestBody和TestShape，可以快速搭建物理场景：

1. 在场景中添加TestWorld组件作为物理容器
2. 创建游戏对象并添加TestBody组件
3. 为TestBody添加TestShape组件定义碰撞边界
4. 调整参数实现所需物理行为

2. 实现物体交互

利用TestBody的物理方法实现物体交互：

// 给物体施加向上的力 var testBody = GetComponent<TestBody>(); testBody.ApplyForce(new Vector2(0, 10));

3. 碰撞检测与响应

通过回调函数处理碰撞事件：

private void OnCollisionEnter2D(Collision2D collision) { Debug.Log("碰撞发生: " + collision.gameObject.name); }

总结

Unity U2D.Physics命名空间提供了强大而灵活的2D物理模拟能力，通过TestWorld、TestBody和TestShape等核心类，开发者可以轻松构建各种物理交互场景。掌握这些核心类的使用方法，将为你的2D游戏开发带来更多可能性。

要开始使用PhysicsExamples2D项目，请克隆仓库：

git clone https://gitcode.com/gh_mirrors/ph/PhysicsExamples2D

项目中包含丰富的示例场景和源代码，可在OldPhysics2D/Assets/Scenes/目录下找到各种物理效果的演示，帮助你快速理解和应用这些核心类。

【免费下载链接】PhysicsExamples2DExamples of various Unity 2D Physics components and features.项目地址: https://gitcode.com/gh_mirrors/ph/PhysicsExamples2D