--- title: "Astra.Components.PhysicsEventConnection2D" version: snapshot-2026-10-07 engineGeneration: astra-current language: C# status: semantic-reference reviewedAt: 2026-10-07 appRelease: "0.2.3-preview.20261007" runtimeVerified: false platformEvidence: [] url: https://astraengine.com.br/pt-br/snapshot-2026-10-07/api/astra-components-physicseventconnection2d/ --- # Astra.Components.PhysicsEventConnection2D Conexão física 2D: Evento real de sensor/contato 2D altera ativação do receptor. Família Física 2D · Eventos. **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.PhysicsEventConnection2D ``` Conexão física 2D: Evento real de sensor/contato 2D altera ativação do receptor. Família Física 2D · Eventos. Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_area2d.html **Interfaces:** `Astra.Components.IComponentFacade`. ## Onde acessar este tipo Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Eventos** → **Conexão física 2D**. No Behavior em Play, obtenha a fachada com `Object.GetComponent()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new PhysicsEventConnection2D(component)` envolve um componente existente; não adiciona um componente à cena. ## Roadmap e uso [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente. Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/). Consulte também [Conexão física 2D](/pt-br/snapshot-2026-10-07/componentes/astra-physics2d-event-connection/) para propriedades, valores iniciais, requisitos e edição em Play. ## Membros | Membro | Categoria | |---|---| | [.ctor](#member-f2d6d26367c60577) | Method | | [Remove](#member-2accdb6ae7e7601d) | Method | | [Wrap](#member-d1e6877c1f45705c) | Method | | [Action](#member-a233907df0e3ec86) | Property | | [Component](#member-545ab22bc39fe0dc) | Property | | [Enabled](#member-387b832aa365b6d8) | Property | | [Event](#member-771d47cbd200dace) | Property | | [InstanceId](#member-45f17238653612fc) | Property | | [IsAlive](#member-78b111ada0b16ca2) | Property | | [Object](#member-358c08ded0fbead3) | Property | | [OtherFilter](#member-50f22aa58c71e1c8) | Property | | [Receiver](#member-2a487b2fa591b0a8) | Property | | [TypeId](#member-471ff378f288d7b8) | Property |

.ctor

```csharp public PhysicsEventConnection2D(Astra.Component component) ``` **Caminho:** Inspector → Conexão física 2D; ou fachada C# em um Behavior. **Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência. | Parâmetro | Tipo | Contrato | |---|---|---| | `component` | `Astra.Component` | |

Remove

```csharp public void Remove() ``` Remove a instância pelo ciclo nativo; dependências e ownership podem recusar. **Caminho:** Inspector → Conexão física 2D; ou fachada C# em um Behavior. **Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Wrap

```csharp public static Astra.Components.PhysicsEventConnection2D Wrap(Astra.Component component) ``` **Caminho:** Inspector → Conexão física 2D; ou fachada C# em um Behavior. **Uso:** Envolve um Component existente após conferir TypeId; não cria componente. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência. | Parâmetro | Tipo | Contrato | |---|---|---| | `component` | `Astra.Component` | |

Action

```csharp public Astra.Components.PhysicsEventConnection2D.ActionOption Action { get; set; } ``` Ação. Executada antes do callback C#; permanência pode disparar a cada passo físico **Caminho:** Inspector → Conexão física 2D → Conexão; ou fachada C# em um Behavior. **Uso:** **Ação:** Executada antes do callback C#; permanência pode disparar a cada passo físico **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Component

```csharp public Astra.Component Component { get; } ``` **Caminho:** Inspector → Conexão física 2D; ou fachada C# em um Behavior. **Uso:** Handle genérico da instância, usado para operações de reflexão e recursos. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Enabled

```csharp public bool Enabled { get; set; } ``` Ativa **Caminho:** Inspector → Conexão física 2D → Conexão; ou fachada C# em um Behavior. **Uso:** **Ativa:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Event

```csharp public Astra.Components.PhysicsEventConnection2D.EventOption Event { get; set; } ``` Evento. Sensor exige um Colisor 2D sensor; contato exige uma forma sólida no emissor **Caminho:** Inspector → Conexão física 2D → Conexão; ou fachada C# em um Behavior. **Uso:** **Evento:** Sensor exige um Colisor 2D sensor; contato exige uma forma sólida no emissor **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

InstanceId

```csharp public ulong InstanceId { get; } ``` **Caminho:** Inspector → Conexão física 2D; ou fachada C# em um Behavior. **Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

IsAlive

```csharp public bool IsAlive { get; } ``` **Caminho:** Inspector → Conexão física 2D; ou fachada C# em um Behavior. **Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Object

```csharp public Astra.GameObject Object { get; } ``` **Caminho:** Inspector → Conexão física 2D; ou fachada C# em um Behavior. **Uso:** Objeto dono deste componente; use para resolver composição. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

OtherFilter

```csharp public Astra.ObjectReference OtherFilter { get; set; } ``` Outro objeto. Opcional: somente eventos com este outro objeto; vazio aceita todos **Caminho:** Inspector → Conexão física 2D → Filtro; ou fachada C# em um Behavior. **Uso:** **Outro objeto:** Opcional: somente eventos com este outro objeto; vazio aceita todos **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Receiver

```csharp public Astra.ObjectReference Receiver { get; set; } ``` Receptor. Objeto cuja ativação será alterada **Caminho:** Inspector → Conexão física 2D → Conexão; ou fachada C# em um Behavior. **Uso:** **Receptor:** Objeto cuja ativação será alterada **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

TypeId

```csharp public static string TypeId { get; } ``` **Caminho:** Inspector → Conexão física 2D; ou fachada C# em um Behavior. **Uso:** Identificador nativo usado em AddComponent/GetComponent. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.