--- title: "Astra.Components.NavModifier" version: snapshot-2026-10-09 engineGeneration: astra-current language: C# status: semantic-reference reviewedAt: 2026-10-09 appRelease: "0.3.0-preview.20261009" runtimeVerified: false platformEvidence: [] url: https://astraengine.com.br/pt-br/snapshot-2026-10-09/api/astra-components-navmodifier/ --- # Astra.Components.NavModifier Modificador de navegação: Muda a área dos colisores deste objeto no bake ou os ignora. Família Navegação · Malha. **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.NavModifier ``` Modificador de navegação: Muda a área dos colisores deste objeto no bake ou os ignora. Família Navegação · Malha. Referência estudada: https://docs.unity3d.com/Packages/com.unity.ai.navigation@2.0/manual/NavMeshModifier.html **Interfaces:** `Astra.Components.IComponentFacade`. ## Onde acessar este tipo Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Navegação** / **Malha** → **Modificador de navegação**. 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 NavModifier(component)` envolve um componente existente; não adiciona um componente à cena. ## Roadmap e uso [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/): 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 [Modificador de navegação](/pt-br/snapshot-2026-10-09/componentes/astra-navigation-modifier/) para propriedades, valores iniciais, requisitos e edição em Play. ## Membros | Membro | Categoria | |---|---| | [.ctor](#member-b9279e56c891bcb9) | Method | | [Remove](#member-dd7dc9b378038bd2) | Method | | [Wrap](#member-54f49288dcabca08) | Method | | [ApplyToChildren](#member-52e3381611cf2b10) | Property | | [Area](#member-d06e9269af66d9ee) | Property | | [Component](#member-b4452d1742409967) | Property | | [InstanceId](#member-e79d7a15e51395e7) | Property | | [IsAlive](#member-8176a9f72f79d8cb) | Property | | [Mode](#member-6b6db0d0ded5b7ba) | Property | | [Object](#member-2037b2eb6bff8a42) | Property | | [TypeId](#member-93d2f15a67b26c59) | Property |

.ctor

```csharp public NavModifier(Astra.Component component) ``` **Caminho:** Inspector → Modificador de navegação; 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:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). 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 → Modificador de navegação; ou fachada C# em um Behavior. **Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar. **Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Wrap

```csharp public static Astra.Components.NavModifier Wrap(Astra.Component component) ``` **Caminho:** Inspector → Modificador de navegação; ou fachada C# em um Behavior. **Uso:** Envolve um Component existente após conferir TypeId; não cria componente. **Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência. | Parâmetro | Tipo | Contrato | |---|---|---| | `component` | `Astra.Component` | |

ApplyToChildren

```csharp public bool ApplyToChildren { get; set; } ``` Aplicar aos filhos. Filhos sem modificador próprio herdam este **Caminho:** Inspector → Modificador de navegação → Geral; ou fachada C# em um Behavior. **Uso:** **Aplicar aos filhos:** Filhos sem modificador próprio herdam esta regra no bake. **Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Area

```csharp public Astra.Components.NavModifier.AreaOption Area { get; set; } ``` Área. Área do chão destes colisores na malha **Caminho:** Inspector → Modificador de navegação → Geral; ou fachada C# em um Behavior. **Uso:** **Área:** Área do chão destes colisores: Caminhável, Não caminhável (buraco), Salto ou Difícil. **Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Component

```csharp public Astra.Component Component { get; } ``` **Caminho:** Inspector → Modificador de navegação; 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:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

InstanceId

```csharp public ulong InstanceId { get; } ``` **Caminho:** Inspector → Modificador de navegação; ou fachada C# em um Behavior. **Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos. **Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

IsAlive

```csharp public bool IsAlive { get; } ``` **Caminho:** Inspector → Modificador de navegação; 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:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Mode

```csharp public Astra.Components.NavModifier.ModeOption Mode { get; set; } ``` Modo. Ignorar tira os colisores do bake **Caminho:** Inspector → Modificador de navegação → Geral; ou fachada C# em um Behavior. **Uso:** **Modo:** Alterar área muda o chão destes colisores; Ignorar no bake os tira da malha. **Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Object

```csharp public Astra.GameObject Object { get; } ``` **Caminho:** Inspector → Modificador de navegação; ou fachada C# em um Behavior. **Uso:** Objeto dono deste componente; use para resolver composição. **Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

TypeId

```csharp public static string TypeId { get; } ``` **Caminho:** Inspector → Modificador de navegação; ou fachada C# em um Behavior. **Uso:** Identificador nativo usado em AddComponent/GetComponent. **Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.