--- title: "Astra.Components.ComponentFacadeExtensions" 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-componentfacadeextensions/ --- # Astra.Components.ComponentFacadeExtensions Acesso tipado a partir do objeto: obj.GetComponent(). **Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Class :::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 class Astra.Components.ComponentFacadeExtensions ``` Acesso tipado a partir do objeto: obj.GetComponent<PhysicsBody>(). ## Onde acessar este tipo Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados. ## Roadmap e uso [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): 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/). ## Membros | Membro | Categoria | |---|---| | [AddComponent](#member-a15aa8676781d341) | Method | | [GetComponent](#member-addff634d5b39ca8) | Method | | [HasComponent](#member-a2dd18f5e35b1890) | Method |

AddComponent

```csharp public static T AddComponent(Astra.GameObject owner) where T : struct, Astra.Components.IComponentFacade ``` **Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”. **Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome. **Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência. | Parâmetro | Tipo | Contrato | |---|---|---| | `owner` | `Astra.GameObject` | |

GetComponent

```csharp public static T? GetComponent(Astra.GameObject owner, int ordinal = 0) where T : struct, Astra.Components.IComponentFacade ``` **Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”. **Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome. **Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência. | Parâmetro | Tipo | Contrato | |---|---|---| | `owner` | `Astra.GameObject` | | | `ordinal` | `int` | · Opcional: `0` |

HasComponent

```csharp public static bool HasComponent(Astra.GameObject owner) where T : struct, Astra.Components.IComponentFacade ``` **Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”. **Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome. **Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência. | Parâmetro | Tipo | Contrato | |---|---|---| | `owner` | `Astra.GameObject` | |