RigidBody2D
以下为我对于官方文档的翻译以及使用情况，3.0版本的文档
RigidBody2D官方文档
继承: PhysicsBody2D < CollisionObject2D < Node2D < CanvasItem < Node < Object
类型: Core
简要说明
由2D物理引擎控制的物体。
成员函数
| 返回类型 | 函数 |
|---|---|
| void | _integrate_forces ( Physics2DDirectBodyState state ) virtual |
| void | add_force ( Vector2 offset, Vector2 force ) |
| void | apply_impulse ( Vector2 offset, Vector2 impulse ) |
| Array | get_colliding_bodies ( ) const |
| void | set_axis_velocity ( Vector2 axis_velocity ) |
| bool | test_motion ( Vector2 motion, float margin=0.08, Physics2DTestMotionResult result=null ) |
信号
- body_entered ( Object body )
当一个物体进入这个物体时发出的。 contact_monitor 必须为true，contacts_reported 必须大于0。
- body_exited ( Object body )
当一个物体离开这个物体时发出的。 contact_monitor 必须为true，contacts_reported 必须大于0。
- body_shape_entered ( int body_id, Object body, int body_shape, int local_shape )
当一个物体进入这个物体时发出的。报告碰撞形状信息。有关形状索引信息，请参见 CollisionObject2D 。 contact_monitor 必须为true， contacts_reported 必须大于 0 。
- body_shape_exited ( int body_id, Object body, int body_shape, int local_shape )
当一个物体离开这个物体时发出的。报告碰撞形状信息。有关形状索引信息，请参见 CollisionObject2D 。 contact_monitor 必须为true， contacts_reported 必须大于 0 。
- sleeping_state_changed ( )
当睡眠改变时发出。
成员变量
- float angular_damp - 抑制物体的 angular_velocity 。如果值为
-1那么物体将使用 “Project(项目) > Project Settings(项目设置) > Physics > 2d” 中的 “Default Angular Damp” 。默认值：-1。 - float angular_velocity - 物体的旋转速度。
- Vector2 applied_force - 物体的总施加力。
- float applied_torque - 物体的总施加扭矩。
- float bounce - 物体的弹性。默认值：
0。 - bool can_sleep - 如果值为
true，如果没有运动，物体就不会计算力并且它将作为一个静止的物体。当其他力通过碰撞或使用 apply_impulse 或 add_force 时，身体会醒来。默认值：true。 - bool contact_monitor - 如果是真的，当它与另一个 RigidBody2D 相撞时，物体会发出信号。请参阅 contacts_reported 。默认值：
false。 - int contacts_reported - 要报告的接触的最大数量。默认值：
0。 - CCDMode continuous_cd - 连续碰撞检测模式。默认值：
CCD_MODE_DISABLED。
连续碰撞检测试图预测一个运动物体在哪里碰撞，而不是移动它，并在碰撞后校正它的运动。连续碰撞检测速度较慢，但精度更高，并且忽略了小的、快速移动的物体的碰撞。光线投射与形状转换方法是能找到的。详情见CCD_MODE_ 常数。
- bool custom_integrator - 如果值为
true那么这个物体的内力结合将被禁止。除了碰撞响应之外，物体将只由 _integrate_forces 函数决定移动。 - float friction - 身体的摩擦力值范围从
0（无摩擦）到1（最大摩擦）。默认值：1。 - float gravity_scale - 乘以重力施加于身体。物体的重力是由“ Project(项目) > Project Settings(项目设置) > Physics > 2d” 中的 “Default Gravity” 值 和/或 Area2Ds应用的任何附加重力矢量计算的。默认值：
1。 - float inertia - 物体的转动惯量。这就像质量，但为了旋转：它决定旋转身体需要多少扭矩。惯性矩通常是根据质量和形状自动计算的，但是这个函数允许您设置一个自定义值。设置0（或负）惯性返回自动计算它。
- float linear_damp - 抑制物体的 linear_velocity 。如果- 1，物体将使用 “Project(项目) > Project Settings(项目设置) > Physics > 2d” 中的“Default Linear Damp”。默认值：
-1。 - Vector2 linear_velocity - 物体的线性速度。
- float mass - 物体的质量。默认值：
1。 - Mode mode - 物体的模式。参见
MODE_*常数。默认值：MODE_RIGID。 - bool sleeping - 如果值为
true物体会进入睡眠且不会计算力，直到通过碰撞或使用 apply_impulse 或 add_force 唤醒。 - float weight - 物体的重量基于其的质量和 “Project(项目) > Project Settings(项目设置) > Physics > 2d” 中的 “Default Gravity” 的值。
枚举
enum CCDMode
- CCD_MODE_DISABLED = 0 — 禁用连续碰撞检测。这是检测身体碰撞最快的方法，但可以错过小而快速移动的物体。
- CCD_MODE_CAST_RAY = 1 — 使用光线投射实现连续碰撞检测。这比形状调整快，但精度不高。
- CCD_MODE_CAST_SHAPE = 2 — 使用形状调整实现连续碰撞检测。这是最慢的CCD方法，也是最精确的。
enum Mode - MODE_RIGID = 0 — 刚性模式。身体表现为一个物理对象。它与其他物体发生碰撞，并对它施加的力作出反应。这是默认模式。
- MODE_STATIC = 1 — 静态模式。物体的表现类似 StaticBody2D ，不动。
- MODE_CHARACTER = 2 — 字符模式。类似于
MODE_RIGID，但身体不能旋转。 - MODE_KINEMATIC = 3 — 运动模式。物体类似一个 KinematicBody2D ，必须用代码移动。
描述
这个节点实现了模拟2D物理。您不直接控制 RigidBody2D 。取而代之的是，你施加力（重力、脉冲等）并且物理模拟基于它的质量、摩擦和其他物理特性来计算最终的运动。
RigidBody2D 具有4种行为模式：刚性、静态、字符和运动。
注意：你不应该改变 RigidBody2D 的 position 或 linear_velocity 每帧甚至非常频繁。如果你需要直接影响身体的状态，请使用 _integrate_forces 力，它可以让你直接进入物理状态。
如果需要重写默认物理行为，可以编写自定义力集成。参见 custom_integrator 。
成员函数描述
- void _integrate_forces ( Physics2DDirectBodyState state ) virtual
允许您读取并安全地修改对象的仿真状态。如果你需要直接改变身体的 position 或其他物理特性，就用这个 Node._physics_process 代替。默认情况下，它还可以用于附加普通的物理行为，但是 custom_integrator 允许禁用默认行为，并为主体编写自定义的力集成。
- void add_force ( Vector2 offset, Vector2 force )
向物体增加一个定向力。来自物体原点的力和偏移都在全局坐标中。
- void apply_impulse ( Vector2 offset, Vector2 impulse )
对物体施加一个定向推力（这将受身体质量和形状的影响）。这相当于用球杆击打台球：瞬间施加的力。推力和来自物体原点的偏移都在全局坐标中。
- Array get_colliding_bodies ( ) const
返回与此碰撞的物体的列表。使用 contacts_reported 设置最大报告数。还必须将 contact_monitor 设置为 true。注意，在移动对象之后，此测试的结果不是即时的。对于性能，每帧一次和物理步骤之前更新一次碰撞列表。考虑使用信号代替。
- void set_axis_velocity ( Vector2 axis_velocity )
在给定的轴上设置物体的速度。在给定的矢量轴中的速度将被设置为给定的矢量长度。这对于跳跃行为是有用的。
- bool test_motion ( Vector2 motion, float margin=0.08, Physics2DTestMotionResult result=null )
如果用给定向量进行移动会导致冲突，则返回 true 。 margin 增加了碰撞检测中涉及的形状的大小, 并且 result(结果) 是Physics2DTestMotionResult类型的对象，该对象包含关于碰撞的附加信息（如果有的话）。
使用
还在学。。。。