Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
PhysicsServer2D
繼承： Object
用於存取低階 2D 物理的伺服器介面。
說明
PhysicsServer2D 是負責所有 2D 物理的伺服器。它可以直接建立和操作所有物理對象：
Space（空間）是用於物理模擬的自包含世界。它包含實體、區域和關節。可以對其狀態進行查詢，取得碰撞和相交資訊，並且可以修改部分模擬參數。
Shape（形狀）是圓形、矩形、膠囊形、多邊形等幾何形狀。加入到實體/區域中就可以用來進行碰撞偵測，還可以帶有相對於實體/區域原點的額外變換。實體/區域中可以新增多個（變換後的）形狀，同一個形狀可以使用不同的區域變換新增到實體/區域中。
Body（實體）是物理物件，可以處於靜態、運動學或剛性模式。可以對其狀態進行查詢和更新（例如位置、速度等）。可以設定力的集成回呼函式，自訂實體的物理特性。
Area（區域）是空間中的區塊，可用於偵測進入和離開它的實體和區域。可以設定實體的監視回呼函式，報告進入/離開的實體形狀，同樣可以設定區域的監視回呼函式。通過設定區域參數，可以在區域內覆蓋重力和阻尼。
Joint（關節）是兩個實體之間或一個實體相對於某個點的約束。可以調整關節偏置和彈簧關節的放鬆長度等參數。
PhysicsServer2D 中的物理物件可以獨立建立和操作；不必將它們綁定到場景樹中的節點。
注意：所有 2D 物理節點都在內部使用這個物理伺服器。將物理節點新增到場景樹，就會導致在物理伺服器中建立相應的物理物件。剛體節點會註冊回呼函式，該回呼函式會（在每次物理更新時）使用物理伺服器中相應實體物件的變換更新該節點的變換。區域節點會註冊回呼函式，用來通知區域節點與物理伺服器中相應區域物件的重疊。射線投射節點會查詢物理伺服器中相關空間的直接狀態。
方法
列舉
enum SpaceParameter: 🔗
SpaceParameter SPACE_PARAM_CONTACT_RECYCLE_RADIUS = 0
常數，用於設定/取得一對物體在其碰撞狀態被重新計算之前的最大移動距離。該參數的預設值為 ProjectSettings.physics/2d/solver/contact_recycle_radius。
SpaceParameter SPACE_PARAM_CONTACT_MAX_SEPARATION = 1
常數，用於設定/取得兩個形狀間的最大距離，超過該距離後它們將被視為分離，接觸將被棄置。該參數的預設值為 ProjectSettings.physics/2d/solver/contact_max_separation。
SpaceParameter SPACE_PARAM_CONTACT_MAX_ALLOWED_PENETRATION = 2
常數，用於設定/取得兩個形狀互相穿透的最大距離，超過該距離後將視為碰撞。該參數的預設值為 ProjectSettings.physics/2d/solver/contact_max_allowed_penetration。
SpaceParameter SPACE_PARAM_CONTACT_DEFAULT_BIAS = 3
常數，用於設定/取得所有物理接觸的預設求解器偏差。求解器偏差是控制兩個物件在重疊後“反彈”的程度的一個係數，以避免由於數值不精確而使它們處於該狀態。該參數的預設值為 ProjectSettings.physics/2d/solver/default_contact_bias。
SpaceParameter SPACE_PARAM_BODY_LINEAR_VELOCITY_SLEEP_THRESHOLD = 4
常數，用於設定/取得活躍的閾值線速度。一個線性速度和角速度都被標記為可能處於非活動狀態的物體，將在給定時間後進入睡眠狀態。該參數的預設值為 ProjectSettings.physics/2d/sleep_threshold_linear。
SpaceParameter SPACE_PARAM_BODY_ANGULAR_VELOCITY_SLEEP_THRESHOLD = 5
常數，用於設定/取得活躍的閾值角速度。一個線性速度和角速度都被標記為可能處於非活動狀態的物體，將在給定時間後進入睡眠狀態。該參數的預設值為 ProjectSettings.physics/2d/sleep_threshold_angular。
SpaceParameter SPACE_PARAM_BODY_TIME_TO_SLEEP = 6
常數，用於設定/獲得最大的活動時間。一個被標記為線速度和角速度都可能不活動的物體，在這個時間之後將被置入睡眠狀態。
此參數的預設值為 ProjectSettings.physics/2d/time_before_sleep。
SpaceParameter SPACE_PARAM_CONSTRAINT_DEFAULT_BIAS = 7
常數，用於設定/取得所有物理約束的預設求解器偏差。求解器偏差是控制兩個物件在違反約束後“反彈”的程度的一個係數，以避免由於數值不精確而使它們處於該狀態。該參數的預設值為 ProjectSettings.physics/2d/solver/default_constraint_bias。
SpaceParameter SPACE_PARAM_SOLVER_ITERATIONS = 8
常數，用於設定/取得所有接觸與約束的求解器反覆運算數。反覆運算次數越多，碰撞越準確。但是，大量的反覆運算會需要更多的 CPU 能力，會降低效能。
此參數的預設值為 ProjectSettings.physics/2d/solver/solver_iterations。
enum ShapeType: 🔗
ShapeType SHAPE_WORLD_BOUNDARY = 0
常數，用於建立世界邊界形狀。一個世界邊界形狀，是具有原點和法線的無限直線。因此，它可以用於前面/背面檢查。
ShapeType SHAPE_SEPARATION_RAY = 1
常數，用於建立分離射線形狀。一條分離射線由一個長度定義，並將其自身與接觸其遠端點的物體分開。對角色控制器很有用。
ShapeType SHAPE_SEGMENT = 2
常數，用於建立線段形狀。一條線段形狀是從點 A 到點 B 的有限線段。可以用於檢查交叉點。
ShapeType SHAPE_CIRCLE = 3
這是建立圓形的常數。一個圓的形狀只有一個半徑。它可以用於交點和內/外側檢查。
ShapeType SHAPE_RECTANGLE = 4
這是用於建立矩形形狀的常數。矩形形狀是由寬度和高度定義的。它可以用於交點和內/外側檢查。
ShapeType SHAPE_CAPSULE = 5
這是建立膠囊形狀的常數。一個膠囊形狀由一個半徑和一個長度定義。它可以用於交點和內/外側檢查。
ShapeType SHAPE_CONVEX_POLYGON = 6
常數，用於建立凸多邊形形狀。一個多邊形是由一個點的列表定義的。它可以用於交叉點和內側/外側檢查。
ShapeType SHAPE_CONCAVE_POLYGON = 7
這是建立凹形多邊形的常數。一個多邊形是由一個點的列表定義的。它可以用於交叉點檢查，但不能用於內/外側檢查。
ShapeType SHAPE_CUSTOM = 8
引擎內部會使用這個常數。任何試圖建立這種形狀的行為都會導致錯誤。
enum AreaParameter: 🔗
AreaParameter AREA_PARAM_GRAVITY_OVERRIDE_MODE = 0
常數，在一個區域中設定/取得重力覆蓋模式。有關可能的值，請參閱 AreaSpaceOverrideMode。這個參數的預設值是 AREA_SPACE_OVERRIDE_DISABLED。
AreaParameter AREA_PARAM_GRAVITY = 1
常數，用於設定/取得區域中的重力強度。該參數的預設值為 9.80665。
AreaParameter AREA_PARAM_GRAVITY_VECTOR = 2
常數，用於設定/取得區域中的重力向量/中心。該參數的預設值為 Vector2(0, -1)。
AreaParameter AREA_PARAM_GRAVITY_IS_POINT = 3
常數，用於設定/取得區域中的重力向量是方向，還是中心點。該參數的預設值為 false。
AreaParameter AREA_PARAM_GRAVITY_POINT_UNIT_DISTANCE = 4
常數，用於設定/取得重力強度等於 AREA_PARAM_GRAVITY 控制的重力的距離。例如，在一個半徑為 100 圖元且表面重力為 4.0 px/s² 的行星上，將重力設定為 4.0，將單位距離設定為 100.0。重力將根據平方反比定律衰減，因此在該範例中，距離中心 200 圖元處的重力將為 1.0 px/s²（距離的兩倍，重力的 1/4），距離中心 50 像素處重力為 16.0 px/s²（距離的一半，重力的 4 倍），依此類推。
僅當單位距離為正數時，上述情況才成立。當單位距離設定為 0.0 時，重力將與距離無關。該參數的預設值為 0.0。
AreaParameter AREA_PARAM_LINEAR_DAMP_OVERRIDE_MODE = 5
常數，用於在一個區域中設定/取得線性阻尼覆蓋模式。有關可能的值，請參閱 AreaSpaceOverrideMode。這個參數的預設值是 AREA_SPACE_OVERRIDE_DISABLED。
AreaParameter AREA_PARAM_LINEAR_DAMP = 6
常數，用於設定/取得區域的線性阻尼係數。該參數的預設值為 0.1。
AreaParameter AREA_PARAM_ANGULAR_DAMP_OVERRIDE_MODE = 7
常數，用於在一個區域中設定/取得角度阻尼覆蓋模式。有關可能的值，請參閱 AreaSpaceOverrideMode。這個參數的預設值是 AREA_SPACE_OVERRIDE_DISABLED。
AreaParameter AREA_PARAM_ANGULAR_DAMP = 8
常數，用於設定/取得區域的角度阻尼係數。該參數的預設值為 1.0。
AreaParameter AREA_PARAM_PRIORITY = 9
常數，用於設定/取得區域的優先順序（處理順序）。該參數的預設值為 0。
enum AreaSpaceOverrideMode: 🔗
AreaSpaceOverrideMode AREA_SPACE_OVERRIDE_DISABLED = 0
這個區域不影響重力/阻尼。這些一般都是只存在於偵測碰撞的區域，以及進入或離開它們的物體。
AreaSpaceOverrideMode AREA_SPACE_OVERRIDE_COMBINE = 1
此區域把它的重力/阻尼加到目前已經計算過的對象上。這樣一來，許多重疊的區域可以結合它們的物理運算來產生有趣的效果。
AreaSpaceOverrideMode AREA_SPACE_OVERRIDE_COMBINE_REPLACE = 2
這個區域把它的重力/阻尼加到迄今為止已經計算出來的任何東西上。然後停止考慮其餘的區域，甚至預設的區域。
AreaSpaceOverrideMode AREA_SPACE_OVERRIDE_REPLACE = 3
這個區域取代了任何重力/阻尼，甚至是預設的，並停止考慮其餘的區域。
AreaSpaceOverrideMode AREA_SPACE_OVERRIDE_REPLACE_COMBINE = 4
這個區域取代了到目前為止計算的任何重力/阻尼，但繼續計算其餘的區域，直到預設的區域。
enum BodyMode: 🔗
BodyMode BODY_MODE_STATIC = 0
常數，用於靜態物體。在這種模式下，物體只能由使用者程式碼移動，移動時不會與路徑上的其他物體發生碰撞。
BodyMode BODY_MODE_KINEMATIC = 1
常數，用於運動學物體。在這種模式下，物體只能由使用者程式碼移動，會與路徑上的其他物體發生碰撞。
BodyMode BODY_MODE_RIGID = 2
常數，用於剛體。在這種模式下，物體可以被其他物體推動，能夠對其施加力。
BodyMode BODY_MODE_RIGID_LINEAR = 3
常數，用於線性剛體。在這種模式下，物體不能旋轉，只有線速度受外力影響。
enum BodyParameter: 🔗
BodyParameter BODY_PARAM_BOUNCE = 0
常數，用於設定/取得物體的反彈係數。該參數的預設值為 0.0。
BodyParameter BODY_PARAM_FRICTION = 1
常數，用於設定/取得實體摩擦力。該參數的預設值為 1.0。
BodyParameter BODY_PARAM_MASS = 2
常數，用於設定/取得一個實體品質。該參數的預設值為1.0。如果該實體的模式被設定為 BODY_MODE_RIGID，那麼設定這個參數會有以下附加效果：
如果該參數 BODY_PARAM_CENTER_OF_MASS 從未被明確設定，則該參數的值將根據實體的形狀重新計算。
如果該參數 BODY_PARAM_INERTIA 被設定為值
<= 0.0，則該參數的值將根據該實體的形狀、品質、和質心重新計算。
BodyParameter BODY_PARAM_INERTIA = 3
常數，用於設定/取得一個實體慣性。該參數的預設值為0.0。如果實體的慣性被設定為一個值 <= 0.0，那麼慣性將根據實體的形狀、品質、和質心重新計算。
BodyParameter BODY_PARAM_CENTER_OF_MASS = 4
常數，用於在物體區域座標系中設定/取得該物體的質心位置。該參數的預設值為 Vector2(0, 0)。如果該參數從未明確設定，則在設定參數 BODY_PARAM_MASS 或呼叫 body_set_space() 時，會根據物體的形狀重新計算。
BodyParameter BODY_PARAM_GRAVITY_SCALE = 5
常數，用於設定/取得物體的重力倍數。該參數的預設值為 1.0。
BodyParameter BODY_PARAM_LINEAR_DAMP_MODE = 6
常數，用於設定/取得物體的線性阻尼模式。可能的值見 BodyDampMode。這個參數的預設值為 BODY_DAMP_MODE_COMBINE。
BodyParameter BODY_PARAM_ANGULAR_DAMP_MODE = 7
常數，用於設定/取得物體的角度阻尼模式。可能的值見 BodyDampMode。這個參數的預設值為 BODY_DAMP_MODE_COMBINE。
BodyParameter BODY_PARAM_LINEAR_DAMP = 8
常數，用於設定/取得物體的線性阻尼係數。該參數的預設值為 0.0。
BodyParameter BODY_PARAM_ANGULAR_DAMP = 9
常數，用於設定/取得物體的角度阻尼係數。該參數的預設值為 0.0。
BodyParameter BODY_PARAM_MAX = 10
代表 BodyParameter 列舉的大小。
enum BodyDampMode: 🔗
BodyDampMode BODY_DAMP_MODE_COMBINE = 0
物體的阻尼值會疊加到替換區域中所設定的值或預設值。
BodyDampMode BODY_DAMP_MODE_REPLACE = 1
物體的阻尼值會替換區域中所設定的值或預設值。
enum BodyState: 🔗
BodyState BODY_STATE_TRANSFORM = 0
常數，用於設定/取得物體的目前變換矩陣。
BodyState BODY_STATE_LINEAR_VELOCITY = 1
常數，用於設定/取得物體的目前線速度。
BodyState BODY_STATE_ANGULAR_VELOCITY = 2
常數，用於設定/取得物體的目前角速度。
BodyState BODY_STATE_SLEEPING = 3
常數，用於使物體沉睡/喚醒，或得到它是否在沉睡。
BodyState BODY_STATE_CAN_SLEEP = 4
常數，用於設定/取得物體是否可以休眠。
enum JointType: 🔗
JointType JOINT_TYPE_PIN = 0
常數，用於創造釘關節。
JointType JOINT_TYPE_GROOVE = 1
常數，用於創造槽關節。
JointType JOINT_TYPE_DAMPED_SPRING = 2
常數，用於創造有阻尼的彈簧關節。
JointType JOINT_TYPE_MAX = 3
代表 JointType 列舉的大小。
enum JointParam: 🔗
JointParam JOINT_PARAM_BIAS = 0
常數，用於設定/取得該關節將實體拉回以滿足關節約束的速度。值越低，兩個物體對關節的拉動就越大。該參數的預設值為 0.0。
注意：在 Godot 物理中，這個參數只用於銷關節和槽關節。
JointParam JOINT_PARAM_MAX_BIAS = 1
常數，用於設定/取得關節可以套用校正的最大速度。該參數的預設值為 3.40282e+38。
注意：在 Godot 物理中，這個參數只用於槽關節。
JointParam JOINT_PARAM_MAX_FORCE = 2
常數，用於設定/取得關節可用於作用於兩個實體的最大力。該參數的預設值為 3.40282e+38。
注意：在 Godot 物理中，這個參數只用於槽關節。
enum PinJointParam: 🔗
PinJointParam PIN_JOINT_SOFTNESS = 0
常數，用於設定/取得銷關節的紐帶可以彎曲多少。該參數的預設值為 0.0。
PinJointParam PIN_JOINT_LIMIT_UPPER = 1
鉸鏈上的最大旋轉。
PinJointParam PIN_JOINT_LIMIT_LOWER = 2
鉸鏈上的最小旋轉。
PinJointParam PIN_JOINT_MOTOR_TARGET_VELOCITY = 3
軸上馬達的目標速度。
enum PinJointFlag: 🔗
PinJointFlag PIN_JOINT_FLAG_ANGULAR_LIMIT_ENABLED = 0
如果為 true，鉸鏈具有最大和最小旋轉。
PinJointFlag PIN_JOINT_FLAG_MOTOR_ENABLED = 1
如果為 true，則馬達將轉動鉸鏈。
enum DampedSpringParam: 🔗
DampedSpringParam DAMPED_SPRING_REST_LENGTH = 0
設定彈簧關節的放鬆長度。當拉開時，該關節將始終嘗試回到這個長度。該參數的預設值是關節錨點之間的距離。
DampedSpringParam DAMPED_SPRING_STIFFNESS = 1
設定彈簧關節的剛度。該關節施加的力等於剛度乘以距其放鬆長度的距離。該參數的預設值為 20.0。
DampedSpringParam DAMPED_SPRING_DAMPING = 2
設定彈簧關節的阻尼比率。值為 0 表示無阻尼彈簧，而 1 表示系統盡可能快地達到平衡（臨界阻尼）。該參數的預設值為 1.5。
enum CCDMode: 🔗
CCDMode CCD_MODE_DISABLED = 0
停用連續碰撞偵測。這是偵測物體碰撞的最快方法，但可能會錯過較小和/或快速移動的物體。
CCDMode CCD_MODE_CAST_RAY = 1
通過射線投射實作連續的碰撞偵測。它比形狀投射更快，但不夠精確。
CCDMode CCD_MODE_CAST_SHAPE = 2
通過形變實作連續的碰撞偵測。它是最慢的 CCD 方法，也是最精確的。
enum AreaBodyStatus: 🔗
AreaBodyStatus AREA_BODY_ADDED = 0
當對象進入其形狀之一時，第一個參數和區域回呼函式接收的值。
AreaBodyStatus AREA_BODY_REMOVED = 1
當對象退出其形狀之一時，第一個參數和區域回呼函式接收的值。
enum ProcessInfo: 🔗
ProcessInfo INFO_ACTIVE_OBJECTS = 0
常數，用以取得未處於睡眠狀態的物件的數量。
ProcessInfo INFO_COLLISION_PAIRS = 1
常數，用以取得可能的碰撞數。
ProcessInfo INFO_ISLAND_COUNT = 2
常數，用以取得可能發生碰撞的空間區域數。
方法說明
void area_add_shape(area: RID, shape: RID, transform: Transform2D = Transform2D(1, 0, 0, 1, 0, 0), disabled: bool = false) 🔗
使用給定的區域變換向區域新增一個形狀。該形狀（連同它的 transform 和 disabled 屬性）被新增到一個形狀陣列中，一個區域的形狀通常由它們在這個陣列中的索引引用。
void area_attach_canvas_instance_id(area: RID, id: int) 🔗
將畫布的 ObjectID 附加到該區域。使用 Object.get_instance_id() 取得 CanvasLayer 的 ObjectID。
void area_attach_object_instance_id(area: RID, id: int) 🔗
將 Object 的 ObjectID 附加到該區域。使用 Object.get_instance_id() 取得 CollisionObject2D 的 ObjectID。
void area_clear_shapes(area: RID) 🔗
從該區域移除所有形狀。這不會刪除形狀本身，因此它們可以繼續在別處使用或稍後添加回來。
在物理伺服器中建立一個 2D 區域物件，並回傳標識該區域的 RID。所建立區域的預設設定包括設定為 1 的碰撞層和遮罩，以及設定為 false 的 monitorable。
使用 area_add_shape() 向其新增形狀，使用 area_set_transform() 設定其變換，並使用 area_set_space() 將區域新增到一個空間。如果你希望該區域可被檢測，請使用 area_set_monitorable()。
int area_get_canvas_instance_id(area: RID) const 🔗
返回附加到該區域的畫布的 ObjectID。使用 @GlobalScope.instance_from_id() 從非零 ObjectID 檢索一個 CanvasLayer。
int area_get_collision_layer(area: RID) const 🔗
返回該區域所屬的實體層，形式為位元遮罩。
int area_get_collision_mask(area: RID) const 🔗
返回該區域所能接觸的實體層，形式為位元遮罩。
int area_get_object_instance_id(area: RID) const 🔗
返回附加到該區域的 ObjectID。可使用 @GlobalScope.instance_from_id() 從非零 ObjectID 中檢索一個 Object。
Variant area_get_param(area: RID, param: AreaParameter) const 🔗
回傳給定區域參數的取值。
RID area_get_shape(area: RID, shape_idx: int) const 🔗
返回該區域的形狀陣列中給定索引的形狀的 RID。
int area_get_shape_count(area: RID) const 🔗
返回新增給該區域的形狀數量。
Transform2D area_get_shape_transform(area: RID, shape_idx: int) const 🔗
返回該區域的形狀陣列中給定索引的形狀的區域變換矩陣。
RID area_get_space(area: RID) const 🔗
回傳分配給該區域的空間 RID。如果沒有分配空間，則回傳空 RID。
Transform2D area_get_transform(area: RID) const 🔗
返回該區域的變換矩陣。
void area_remove_shape(area: RID, shape_idx: int) 🔗
從區域的形狀陣列中移除具有給定索引的形狀。該形狀本身並沒有被刪除，所以它可以繼續在別處使用或稍後新增回來。此操作會使曾經索引高於 shape_idx 的區域形狀的索引將減少一個。
void area_set_area_monitor_callback(area: RID, callback: Callable) 🔗
設定該區域的區域監視回呼函式。當任何其他（形狀）區域進入或退出（形狀）給定區域時，將呼叫此回呼函式，並且必須採用以下五個參數：
一個整數
status：AREA_BODY_ADDED 或 AREA_BODY_REMOVED 取決於其他區域的形狀是進入還是退出該區域，一個整數
instance_id：附加到其他區域的ObjectID，一個整數
area_shape_idx：進入或退出該區域的其他區域的形狀索引，一個整數
self_shape_idx：其他區域進入或退出的區域的形狀索引。
通過計算（或追蹤）進入和退出的形狀，可以確定一個區域（及其所有形狀）是第一次進入還是最後一次退出。
void area_set_collision_layer(area: RID, layer: int) 🔗
將該區域分配給若干個實體層，使用位元遮罩。
void area_set_collision_mask(area: RID, mask: int) 🔗
設定該區域所監視的實體層，使用位元遮罩。
void area_set_monitor_callback(area: RID, callback: Callable) 🔗
設定區域的實體監視器回呼函式。當任何其他（形狀的）實體進入或退出（形狀的）給定區域時，將呼叫此回呼函式，並且必須採用以下五個參數：
一個整數
status：AREA_BODY_ADDED 或 AREA_BODY_REMOVED 取決於其他實體形狀是否進入或退出該區域，一個整數
instance_id：附加到該實體上的ObjectID，一個整數
body_shape_idx：進入或離開該區域的實體形狀索引，一個整數
self_shape_idx：實體進入或離開的區域的形狀索引。
通過計算（或追蹤）進入和退出的形狀，可以確定一個實體（及其所有形狀）是第一次進入還是最後一次退出。
void area_set_monitorable(area: RID, monitorable: bool) 🔗
設定該區域是否可監視。如果 monitorable 為 true，則該區域進入或退出其他區域時，會呼叫其他區域的區域監視回呼函式。
void area_set_param(area: RID, param: AreaParameter, value: Variant) 🔗
設定給定區域參數的取值。
void area_set_shape(area: RID, shape_idx: int, shape: RID) 🔗
用另一個形狀替換給定索引處的區域形狀，同時不會影響在同一索引處的 transform 和 disabled 屬性。
void area_set_shape_disabled(area: RID, shape_idx: int, disabled: bool) 🔗
使用給定索引設定區域形狀的停用屬性。如果 disabled 為 true，則該形狀將不會偵測任何其他形狀進入或退出它。
void area_set_shape_transform(area: RID, shape_idx: int, transform: Transform2D) 🔗
設定該區域給定索引的形狀的區域變換。
void area_set_space(area: RID, space: RID) 🔗
從先前賦予的空間（如果有）中移除該區域後，將該區域新增到給定空間。
注意：要從空間中移除一個區域而不立即將其新增回其他地方，請使用 PhysicsServer2D.area_set_space(area, RID())。
void area_set_transform(area: RID, transform: Transform2D) 🔗
設定該區域的變換矩陣。
void body_add_collision_exception(body: RID, excepted_body: RID) 🔗
將 excepted_body 新增到實體的碰撞例外列表中，以便忽略與它的碰撞。
void body_add_constant_central_force(body: RID, force: Vector2) 🔗
向實體新增一個恒定的定向力。該力不影響旋轉。隨著時間的推移，力會一直施加，直到使用 PhysicsServer2D.body_set_constant_force(body, Vector2(0, 0)) 清除。
這相當於在實體的質心處使用 body_add_constant_force()。
void body_add_constant_force(body: RID, force: Vector2, position: Vector2 = Vector2(0, 0)) 🔗
向實體新增一個恒定的定位力。如果 position 與實體的質心不同，則力會影響旋轉。力會持續施加，直到使用 PhysicsServer2D.body_set_constant_force(body, Vector2(0, 0)) 清除。
position 是在全域座標中距實體原點的偏移量。
void body_add_constant_torque(body: RID, torque: float) 🔗
向實體新增一個恒定的旋轉力。該力不影響位置。隨著時間的推移，該力會一直施加，直到使用 PhysicsServer2D.body_set_constant_torque(body, 0) 清除。
void body_add_shape(body: RID, shape: RID, transform: Transform2D = Transform2D(1, 0, 0, 1, 0, 0), disabled: bool = false) 🔗
使用給定的區域變換向該區域新增一個形狀。該形狀（連同它的 transform 和 disabled 屬性）將被新增到一個形狀陣列中，一個實體的形狀通常由它們在這個陣列中的索引引用。
void body_apply_central_force(body: RID, force: Vector2) 🔗
在實體的質心處向實體施加一個定向力。該力不影響旋轉。力是時間相關的，這意味著每次物理更新都會被施加。
這相當於在實體的質心處使用 body_apply_force()。
void body_apply_central_impulse(body: RID, impulse: Vector2) 🔗
在實體的質心處向該實體施加一個定向脈衝。該脈衝不影響旋轉。
脈衝是時間無關的！每影格施加一個脈衝將產生一個依賴於畫面播放速率的力。出於這個原因，它應該只在模擬一次性影響時使用（否則使用“_force”函式）。
這相當於在實體的質心處使用 body_apply_impulse()。
void body_apply_force(body: RID, force: Vector2, position: Vector2 = Vector2(0, 0)) 🔗
向實體施加一個定位力。如果 position 與實體的質心不同，則力會影響旋轉。力是時間相關的，意味著每次物理更新都會被施加。
position 是在全域座標中距實體原點的偏移量。
void body_apply_impulse(body: RID, impulse: Vector2, position: Vector2 = Vector2(0, 0)) 🔗
向實體施加一個定位脈衝。如果 position 與實體的質心不同，則該脈衝會影響旋轉。
脈衝是時間無關的！每影格施加一個脈衝將產生一個依賴於畫面播放速率的力。出於這個原因，它應該只在模擬一次性影響時使用（否則使用“_force”函式）。
position 是在全域座標中距實體原點的偏移量。
void body_apply_torque(body: RID, torque: float) 🔗
對實體施加一個旋轉力。該力不影響位置。力是時間相關的，意味著每次物理更新都會被施加。
void body_apply_torque_impulse(body: RID, impulse: float) 🔗
對實體施加一個旋轉的脈衝。該脈衝不影響位置。
脈衝是時間無關的！每影格施加一個脈衝將產生一個依賴於畫面播放速率的力。出於這個原因，它應該只在模擬一次性影響時使用（否則使用“_force”函式）。
void body_attach_canvas_instance_id(body: RID, id: int) 🔗
將畫布的 ObjectID 附加到該實體。可使用 Object.get_instance_id() 取得 CanvasLayer 的 ObjectID。
void body_attach_object_instance_id(body: RID, id: int) 🔗
將 Object 的 ObjectID 附加到該實體。可使用 Object.get_instance_id() 取得 CollisionObject2D 的 ObjectID。
void body_clear_shapes(body: RID) 🔗
從該實體中移除所有形狀。這不會刪除形狀本身，因此它們可以繼續在別處使用或稍後新增回來。
在物理伺服器中建立一個 2D 物體物件，並回傳標識它的 RID。所建立區域的預設設定包括設定為 1 的碰撞層和遮罩，以及設定為 BODY_MODE_RIGID 的物體模式。
使用 body_add_shape() 為其新增形狀，使用 body_set_state() 設定其變換，使用 body_set_space() 將物體新增到一個空間。
int body_get_canvas_instance_id(body: RID) const 🔗
返回附加到該實體的畫布的 ObjectID。可使用 @GlobalScope.instance_from_id() 從非零 ObjectID 檢索一個 CanvasLayer。
int body_get_collision_layer(body: RID) const 🔗
返回物體所屬的實體層，形式為位元遮罩。
int body_get_collision_mask(body: RID) const 🔗
返回物體可以碰撞的實體層，形式為位元遮罩。
float body_get_collision_priority(body: RID) const 🔗
返回該實體的碰撞優先順序。這用於 body_test_motion() 的穿透階段。優先順序越高，對該實體的穿透力就越低。
Vector2 body_get_constant_force(body: RID) const 🔗
返回在每次物理更新期間，該物體被施加的總的恒定位置的力。
參閱 body_add_constant_force() 和 body_add_constant_central_force()。
float body_get_constant_torque(body: RID) const 🔗
返回在每次物理更新期間，該物體被施加的總的恒定旋轉的力。
參閱 body_add_constant_torque()。
CCDMode body_get_continuous_collision_detection_mode(body: RID) const 🔗
回傳該物體的連續碰撞檢測模式。
PhysicsDirectBodyState2D body_get_direct_state(body: RID) 🔗
返回該實體的 PhysicsDirectBodyState2D。如果該實體已被銷毀或未被分配給一個空間，則返回 null。
int body_get_max_contacts_reported(body: RID) const 🔗
返回該實體可以報告的最大接觸數。請參閱 body_set_max_contacts_reported()。
BodyMode body_get_mode(body: RID) const 🔗
回傳物體的模式。
int body_get_object_instance_id(body: RID) const 🔗
返回附加到該實體的 ObjectID。可使用 @GlobalScope.instance_from_id() 從非零 ObjectID 中檢索一個 Object。
Variant body_get_param(body: RID, param: BodyParameter) const 🔗
回傳給定物體參數的取值。
RID body_get_shape(body: RID, shape_idx: int) const 🔗
返回該實體形狀陣列中具有給定索引的形狀的 RID。
int body_get_shape_count(body: RID) const 🔗
返回新增至該物體的形狀的數量。
Transform2D body_get_shape_transform(body: RID, shape_idx: int) const 🔗
返回該區域的形狀陣列中給定索引的形狀的區域變換矩陣。
RID body_get_space(body: RID) const 🔗
回傳分配給該實體的空間的 RID。如果沒有分配空間，則回傳空 RID。
Variant body_get_state(body: RID, state: BodyState) const 🔗
回傳物體給定狀態的取值。
bool body_is_omitting_force_integration(body: RID) const 🔗
如果物體省略了標準力積分，則回傳 true。參見 body_set_omit_force_integration()。
void body_remove_collision_exception(body: RID, excepted_body: RID) 🔗
從物體的碰撞例外清單中移除 excepted_body，不再忽略與該物體的碰撞。
void body_remove_shape(body: RID, shape_idx: int) 🔗
從該實體的形狀陣列中移除具有給定索引的形狀。該形狀本身並沒有被刪除，所以它可以繼續在別處使用或稍後新增回來。該操作將會使曾經索引高於 shape_idx 的實體形狀的索引將減少一個。
void body_reset_mass_properties(body: RID) 🔗
根據實體的形狀恢復該實體的預設慣性和質心。這會復原之前使用 body_set_param() 設定的任何自訂值。
void body_set_axis_velocity(body: RID, axis_velocity: Vector2) 🔗
修改實體的線速度，使其到軸 axis_velocity.normalized() 的投影正好是 axis_velocity.length()。這對於跳躍行為很有用。
void body_set_collision_layer(body: RID, layer: int) 🔗
設定該物體所屬的實體層，使用位元遮罩。
void body_set_collision_mask(body: RID, mask: int) 🔗
設定該物體能夠碰撞的實體層，使用位元遮罩。
void body_set_collision_priority(body: RID, priority: float) 🔗
設定該實體的碰撞優先順序。這用於 body_test_motion() 的穿透階段。優先順序越高，對實體的穿透力就越低。
void body_set_constant_force(body: RID, force: Vector2) 🔗
設定在每次物理更新期間，該物體被施加的總的恒定位置的力。
參閱 body_add_constant_force() 和 body_add_constant_central_force()。
void body_set_constant_torque(body: RID, torque: float) 🔗
設定在每次物理更新期間，該物體被施加的總的恒定旋轉的力。
參閱 body_add_constant_torque()。
void body_set_continuous_collision_detection_mode(body: RID, mode: CCDMode) 🔗
設定連續碰撞檢測模式。
連續碰撞檢測試圖預測一個移動的物體將在物理更新之間發生碰撞的位置，而不是移動它並在發生碰撞時糾正它的運動。
void body_set_force_integration_callback(body: RID, callable: Callable, userdata: Variant = null) 🔗
將物體的自訂力積分回呼函式設定為 callable。使用空的 Callable（Callable()） 清除自訂回呼。
函式 callable 將在標準力積分之前的每個物理刻度被呼叫（參見 body_set_omit_force_integration()）。例如，它可用於根據與其他物體的接觸更新物體的線速度和角速度。
如果 userdata 不為 null，函式 callable 必須採用以下兩個參數：
state：用於檢索和修改物體狀態的 PhysicsDirectBodyState2D，userdata：Variant；其值將是傳遞到該方法的userdata。
如果 userdata 為 null，則 callable 必須僅採用 state 參數。
void body_set_max_contacts_reported(body: RID, amount: int) 🔗
設定該實體可以報告的接觸的最大數量。如果 amount 大於零，那麼實體將最多追蹤與其他實體的這麼多次接觸。
void body_set_mode(body: RID, mode: BodyMode) 🔗
設定物體的模式。
void body_set_omit_force_integration(body: RID, enable: bool) 🔗
設定物體是否省略標準力積分。如果 enable 為 true，物體將不會自動使用施加的力、扭矩和阻尼來更新物體的線速度和角速度。在這種情況下，可以使用 body_set_force_integration_callback() 手動更新線速度和角速度。
當設定屬性 RigidBody2D.custom_integrator 時，將呼叫該方法。
void body_set_param(body: RID, param: BodyParameter, value: Variant) 🔗
設定給定物體參數的取值。
void body_set_shape(body: RID, shape_idx: int, shape: RID) 🔗
用另一個形狀替換給定索引處的實體形狀，同時不會影響同一索引處的 transform、disabled 和單向碰撞屬性。
void body_set_shape_as_one_way_collision(body: RID, shape_idx: int, enable: bool, margin: float, direction: Vector2 = Vector2(0, 1)) 🔗
設定指定索引形狀的單向碰撞屬性。如果 enable 為 true，系統將使用形狀區域空間中的 direction 所給定的單向碰撞方向（即物體區域空間中的 body_get_shape_transform(body, shape_idx).basis_xform(direction).normalized()）來忽略反方向的碰撞，並確保運動學剛體（KinematicBody）在反方向穿透時能朝該方向進行去穿透（depenetration）處理。
void body_set_shape_disabled(body: RID, shape_idx: int, disabled: bool) 🔗
使用給定索引設定實體形狀的停用屬性。如果 disabled 為 true，則在所有碰撞偵測中將忽略該形狀。
void body_set_shape_transform(body: RID, shape_idx: int, transform: Transform2D) 🔗
使用給定索引設定該實體形狀的區域變換矩陣。
void body_set_space(body: RID, space: RID) 🔗
從先前分配的空間（若存在）中移除實體後，將該實體新增到給定空間。如果實體的模式被設定為 BODY_MODE_RIGID，則將該實體新增到空間將具有以下額外效果：
如果從未明確設定參數 BODY_PARAM_CENTER_OF_MASS，則該參數的值將根據實體的形狀重新計算。
如果參數 BODY_PARAM_INERTIA 被設定為一個
<= 0.0的值，則該參數的值將根據實體的形狀、品質、和質心重新計算。
注意：要從一個空間中移除實體，且不立即將其新增回其他地方，請使用 PhysicsServer2D.body_set_space(body, RID())。
void body_set_state(body: RID, state: BodyState, value: Variant) 🔗
設定實體狀態的值。
注意：狀態更改不會立即生效。狀態更改將發生在下一個物理影格上。
void body_set_state_sync_callback(body: RID, callable: Callable) 🔗
將物體的狀態同步回呼函式設定為 callable。清空回呼請使用空的 Callable（Callable()）。
每個物理影格都會呼叫一次 callable 函式，前提是該物件在上一個物理週期中處於活動狀態，並且可以用於從物理伺服器取得最新狀態.
callable 函式的參數如下：
state：型別為 PhysicsDirectBodyState2D，用於取得物體的狀態。
bool body_test_motion(body: RID, parameters: PhysicsTestMotionParameters2D, result: PhysicsTestMotionResult2D = null) 🔗
如果從空間中的給定點，沿著運動向量移動實體會產生一個碰撞，則返回 true。有關可用的運動參數，請參閱 PhysicsTestMotionParameters2D。可以選擇傳遞一個 PhysicsTestMotionResult2D 物件，該物件將用於儲存有關所產生碰撞的資訊。
在物理服務中建立一個 2D 膠囊形狀，並返回標識它的 RID。可使用 shape_set_data() 設定膠囊的高度和半徑。
在物理服務中建立一個 2D 圓形，並返回標識它的 RID。可使用 shape_set_data() 設定圓的半徑。
RID concave_polygon_shape_create() 🔗
在物理服務中建立一個 2D 凹多邊形形狀，並返回標識它的 RID。可使用 shape_set_data() 設定凹多邊形的線段。
RID convex_polygon_shape_create() 🔗
在物理服務中建立一個 2D 凸多邊形形狀，並返回標識它的 RID。可使用 shape_set_data() 設定凸多邊形的點。
float damped_spring_joint_get_param(joint: RID, param: DampedSpringParam) const 🔗
回傳給定阻尼彈簧關節參數的取值。
void damped_spring_joint_set_param(joint: RID, param: DampedSpringParam, value: float) 🔗
設定給定阻尼彈簧關節參數的取值。
銷毀由 PhysicsServer2D 建立的任何物件。如果傳遞的 RID 不是 PhysicsServer2D 可以建立的物件之一，則會將一個錯誤發送到控制台。
int get_process_info(process_info: ProcessInfo) 🔗
回傳由 process_info 指定的物理引擎狀態的取值。
void joint_clear(joint: RID) 🔗
銷毀具有給定 RID 的關節，建立一個新的未初始化關節，並使該 RID 引用這個新關節。
在物理服務中建立一個 2D 關節，並返回標識它的 RID。要設定關節型別，請使用 joint_make_damped_spring()、joint_make_groove() 或 joint_make_pin()。可使用 joint_set_param() 設定通用關節參數。
void joint_disable_collisions_between_bodies(joint: RID, disable: bool) 🔗
設定附加到該 Joint2D 的物體能否互相碰撞。
float joint_get_param(joint: RID, param: JointParam) const 🔗
回傳給定關節參數的取值。
JointType joint_get_type(joint: RID) const 🔗
回傳關節的型別。
bool joint_is_disabled_collisions_between_bodies(joint: RID) const 🔗
返回分配給該 Joint2D 的物體能否相互碰撞。
void joint_make_damped_spring(joint: RID, anchor_a: Vector2, anchor_b: Vector2, body_a: RID, body_b: RID = RID()) 🔗
使該關節成為一個阻尼彈簧關節，連接到實體 body_a 上的點 anchor_a（在全域座標中給出）和實體 body_b 上的點 anchor_b（在全域座標中給出）。要設定特定於阻尼彈簧的參數，請參閱 damped_spring_joint_set_param()。
void joint_make_groove(joint: RID, groove1_a: Vector2, groove2_a: Vector2, anchor_b: Vector2, body_a: RID = RID(), body_b: RID = RID()) 🔗
使關節成為凹槽關節。
void joint_make_pin(joint: RID, anchor: Vector2, body_a: RID, body_b: RID = RID()) 🔗
使關節成為一個銷關節。如果 body_b 是一個空 RID，則 body_a 被固定到點 anchor（在全域座標中給出）； 否則，body_a 在 anchor 點被固定到 body_b（在全域座標中給出）。要設定特定於銷關節的參數，請參閱 pin_joint_set_param()。
void joint_set_param(joint: RID, param: JointParam, value: float) 🔗
設定給定關節參數的取值。
bool pin_joint_get_flag(joint: RID, flag: PinJointFlag) const 🔗
取得釘固關節的標誌。
float pin_joint_get_param(joint: RID, param: PinJointParam) const 🔗
回傳釘固關節參數的取值。
void pin_joint_set_flag(joint: RID, flag: PinJointFlag, enabled: bool) 🔗
設定釘固關節的標誌。
void pin_joint_set_param(joint: RID, param: PinJointParam, value: float) 🔗
設定釘固關節的參數。
RID rectangle_shape_create() 🔗
在物理服務中建立一個 2D 矩形形狀，並返回標識它的 RID。可使用 shape_set_data() 設定該矩形的半邊距。
在物理服務中建立一個 2D 線段形狀，並返回標識它的 RID。可使用 shape_set_data() 設定線段的起點和終點。
RID separation_ray_shape_create() 🔗
在物理服務中建立一個 2D 分離射線形狀，並返回標識它的 RID。可使用 shape_set_data() 設定形狀的 length 和 slide_on_slope 屬性。
void set_active(active: bool) 🔗
啟動或停用 2D 物理服務。如果 active 為 false，則物理服務將不會在其物理步驟中執行任何操作。
Variant shape_get_data(shape: RID) const 🔗
返回定義形狀配置的形狀資料，例如矩形的半邊長或凹形的線段。有關每種情況下該資料的精確格式，請參閱 shape_set_data()。
ShapeType shape_get_type(shape: RID) const 🔗
回傳形狀的型別。
void shape_set_data(shape: RID, data: Variant) 🔗
設定定義形狀設定的形狀資料。要傳遞的 data 取決於形狀的型別（參見 shape_get_type()）：
SHAPE_WORLD_BOUNDARY：長度為 2 的陣列，包含 Vector2 型別的
normal方向和 float 型別的距離d，SHAPE_SEPARATION_RAY：字典，包含鍵
length和 float 值、以及鍵slide_on_slope和 bool 值，SHAPE_SEGMENT：Rect2 型別的
rect，以rect.position表示線段中的第一個點，並以rect.size表示線段中的第二個點，SHAPE_CIRCLE：float 型別的
radius，SHAPE_RECTANGLE：Vector2 型別的
half_extents，SHAPE_CAPSULE：長度為 2 的陣列（或一個 Vector2），包含一個 float 型別的
height和一個 float 型別的radius，SHAPE_CONVEX_POLYGON：按逆時針順序定義凸多邊形的點的 PackedVector2Array（在內部使用由連續點形成的每個線段的順時針向外法線計算）；或一個長度可被 4 整除的 PackedFloat32Array，以便每個 4 元組的 float 包含一個點的座標，後跟一個向量的座標表示，該向量是目前點和下一個點之間的線段的順時針向外法向量，
SHAPE_CONCAVE_POLYGON：長度可被 2 整除的 PackedVector2Array（每對點形成一個線段）。
警告：在 SHAPE_CONVEX_POLYGON 的情況下，該方法不檢查提供的點是否能夠形成凸多邊形（與 CollisionPolygon2D.polygon 屬性不同）。
在物理服務中建立一個 2D 空間，並返回標識它的 RID。空間包含實體和區域，並控制其中實體的物理類比的步驟。
PhysicsDirectSpaceState2D space_get_direct_state(space: RID) 🔗
返回空間的狀態，即 PhysicsDirectSpaceState2D。該對象可用於進行碰撞/相交的查詢。
float space_get_param(space: RID, param: SpaceParameter) const 🔗
回傳給定空間參數的取值。
bool space_is_active(space: RID) const 🔗
如果該空間處於活動狀態，則返回 true。
void space_set_active(space: RID, active: bool) 🔗
啟動或停用該空間。如果 active 為 false，那麼物理服務將不會在它的物理步驟中對這個空間做任何事情。
void space_set_param(space: RID, param: SpaceParameter, value: float) 🔗
設定給定空間參數的取值。
RID world_boundary_shape_create() 🔗
在物理服務中建立一個 2D 世界邊界形狀，並返回標識它的 RID。可使用 shape_set_data() 設定形狀的法線方向和距離屬性。