--- title: "Link de navegação" version: snapshot-2026-10-09 engineGeneration: astra-current language: C# status: source-reviewed reviewedAt: 2026-10-09 appRelease: "0.3.0-preview.20261009" runtimeVerified: false platformEvidence: [] url: https://astraengine.com.br/pt-br/snapshot-2026-10-09/componentes/astra-navigation-link/ --- # Link de navegação Liga dois pontos da malha: salto, escada, vão ou porta **Família:** Navegação · **Grupo:** Malha · **Identificador:** `astra.navigation.link` · **Payload:** 1 :::note[Escopo da evidência] Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho. ::: ## Para que usar Liga dois pontos da malha que não se tocam: vão, salto, escada ou porta. Adicione ao objeto e posicione Início e Fim no espaço dele, cada um a menos do Raio de conexão de uma borda da malha. Área Salto exige que o agente use links e áreas de salto. ## Criar e configurar Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Navegação** / **Malha** → **Link de navegação**. O schema permite múltiplas instâncias no mesmo objeto; identifique a instância antes de editar ou remover. A fachada C# correspondente é [Astra.Components.NavLink](/pt-br/snapshot-2026-10-09/api/astra-components-navlink/). Vários links por objeto são permitidos. Mudanças em Play reconstroem só os tiles das pontas. Nos dois sentidos desligado permite ir só do início ao fim. A travessia é linear; Personagem e pose acompanham a multidão. **Guia relacionado:** [Guia de navegação](/pt-br/snapshot-2026-10-09/sistemas/navegacao/#links) ## Exemplo de uso Com duas plataformas separadas por 4 m, ponha Início a .2 m da borda da primeira e Fim a .2 m da borda da segunda. Um agente com destino na outra plataforma atravessa pelo link e emite link_entered. ## Dependências Nenhuma regra adicional declarada no schema deste componente. ## Conflitos Nenhuma regra adicional declarada no schema deste componente. ## Edição e ciclo de vida | Operação | Contrato | |---|---| | Adicionar/remover em Play | ponto seguro | | Alterar propriedades em Play | ponto seguro | | Múltiplas instâncias | Sim | | Versão do payload | 1 | Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/). ## Propriedades Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto. ### Pontos | Propriedade | Tipo / unidade | Padrão | Domínio | |---|---|---|---| | [**Início X**](#field-start-x)
`start_x` | número · m | 0 | -10000 … 10000 | | [**Início Y**](#field-start-y)
`start_y` | número · m | 0 | -10000 … 10000 | | [**Início Z**](#field-start-z)
`start_z` | número · m | -1 | -10000 … 10000 | | [**Fim X**](#field-end-x)
`end_x` | número · m | 0 | -10000 … 10000 | | [**Fim Y**](#field-end-y)
`end_y` | número · m | 0 | -10000 … 10000 | | [**Fim Z**](#field-end-z)
`end_z` | número · m | 1 | -10000 … 10000 | | [**Raio de conexão**](#field-radius)
`radius` | número · m | 0.5 | 0.05 … 50 |

Início X · start_x

**Onde:** Inspector → **Link de navegação** → **Pontos** → **Início X**. **Uso e efeito:** 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. **Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.

Início Y · start_y

**Onde:** Inspector → **Link de navegação** → **Pontos** → **Início Y**. **Uso e efeito:** Início do link em Y, no espaço do objeto. **Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.

Início Z · start_z

**Onde:** Inspector → **Link de navegação** → **Pontos** → **Início Z**. **Uso e efeito:** Início do link em Z, no espaço do objeto. **Valor:** -1 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.

Fim X · end_x

**Onde:** Inspector → **Link de navegação** → **Pontos** → **Fim X**. **Uso e efeito:** 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. **Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.

Fim Y · end_y

**Onde:** Inspector → **Link de navegação** → **Pontos** → **Fim Y**. **Uso e efeito:** Fim do link em Y, no espaço do objeto. **Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.

Fim Z · end_z

**Onde:** Inspector → **Link de navegação** → **Pontos** → **Fim Z**. **Uso e efeito:** Fim do link em Z, no espaço do objeto. **Valor:** 1 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.

Raio de conexão · radius

**Onde:** Inspector → **Link de navegação** → **Pontos** → **Raio de conexão**. **Uso e efeito:** Distância da malha, em metros, em que cada ponta se conecta. **Valor:** 0.5 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.05 … 50. ### Geral | Propriedade | Tipo / unidade | Padrão | Domínio | |---|---|---|---| | [**Ativo**](#field-enabled)
`enabled` | booleano | verdadeiro | verdadeiro \| falso | | [**Nos dois sentidos**](#field-bidirectional)
`bidirectional` | booleano | verdadeiro | verdadeiro \| falso | | [**Área**](#field-area)
`area` | enumeração | Caminhável | Caminhável \| Salto \| Difícil |

Ativo · enabled

**Onde:** Inspector → **Link de navegação** → **Geral** → **Ativo**. **Uso e efeito:** Desligado remove a conexão da malha; os tiles das pontas são reconstruídos. **Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Nos dois sentidos · bidirectional

**Onde:** Inspector → **Link de navegação** → **Geral** → **Nos dois sentidos**. **Uso e efeito:** Ligado permite atravessar nos dois sentidos; desligado só do início ao fim. **Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Área · area

**Onde:** Inspector → **Link de navegação** → **Geral** → **Área**. **Uso e efeito:** Caminhável, Salto ou Difícil. Salto exige que o agente use links e áreas de salto. **Valor:** Caminhável · **Tipo:** enumeração · **Domínio:** Caminhável \| Salto \| Difícil. ## Roadmap deste componente [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Presente na 0.3.0. Pontas que caem numa fatia de tile muito estreita podem não conectar; posicione-as dentro da malha. Sem data prometida. Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade. ## Conferir na sua cena 1. Crie **Link de navegação** pelo fluxo indicado e resolva as dependências. 2. Altere uma propriedade por vez e observe o efeito esperado na cena. 3. Salve, reabra e confira os valores autorais. 4. Entre em Play e verifique o comportamento com os recursos reais do projeto. 5. Pare o Play e confira a cena autoral. Este é um roteiro de conferência; não representa um teste executado nesta publicação. ## Limitações da referência A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas. **Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/Packages/com.unity.ai.navigation@2.0/manual/NavMeshLink.html). Essa referência não representa paridade funcional.