--- title: "Astra.Components.NavLink" 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-navlink/ --- # Astra.Components.NavLink Link de navegação: Liga dois pontos da malha: salto, escada, vão ou porta. 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.NavLink ``` Link de navegação: Liga dois pontos da malha: salto, escada, vão ou porta. Família Navegação · Malha. Referência estudada: https://docs.unity3d.com/Packages/com.unity.ai.navigation@2.0/manual/NavMeshLink.html **Interfaces:** `Astra.Components.IComponentFacade`. ## Onde acessar este tipo Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Navegação** / **Malha** → **Link 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 NavLink(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 [Link de navegação](/pt-br/snapshot-2026-10-09/componentes/astra-navigation-link/) para propriedades, valores iniciais, requisitos e edição em Play. ## Membros | Membro | Categoria | |---|---| | [.ctor](#member-5943f8ba21fbea1f) | Method | | [Remove](#member-38b0b5364982c9d3) | Method | | [Wrap](#member-9ea15e8313d14d04) | Method | | [Area](#member-a8333735fe6020f1) | Property | | [Bidirectional](#member-c4a640f0c7272cc7) | Property | | [Component](#member-6cd5e9e7426dbd2c) | Property | | [Enabled](#member-c1d38792a0df0b58) | Property | | [End](#member-adb09d14a43e28df) | Property | | [InstanceId](#member-de0eb51a5e6751ac) | Property | | [IsAlive](#member-7a7ccaf7733519fc) | Property | | [Object](#member-cd26c878955fa21b) | Property | | [Radius](#member-3ef152adffbf9c66) | Property | | [Start](#member-90800efb4802a1fe) | Property | | [TypeId](#member-90cd21259b5c9778) | Property |

.ctor

```csharp public NavLink(Astra.Component component) ``` **Caminho:** Inspector → Link 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 → Link 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.NavLink Wrap(Astra.Component component) ``` **Caminho:** Inspector → Link 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` | |

Area

```csharp public Astra.Components.NavLink.AreaOption Area { get; set; } ``` Área. Salto exige que o agente use links e áreas de salto **Caminho:** Inspector → Link de navegação → Geral; ou fachada C# em um Behavior. **Uso:** **Área:** Caminhável, Salto ou Difícil. Salto exige que o agente use links e áreas de salto. **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.

Bidirectional

```csharp public bool Bidirectional { get; set; } ``` Nos dois sentidos. Desligado só vai do início para o fim **Caminho:** Inspector → Link de navegação → Geral; ou fachada C# em um Behavior. **Uso:** **Nos dois sentidos:** Ligado permite atravessar nos dois sentidos; desligado só do início ao fim. **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 → Link 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.

Enabled

```csharp public bool Enabled { get; set; } ``` Ativo. Desligado remove a conexão da malha **Caminho:** Inspector → Link de navegação → Geral; ou fachada C# em um Behavior. **Uso:** **Ativo:** Desligado remove a conexão da malha; os tiles das pontas são reconstruídos. **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.

End

```csharp public System.Numerics.Vector3 End { get; set; } ``` Fim **Caminho:** Inspector → Link de navegação → Pontos; ou fachada C# em um Behavior. **Uso:** **Fim X:** Fim do link em X, no espaço do objeto, em metros. Deve ficar a menos do Raio de conexão de uma borda da malha. **Fim Y:** Fim do link em Y, no espaço do objeto. **Fim Z:** Fim do link em Z, no espaço do objeto. **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 → Link 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 → Link 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.

Object

```csharp public Astra.GameObject Object { get; } ``` **Caminho:** Inspector → Link 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.

Radius

```csharp public float Radius { get; set; } ``` Raio de conexão (m). Distância da malha em que cada ponta se conecta Faixa válida: 0.05 a 50. **Caminho:** Inspector → Link de navegação → Pontos; ou fachada C# em um Behavior. **Uso:** **Raio de conexão:** Distância da malha, em metros, em que cada ponta se conecta. **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.

Start

```csharp public System.Numerics.Vector3 Start { get; set; } ``` Início **Caminho:** Inspector → Link de navegação → Pontos; ou fachada C# em um Behavior. **Uso:** **Início X:** Início do link em X, no espaço do objeto, em metros. Deve ficar a menos do Raio de conexão de uma borda da malha. **Início Y:** Início do link em Y, no espaço do objeto. **Início Z:** Início do link em Z, no espaço do objeto. **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 → Link 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.