---
title: "Astra.Components.Collider"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-collider/
---

# Astra.Components.Collider

Colisor 3D: Volume de contato. Família Física 3D · Formas.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.Collider
```

Colisor 3D: Volume de contato. Família Física 3D · Formas.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-BoxCollider.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.Collider>`.

Consulte também [Colisor 3D](/pt-br/snapshot-2026-10-06/componentes/astra-physics-collider/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-690724be9126c371) | Method |
| [GetCollisionMesh](#member-09d983e04152ca09) | Method |
| [OnCollisionEnter](#member-a2fc8b0fbc9ca6a5) | Method |
| [OnCollisionExit](#member-5bbe06c8a0eb039a) | Method |
| [OnTriggerEnter](#member-c314388bf002cc40) | Method |
| [OnTriggerExit](#member-eccadf83e403abc9) | Method |
| [Remove](#member-178679bfe0310ffc) | Method |
| [SetCollisionMesh](#member-da5de8e7433ab86f) | Method |
| [Wrap](#member-8f4e79f0f39a779b) | Method |
| [ActiveEdgeAngle](#member-1b6a284e722c7698) | Property |
| [Center](#member-899e46de39fa12fb) | Property |
| [Component](#member-5d9d0ccda8cc8d4f) | Property |
| [Convex](#member-c582a7ed9c6ac9a7) | Property |
| [Enabled](#member-3c8e782693cb1f0b) | Property |
| [HalfExtents](#member-2f23e0e8a1a2ecb6) | Property |
| [HalfHeight](#member-b1cbd82f912e1a41) | Property |
| [HullTolerance](#member-58638d4db4147e69) | Property |
| [InstanceId](#member-d673d33d01d78683) | Property |
| [IsAlive](#member-42814b9a138603e4) | Property |
| [MeshLocalPose](#member-a6dee9fbba9674d1) | Property |
| [Object](#member-53be6b39675bba8f) | Property |
| [OptimizeCooking](#member-3016a5a25af55e4e) | Property |
| [Owner](#member-89b86235e04f61c7) | Property |
| [Radius](#member-4d7bd17bde9b61e1) | Property |
| [Rotation](#member-69fd5c64202397e9) | Property |
| [Shape](#member-dc1cfa0e30cfd4f1) | Property |
| [TypeId](#member-492dbc701b4e02fc) | Property |
| [WeldVertices](#member-f6a57db86437f488) | Property |

<h3 id="member-690724be9126c371" class="astra-member">.ctor</h3>

```csharp
public Collider(Astra.Component component)
```

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-09d983e04152ca09" class="astra-member">GetCollisionMesh</h3>

```csharp
public Astra.AssetGuid GetCollisionMesh(uint slot = 0)
```

Malha de colisão. Recurso do projeto por slot

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-a2fc8b0fbc9ca6a5" class="astra-member">OnCollisionEnter</h3>

```csharp
public Astra.ComponentSubscription OnCollisionEnter(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)
```

Colisão: começou. Contato sólido começou; entregue aos dois objetos. Payload: Outro objeto: objeto

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.Behavior` |  |
| `handler` | `System.Action&lt;Astra.ComponentEventArgs&gt;` |  |

<h3 id="member-5bbe06c8a0eb039a" class="astra-member">OnCollisionExit</h3>

```csharp
public Astra.ComponentSubscription OnCollisionExit(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)
```

Colisão: terminou. Contato sólido terminou; entregue aos dois objetos. Payload: Outro objeto: objeto

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.Behavior` |  |
| `handler` | `System.Action&lt;Astra.ComponentEventArgs&gt;` |  |

<h3 id="member-c314388bf002cc40" class="astra-member">OnTriggerEnter</h3>

```csharp
public Astra.ComponentSubscription OnTriggerEnter(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)
```

Sensor: entrou. Outro corpo começou a sobrepor este sensor. Payload: Outro objeto: objeto

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.Behavior` |  |
| `handler` | `System.Action&lt;Astra.ComponentEventArgs&gt;` |  |

<h3 id="member-eccadf83e403abc9" class="astra-member">OnTriggerExit</h3>

```csharp
public Astra.ComponentSubscription OnTriggerExit(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)
```

Sensor: saiu. Outro corpo deixou de sobrepor este sensor. Payload: Outro objeto: objeto

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.Behavior` |  |
| `handler` | `System.Action&lt;Astra.ComponentEventArgs&gt;` |  |

<h3 id="member-178679bfe0310ffc" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

<h3 id="member-da5de8e7433ab86f" class="astra-member">SetCollisionMesh</h3>

```csharp
public void SetCollisionMesh(Astra.AssetGuid value, uint slot = 0)
```

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `value` | `Astra.AssetGuid` |  |
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-8f4e79f0f39a779b" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.Collider Wrap(Astra.Component component)
```

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-1b6a284e722c7698" class="astra-member">ActiveEdgeAngle</h3>

```csharp
public float ActiveEdgeAngle { get; set; }
```

Ângulo de aresta ativa (°). Separa arestas de contato em superfícies com mudança de normal acima deste ângulo.

Faixa válida: 0 a 90.

<h3 id="member-899e46de39fa12fb" class="astra-member">Center</h3>

```csharp
public System.Numerics.Vector3 Center { get; set; }
```

Centro

<h3 id="member-5d9d0ccda8cc8d4f" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

<h3 id="member-c582a7ed9c6ac9a7" class="astra-member">Convex</h3>

```csharp
public bool Convex { get; set; }
```

Convexo. Casco convexo da malha: aceita corpo dinâmico. Desligado usa os triângulos exatos e só vale em corpo estático ou cinemático.

<h3 id="member-3c8e782693cb1f0b" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

<h3 id="member-2f23e0e8a1a2ecb6" class="astra-member">HalfExtents</h3>

```csharp
public System.Numerics.Vector3 HalfExtents { get; set; }
```

Meia extensão

<h3 id="member-b1cbd82f912e1a41" class="astra-member">HalfHeight</h3>

```csharp
public float HalfHeight { get; set; }
```

Meia altura cilíndrica

Faixa válida: 0.01 a 10000.

<h3 id="member-58638d4db4147e69" class="astra-member">HullTolerance</h3>

```csharp
public float HullTolerance { get; set; }
```

Tolerância do casco (u). Pontos até esta distância podem ficar fora do casco; valores maiores geram cascos mais simples.

Faixa válida: 0.00001 a 1.

<h3 id="member-d673d33d01d78683" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

<h3 id="member-42814b9a138603e4" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

<h3 id="member-a6dee9fbba9674d1" class="astra-member">MeshLocalPose</h3>

```csharp
public bool MeshLocalPose { get; set; }
```

Pose local da malha. Aplica centro e rotação locais à geometria física; não altera a malha visual. Desligado mantém a pose legada do objeto.

<h3 id="member-53be6b39675bba8f" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

<h3 id="member-3016a5a25af55e4e" class="astra-member">OptimizeCooking</h3>

```csharp
public bool OptimizeCooking { get; set; }
```

Otimizar para o jogo. Constrói uma árvore de busca mais eficiente; desligue para cozinhar mais rápido durante iterações.

<h3 id="member-89b86235e04f61c7" class="astra-member">Owner</h3>

```csharp
public Astra.ObjectReference Owner { get; set; }
```

Corpo proprietário

<h3 id="member-4d7bd17bde9b61e1" class="astra-member">Radius</h3>

```csharp
public float Radius { get; set; }
```

Raio

Faixa válida: 0.01 a 10000.

<h3 id="member-69fd5c64202397e9" class="astra-member">Rotation</h3>

```csharp
public System.Numerics.Vector3 Rotation { get; set; }
```

Rotação

<h3 id="member-dc1cfa0e30cfd4f1" class="astra-member">Shape</h3>

```csharp
public Astra.Components.Collider.ShapeOption Shape { get; set; }
```

Forma

<h3 id="member-492dbc701b4e02fc" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

<h3 id="member-f6a57db86437f488" class="astra-member">WeldVertices</h3>

```csharp
public bool WeldVertices { get; set; }
```

Soldar vértices iguais. Compartilha vértices coincidentes antes de criar a malha física, reduzindo costuras internas.