mirror of
https://github.com/galacean/engine.git
synced 2026-06-20 15:26:09 +08:00
112 lines
6.0 KiB
Plaintext
112 lines
6.0 KiB
Plaintext
---
|
||
order: 3
|
||
title: 碰撞器组件
|
||
type: 物理
|
||
label: Physics
|
||
---
|
||
|
||
引入物理引擎的最大好处是使得场景中的物体拥有了物理响应。碰撞器（[Collider](/apis/core/#Collider)）在引擎中是一种组件，目前有两种，在使用前，我们需要先了解下这两种碰撞器：
|
||
|
||
1. [StaticCollider](/apis/core/#StaticCollider)：静态碰撞器，主要用于场景中静止的物体；
|
||
2. [DynamicCollider](/apis/core/#DynamicCollider)：动态碰撞器，用于场景中需要受到脚本控制，或者响应物理反馈的物体。
|
||
|
||
## 编辑器使用
|
||
|
||
### 添加碰撞器组件
|
||
|
||
为一个物体添加物理组件之前，首先需要考虑的是，碰撞器是静态的还是动态的，然后添加对应的碰撞器组件，静态碰撞器 [StaticCollider](/apis/core/#StaticCollider) 或者 [DynamicCollider](/apis/core/#DynamicCollider)
|
||
|
||
<Image src="https://mdn.alipayobjects.com/huamei_3zduhr/afts/img/A*-E4USbdiH6sAAAAAAAAAAAAADsJ_AQ/original" />
|
||
|
||
### 选择碰撞器的外形
|
||
|
||
之后我们需要为碰撞器组件添加 [ColliderShape](/apis/core/#ColliderShape)，事实上，每一种 `Collider` 都是 [ColliderShape](/apis/core/#ColliderShape) 的集合，即每一种 `Collider` 都可以通过组合 [ColliderShape](/apis/core/#ColliderShape) 设置复合的碰撞器外形。
|
||
|
||
目前支持了四种 `ColliderShape`，但不同的后端物理包支持程度不同，具体如下：
|
||
|
||
| 名称 | 解释 | 支持的后端物理包 |
|
||
| :--- |:---------|:----------------------------|
|
||
| [BoxColliderShape](/apis/core/#BoxColliderShape) | 盒形碰撞外形 | physics-lite， physics-physx |
|
||
| [SphereColliderShape](/apis/core/#SphereColliderShape) | 球形碰撞外形 | physics-lite， physics-physx |
|
||
| [PlaneColliderShape](/apis/core/#PlaneColliderShape) | 无界平面碰撞外形 | physics-physx |
|
||
| [CapsuleColliderShape](/apis/core/#CapsuleColliderShape) | 胶囊碰撞外形 | physics-physx |
|
||
|
||
引擎支持复合的碰撞器外形，也就是说，碰撞器本身可以由 `BoxColliderShape`，`SphereColliderShape`，`CapsuleColliderShape` 复合而成。
|
||
|
||
这里特别强调的是 `Collider` 与 `ColliderShape` 的位置关系。每一个 `Collider` 的姿态和其挂载的 `Entity` 是一致的，每一帧两者都会进行同步。而 `ColliderShape` 上则可以通过 `position` 属性设置 **相对于** `Entity` 的偏移。
|
||
|
||
<Image src="https://mdn.alipayobjects.com/huamei_vvspai/afts/img/A*erlGRKk7dNMAAAAAAAAAAAAADsqFAQ/original" />
|
||
|
||
在加入碰撞器组件后，不会默认添加碰撞器外形，因此需要点击 Add Item 进行添加，添加后会在视口中看到碰撞器的辅助渲染出现。
|
||
|
||
<Image src="https://mdn.alipayobjects.com/huamei_3zduhr/afts/img/A*OUr-SIejEkoAAAAAAAAAAAAADsJ_AQ/original" />
|
||
|
||
对于每一个碰撞器外形，都可以设计对应的一些大小属性。例如
|
||
|
||
<Image src="https://mdn.alipayobjects.com/huamei_3zduhr/afts/img/A*d4MCRbuHeMsAAAAAAAAAAAAADsJ_AQ/original" alt="alt text" style={{ zoom: "67%" }} />
|
||
|
||
无论哪个碰撞器外形，都可以设置 Local Position，即相对于 Entity 坐标的局部偏移
|
||
|
||
<Image src="https://mdn.alipayobjects.com/huamei_3zduhr/afts/img/A*p8UcRJ9Q0EIAAAAAAAAAAAAADsJ_AQ/original" />
|
||
|
||
`ColliderShape` 上还有一个值得注意的属性 `Trigger`，它可以将这个 `ColliderShape` 由 `碰撞器模式` 转为 `触发器模式`。
|
||
|
||
触发器模式：物体不具备刚体外形，但发生接触时可以触发特定的脚本函数。
|
||
碰撞器模式：物理具有刚体外形，发生接触时不仅可以触发脚本函数，还可以根据物理规律改变原先的运动。
|
||
|
||
### 动态碰撞器设置
|
||
和静态碰撞器不同，动态碰撞器会受到物理规律的作用，因此有许多附加的物理属性进行设置
|
||
|
||
<Image src="https://mdn.alipayobjects.com/huamei_3zduhr/afts/img/A*7rzqSKtjULMAAAAAAAAAAAAADsJ_AQ/original" alt="alt text" style={{ zoom: "67%" }} />
|
||
|
||
在修改这些参数后，视口不会发生变化，因为动态碰撞器默认会受到重力的作用，因此需要在`预览模式`下才能进行观察。
|
||
|
||
### 注意
|
||
- 确定的碰撞区域应尽量简单，以提高物理引擎检测的性能
|
||
- 碰撞器的参照坐标系为从属 Entity 的坐标系
|
||
- PlaneColliderShape 表示全平面，因此没有辅助线的显示，一般作为地板使用
|
||
|
||
## 脚本使用
|
||
|
||
### 添加碰撞器
|
||
``` typescript
|
||
// 添加静态碰撞器
|
||
const boxCollider = boxEntity.addComponent(StaticCollider);
|
||
// 添加动态碰撞器
|
||
const sphereCollider = sphereEntity.addComponent(DynamicCollider);
|
||
```
|
||
|
||
### 添加ColliderShape
|
||
``` typescript
|
||
const boxCollider = boxEntity.getComponent(StaticCollider);
|
||
const physicsBox = new BoxColliderShape();
|
||
physicsBox.size = new Vector3(1, 1, 1);
|
||
boxCollider.addShape(physicsBox);
|
||
|
||
//设置 Trigger
|
||
physicsBox.isTrigger = true;
|
||
```
|
||
|
||
针对这两种类型，脚本中都提供了对应的函数
|
||
|
||
### 触发器脚本函数
|
||
|
||
对于触发器模式，首先需要给场景中的 `Entity` 添加 `Collider`；该当这些组件相互接触时，会自动触发脚本组件当中的三个函数：
|
||
|
||
1. [onTriggerEnter](/docs/script/class/#ontriggerenter)：相互接触时调用
|
||
2. [onTriggerStay](/docs/script/class/#ontriggerstay)：接触过程中*循环*调用
|
||
3. [onTriggerExit](/docs/script/class/#ontriggerexit)：接触结束时调用
|
||
|
||
可以通过 `ColliderShape` 上的 `isTrigger` 开启触发器模式，但需要特别强调的是，**两个 StaticCollider 之间不会调用触发器事件**，除非其中一个是 `DynamicCollider`。
|
||
|
||
<Playground href="/embed/physx-collision-detection" />
|
||
|
||
### 碰撞器脚本函数
|
||
|
||
对于碰撞器模式，`DynamicCollider` 相互作用时会触发三个碰撞相关的脚本函数：
|
||
1. [onCollisionEnter](/docs/script/class/#oncollisionenter)：碰撞触发时调用
|
||
2. [onCollisionStay](/docs/script/class/#oncollisionstay)：碰撞过程中*循环*调用
|
||
3. [onCollisionExit](/docs/script/class/#oncollisionexit)：碰撞结束时调用
|
||
|
||
<Playground href="/embed/physx-compound" />
|