--- title: "Astra.Components.PhysicsEventConnection3D" 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-physicseventconnection3d/ --- # Astra.Components.PhysicsEventConnection3D Conexão física 3D: Evento de sensor/contato altera a ativação de um receptor. Família Física 3D · 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.PhysicsEventConnection3D ``` Conexão física 3D: Evento de sensor/contato altera a ativação de um receptor. Família Física 3D · Eventos. Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_area3d.html **Interfaces:** `Astra.Components.IComponentFacade`. ## Onde acessar este tipo Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Eventos** → **Conexão física 3D**. 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 PhysicsEventConnection3D(component)` envolve um componente existente; não adiciona um componente à cena. ## Roadmap e uso [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): 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 3D](/pt-br/snapshot-2026-10-06/componentes/astra-physics-event-connection/) para propriedades, valores iniciais, requisitos e edição em Play. ## Membros | Membro | Categoria | |---|---| | [.ctor](#member-ca37a65f9e3f8eef) | Method | | [Remove](#member-d25be4739b1e7c1a) | Method | | [Wrap](#member-08c79630f5a2af94) | Method | | [Action](#member-9ba30386586bbb88) | Property | | [Component](#member-dd823713e3755050) | Property | | [Enabled](#member-c9866e33b7e8f937) | Property | | [Event](#member-95d7e849e6cf7c71) | Property | | [InstanceId](#member-0e73efd4f13589da) | Property | | [IsAlive](#member-3415c247652c30c5) | Property | | [Object](#member-306f92f75a0980c1) | Property | | [OtherFilter](#member-d8be0b95f01a87aa) | Property | | [Receiver](#member-3f87eb947d4b10c9) | Property | | [TypeId](#member-2774c26de2ce2dba) | Property |

.ctor

```csharp public PhysicsEventConnection3D(Astra.Component component) ``` **Caminho:** Inspector → Conexão física 3D; 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 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). 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 3D; 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 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Wrap

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

Action

```csharp public Astra.Components.PhysicsEventConnection3D.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 3D → 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 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). 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 3D; 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 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). 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 3D → 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 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Event

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

InstanceId

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

IsAlive

```csharp public bool IsAlive { get; } ``` **Caminho:** Inspector → Conexão física 3D; 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 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). 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 3D; ou fachada C# em um Behavior. **Uso:** Objeto dono deste componente; use para resolver composição. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). 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 3D → 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 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). 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 3D → Conexão; ou fachada C# em um Behavior. **Uso:** **Receptor:** Objeto cuja ativação será alterada **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). 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 3D; ou fachada C# em um Behavior. **Uso:** Identificador nativo usado em AddComponent/GetComponent. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.