---
title: "Astra.Components.NavAgent"
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-navagent/
---

# Astra.Components.NavAgent

Agente de navegação: Anda pela malha até um destino, desviando de outros agentes. Família Navegação · Movimento.

**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.NavAgent
```

Agente de navegação: Anda pela malha até um destino, desviando de outros agentes. Família Navegação · Movimento.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-NavMeshAgent.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.NavAgent>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Navegação** / **Movimento** → **Agente de navegação**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<NavAgent>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new NavAgent(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 [Agente de navegação](/pt-br/snapshot-2026-10-09/componentes/astra-navigation-agent/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-6105985ef68ce348) | Method |
| [HasPath](#member-20e0e27c9ec06024) | Method |
| [IsOnLink](#member-81fff2381190255d) | Method |
| [OnDestinationReached](#member-8ed59b529c1a0cfd) | Method |
| [OnLinkEntered](#member-5e2a8a80e9834a83) | Method |
| [OnPathFailed](#member-8e4475766da704a4) | Method |
| [PathStatus](#member-455d7c2ef95ddc01) | Method |
| [RemainingDistance](#member-f5727de1984f9d4c) | Method |
| [Remove](#member-c94497c1ca2b5da6) | Method |
| [Resume](#member-5c5cc2a0d8cab48e) | Method |
| [SetDestination](#member-070c58373ebb6686) | Method |
| [Stop](#member-59d46f0cd248ab92) | Method |
| [Velocity](#member-4f07c90b134f8e7e) | Method |
| [Warp](#member-c7674061d2dfce5d) | Method |
| [Wrap](#member-d1c6f3b0c2b6f288) | Method |
| [Acceleration](#member-6d22c59bcbc0f6a2) | Property |
| [AngularSpeed](#member-f499ccbbc61e47de) | Property |
| [AutoBraking](#member-87f5918f850283d1) | Property |
| [Avoidance](#member-8646250d04eb0048) | Property |
| [BaseOffset](#member-9acc1c234564f12d) | Property |
| [Component](#member-6cd6691e3d99de02) | Property |
| [DifficultCost](#member-273d5aa3ae9b93d2) | Property |
| [Enabled](#member-99a6d3bb2728e35c) | Property |
| [Height](#member-615aaf5ffca3d444) | Property |
| [InstanceId](#member-09d709f6236442e3) | Property |
| [IsAlive](#member-1efcb27cac47db94) | Property |
| [JumpCost](#member-474108469123d968) | Property |
| [Object](#member-1ac7568901924c12) | Property |
| [Radius](#member-76d6c3e9c5790751) | Property |
| [RepathDistance](#member-7ae2ffa8a70bd0c0) | Property |
| [Speed](#member-638126ec50396b2b) | Property |
| [StoppingDistance](#member-f13552b0e1310bd4) | Property |
| [Surface](#member-c9adf69db8a3273b) | Property |
| [Target](#member-302848fbc9b49535) | Property |
| [TypeId](#member-3a7f1077285ff2fc) | Property |
| [UpdateRotation](#member-c2b8e4bd0f017b54) | Property |
| [UseDifficult](#member-559fa6576feeb5eb) | Property |
| [UseJump](#member-dd0013f5976914fc) | Property |

<h3 id="member-6105985ef68ce348" class="astra-member">.ctor</h3>

```csharp
public NavAgent(Astra.Component component)
```

**Caminho:** Inspector → Agente 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` |  |

<h3 id="member-20e0e27c9ec06024" class="astra-member">HasPath</h3>

```csharp
public bool HasPath()
```

Tem caminho. Verdadeiro enquanto há um destino válido

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Agente de navegação; ou fachada C# em um Behavior.

**Uso:** Tem caminho. Verdadeiro enquanto há um destino válido

**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.

<h3 id="member-81fff2381190255d" class="astra-member">IsOnLink</h3>

```csharp
public bool IsOnLink()
```

Em link. Verdadeiro durante a travessia de um Link

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Agente de navegação; ou fachada C# em um Behavior.

**Uso:** Em link. Verdadeiro durante a travessia de um Link

**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.

<h3 id="member-8ed59b529c1a0cfd" class="astra-member">OnDestinationReached</h3>

```csharp
public Astra.ComponentSubscription OnDestinationReached(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)
```

Chegou. Emitido uma vez quando o caminho restante fica abaixo da distância de parada

**Caminho:** Inspector → Agente de navegação; ou fachada C# em um Behavior.

**Uso:** Chegou. Emitido uma vez quando o caminho restante fica abaixo da distância de parada

**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 |
|---|---|---|
| `owner` | `Astra.Behavior` |  |
| `handler` | `System.Action&lt;Astra.ComponentEventArgs&gt;` |  |

<h3 id="member-5e2a8a80e9834a83" class="astra-member">OnLinkEntered</h3>

```csharp
public Astra.ComponentSubscription OnLinkEntered(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)
```

Entrou no link. Emitido quando o agente começa a atravessar um Link

**Caminho:** Inspector → Agente de navegação; ou fachada C# em um Behavior.

**Uso:** Entrou no link. Emitido quando o agente começa a atravessar um Link

**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 |
|---|---|---|
| `owner` | `Astra.Behavior` |  |
| `handler` | `System.Action&lt;Astra.ComponentEventArgs&gt;` |  |

<h3 id="member-8e4475766da704a4" class="astra-member">OnPathFailed</h3>

```csharp
public Astra.ComponentSubscription OnPathFailed(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)
```

Caminho falhou. Emitido quando o destino não tem caminho

**Caminho:** Inspector → Agente de navegação; ou fachada C# em um Behavior.

**Uso:** Caminho falhou. Emitido quando o destino não tem caminho

**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 |
|---|---|---|
| `owner` | `Astra.Behavior` |  |
| `handler` | `System.Action&lt;Astra.ComponentEventArgs&gt;` |  |

<h3 id="member-455d7c2ef95ddc01" class="astra-member">PathStatus</h3>

```csharp
public long PathStatus()
```

Estado do caminho. 0 sem caminho, 1 completo, 2 parcial, 3 inválido

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Agente de navegação; ou fachada C# em um Behavior.

**Uso:** Estado do caminho. 0 sem caminho, 1 completo, 2 parcial, 3 inválido

**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.

<h3 id="member-f5727de1984f9d4c" class="astra-member">RemainingDistance</h3>

```csharp
public double RemainingDistance()
```

Distância restante. Comprimento do caminho até o destino; infinito sem caminho

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Agente de navegação; ou fachada C# em um Behavior.

**Uso:** Distância restante. Comprimento do caminho até o destino; infinito sem caminho

**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.

<h3 id="member-c94497c1ca2b5da6" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Agente 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.

<h3 id="member-5c5cc2a0d8cab48e" class="astra-member">Resume</h3>

```csharp
public void Resume()
```

Retomar. Volta ao último destino depois de Parar

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Agente de navegação; ou fachada C# em um Behavior.

**Uso:** Retomar. Volta ao último destino depois de Parar

**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.

<h3 id="member-070c58373ebb6686" class="astra-member">SetDestination</h3>

```csharp
public bool SetDestination(System.Numerics.Vector3 point)
```

Ir para. Calcula o caminho e começa a andar; falso quando o ponto está longe da malha

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Agente de navegação; ou fachada C# em um Behavior.

**Uso:** Ir para. Calcula o caminho e começa a andar; falso quando o ponto está longe 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.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `point` | `System.Numerics.Vector3` |  |

<h3 id="member-59d46f0cd248ab92" class="astra-member">Stop</h3>

```csharp
public void Stop()
```

Parar. Para no lugar e guarda o destino para Retomar

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Agente de navegação; ou fachada C# em um Behavior.

**Uso:** Parar. Para no lugar e guarda o destino para Retomar

**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.

<h3 id="member-4f07c90b134f8e7e" class="astra-member">Velocity</h3>

```csharp
public System.Numerics.Vector3 Velocity()
```

Velocidade. Velocidade pedida pela multidão neste quadro

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Agente de navegação; ou fachada C# em um Behavior.

**Uso:** Velocidade. Velocidade pedida pela multidão neste quadro

**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.

<h3 id="member-c7674061d2dfce5d" class="astra-member">Warp</h3>

```csharp
public bool Warp(System.Numerics.Vector3 point)
```

Teleportar. Move o objeto e o agente para o ponto mais próximo da malha

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Agente de navegação; ou fachada C# em um Behavior.

**Uso:** Teleportar. Move o objeto e o agente para o ponto mais próximo 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.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `point` | `System.Numerics.Vector3` |  |

<h3 id="member-d1c6f3b0c2b6f288" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.NavAgent Wrap(Astra.Component component)
```

**Caminho:** Inspector → Agente 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` |  |

<h3 id="member-6d22c59bcbc0f6a2" class="astra-member">Acceleration</h3>

```csharp
public float Acceleration { get; set; }
```

Aceleração (m/s²)

Faixa válida: 0 a 1000.

**Caminho:** Inspector → Agente de navegação → Movimento; ou fachada C# em um Behavior.

**Uso:** **Aceleração:** Quanto a velocidade pode mudar por segundo, em m/s². Também limita a frenagem ao chegar.

**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.

<h3 id="member-f499ccbbc61e47de" class="astra-member">AngularSpeed</h3>

```csharp
public float AngularSpeed { get; set; }
```

Giro (°/s). Velocidade de giro para a direção do movimento

Faixa válida: 0 a 3600.

**Caminho:** Inspector → Agente de navegação → Movimento; ou fachada C# em um Behavior.

**Uso:** **Giro:** Velocidade de giro, em graus/s, para virar o objeto na direção do movimento (Personagem e própria pose).

**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.

<h3 id="member-87f5918f850283d1" class="astra-member">AutoBraking</h3>

```csharp
public bool AutoBraking { get; set; }
```

Frear ao chegar. Desacelera perto do destino; desligado mantém a velocidade até a distância de parada

**Caminho:** Inspector → Agente de navegação → Movimento; ou fachada C# em um Behavior.

**Uso:** **Frear ao chegar:** Desacelera antes do destino para parar na distância de parada. Desligado mantém a velocidade até chegar.

**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.

<h3 id="member-8646250d04eb0048" class="astra-member">Avoidance</h3>

```csharp
public Astra.Components.NavAgent.AvoidanceOption Avoidance { get; set; }
```

Desvio de agentes. Qualidade da amostragem de velocidades contra outros agentes

**Caminho:** Inspector → Agente de navegação → Corpo; ou fachada C# em um Behavior.

**Uso:** **Desvio de agentes:** Qualidade do desvio entre agentes: Nenhum desliga; Alto amostra mais velocidades e custa mais.

**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.

<h3 id="member-9acc1c234564f12d" class="astra-member">BaseOffset</h3>

```csharp
public float BaseOffset { get; set; }
```

Deslocamento da base (m). Altura do pivô acima da malha quando o agente move o próprio objeto

Faixa válida: -100 a 100.

**Caminho:** Inspector → Agente de navegação → Corpo; ou fachada C# em um Behavior.

**Uso:** **Deslocamento da base:** Altura do pivô acima da malha, em metros, quando o agente move a própria pose.

**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.

<h3 id="member-6cd6691e3d99de02" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Agente 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.

<h3 id="member-273d5aa3ae9b93d2" class="astra-member">DifficultCost</h3>

```csharp
public float DifficultCost { get; set; }
```

Custo da área difícil (×). Multiplica o comprimento percorrido nessa área

Faixa válida: 1 a 1000.

**Caminho:** Inspector → Agente de navegação → Áreas; ou fachada C# em um Behavior.

**Uso:** **Custo da área difícil:** Multiplicador do custo da área Difícil. Com 1 atravessa; valores altos contornam.

**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.

<h3 id="member-99a6d3bb2728e35c" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo. Desligado sai da multidão e para de mover o objeto

**Caminho:** Inspector → Agente de navegação → Geral; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Desligado sai da multidão e para de mover o objeto; o destino guardado continua no Play.

**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.

<h3 id="member-615aaf5ffca3d444" class="astra-member">Height</h3>

```csharp
public float Height { get; set; }
```

Altura (m)

Faixa válida: 0.05 a 100.

**Caminho:** Inspector → Agente de navegação → Corpo; ou fachada C# em um Behavior.

**Uso:** **Altura:** Altura do agente para o desvio, em metros.

**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.

<h3 id="member-09d709f6236442e3" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Agente 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.

<h3 id="member-1efcb27cac47db94" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Agente 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.

<h3 id="member-474108469123d968" class="astra-member">JumpCost</h3>

```csharp
public float JumpCost { get; set; }
```

Custo do salto (×)

Faixa válida: 1 a 1000.

**Caminho:** Inspector → Agente de navegação → Áreas; ou fachada C# em um Behavior.

**Uso:** **Custo do salto:** Multiplicador do custo de links e áreas de Salto. Maior faz o caminho evitar saltos quando há alternativa.

**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.

<h3 id="member-1ac7568901924c12" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Agente 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.

<h3 id="member-76d6c3e9c5790751" class="astra-member">Radius</h3>

```csharp
public float Radius { get; set; }
```

Raio (m). Usado no desvio entre agentes

Faixa válida: 0.05 a 50.

**Caminho:** Inspector → Agente de navegação → Corpo; ou fachada C# em um Behavior.

**Uso:** **Raio:** Raio usado no desvio entre agentes, em metros. Não altera a malha assada; use o raio da Superfície para isso.

**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.

<h3 id="member-7ae2ffa8a70bd0c0" class="astra-member">RepathDistance</h3>

```csharp
public float RepathDistance { get; set; }
```

Refazer caminho a (m). O alvo precisa se mover isto para o caminho ser refeito

Faixa válida: 0.05 a 100.

**Caminho:** Inspector → Agente de navegação → Movimento; ou fachada C# em um Behavior.

**Uso:** **Refazer caminho a:** Quanto o objeto seguido precisa se mover, em metros, para o caminho ser refeito.

**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.

<h3 id="member-638126ec50396b2b" class="astra-member">Speed</h3>

```csharp
public float Speed { get; set; }
```

Velocidade (m/s)

Faixa válida: 0 a 1000.

**Caminho:** Inspector → Agente de navegação → Movimento; ou fachada C# em um Behavior.

**Uso:** **Velocidade:** Velocidade máxima pedida à multidão, em m/s. Com Personagem, o agente nunca passa da velocidade do próprio Personagem.

**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.

<h3 id="member-f13552b0e1310bd4" class="astra-member">StoppingDistance</h3>

```csharp
public float StoppingDistance { get; set; }
```

Distância de parada (m). Chega quando o caminho restante fica abaixo disto

Faixa válida: 0 a 1000.

**Caminho:** Inspector → Agente de navegação → Movimento; ou fachada C# em um Behavior.

**Uso:** **Distância de parada:** Distância do destino em que o agente considera que chegou e para; emite o evento de chegada uma vez.

**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.

<h3 id="member-c9adf69db8a3273b" class="astra-member">Surface</h3>

```csharp
public Astra.ObjectReference Surface { get; set; }
```

Superfície. Malha usada pelo agente; vazio escolhe a superfície que contém o objeto

**Caminho:** Inspector → Agente de navegação → Geral; ou fachada C# em um Behavior.

**Uso:** **Superfície:** Superfície cuja malha o agente usa; vazio escolhe a que contém o objeto no início do Play.

**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.

<h3 id="member-302848fbc9b49535" class="astra-member">Target</h3>

```csharp
public Astra.ObjectReference Target { get; set; }
```

Seguir objeto. Persegue o objeto sem script; SetDestination substitui o alvo

**Caminho:** Inspector → Agente de navegação → Geral; ou fachada C# em um Behavior.

**Uso:** **Seguir objeto:** Objeto perseguido sem script. SetDestination substitui o alvo até Resume.

**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.

<h3 id="member-3a7f1077285ff2fc" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Agente 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.

<h3 id="member-c2b8e4bd0f017b54" class="astra-member">UpdateRotation</h3>

```csharp
public bool UpdateRotation { get; set; }
```

Girar para o movimento. Gira o objeto em Y para a direção da velocidade

**Caminho:** Inspector → Agente de navegação → Movimento; ou fachada C# em um Behavior.

**Uso:** **Girar para o movimento:** Gira o objeto em Y para a direção do movimento (Personagem e própria pose).

**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.

<h3 id="member-559fa6576feeb5eb" class="astra-member">UseDifficult</h3>

```csharp
public bool UseDifficult { get; set; }
```

Atravessar área difícil

**Caminho:** Inspector → Agente de navegação → Áreas; ou fachada C# em um Behavior.

**Uso:** **Atravessar área difícil:** Permite atravessar a área Difícil, com o custo configurado.

**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.

<h3 id="member-dd0013f5976914fc" class="astra-member">UseJump</h3>

```csharp
public bool UseJump { get; set; }
```

Usar links e áreas de salto

**Caminho:** Inspector → Agente de navegação → Áreas; ou fachada C# em um Behavior.

**Uso:** **Usar links e áreas de salto:** Permite usar links e áreas de Salto no caminho.

**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.