---
title: "Astra.Components.NavSurface"
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-navsurface/
---

# Astra.Components.NavSurface

Superfície de navegação: Assa a malha de navegação dos colisores estáticos e a carrega no Play. 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.NavSurface
```

Superfície de navegação: Assa a malha de navegação dos colisores estáticos e a carrega no Play. Família Navegação · Malha.

Referência estudada: https://docs.unity3d.com/Packages/com.unity.ai.navigation@2.0/manual/NavMeshSurface.html

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

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Navegação** / **Malha** → **Superfície de navegação**.

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

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-e03e05a63c6df77e) | Method |
| [GetData](#member-047b8253aee7a112) | Method |
| [IsReady](#member-6c43bbd22466a5ce) | Method |
| [PolygonCount](#member-5c1d99a3abcc6bdb) | Method |
| [Remove](#member-88818f5303bfd91e) | Method |
| [SetData](#member-d7e1413333767743) | Method |
| [Wrap](#member-8837c05f974af796) | Method |
| [AgentHeight](#member-47d8195b471c47f7) | Property |
| [AgentMaxClimb](#member-b563c7978e491314) | Property |
| [AgentMaxSlope](#member-e7534beb7e7bc64f) | Property |
| [AgentRadius](#member-bd027dfcf6c51c21) | Property |
| [CellHeight](#member-bf5c1e85d833990a) | Property |
| [CellSize](#member-717024db87fddc31) | Property |
| [Collect](#member-9c1bdd4a1d30ec2f) | Property |
| [Component](#member-8f21f5afdeb53fed) | Property |
| [DetailSampleDistance](#member-38b0f72d5350bd8d) | Property |
| [DetailSampleMaxError](#member-ed04b1da1d0ec9c1) | Property |
| [EdgeMaxError](#member-b0812c5b6f03e40c) | Property |
| [EdgeMaxLength](#member-bb2d145e1ff594d6) | Property |
| [Enabled](#member-1a492528386c9920) | Property |
| [InstanceId](#member-c711b03ace003572) | Property |
| [IsAlive](#member-3e56dd9d59ec7003) | Property |
| [Layer](#member-a4816682158dd58c) | Property |
| [MinRegionArea](#member-398d49448146dbe1) | Property |
| [Object](#member-f02694c11d271cfa) | Property |
| [TileSize](#member-f46aedf6cd068f75) | Property |
| [TypeId](#member-1db01cf9fef878c9) | Property |
| [VolumeCenter](#member-833930d97d6bdc09) | Property |
| [VolumeSize](#member-8d5fdc04b717a726) | Property |

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

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

**Caminho:** Inspector → Superfície 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-047b8253aee7a112" class="astra-member">GetData</h3>

```csharp
public Astra.AssetGuid GetData(uint slot = 0)
```

Malha assada. Recurso do projeto por slot

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

**Uso:** Malha assada. Recurso do projeto por slot

**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 |
|---|---|---|
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-6c43bbd22466a5ce" class="astra-member">IsReady</h3>

```csharp
public bool IsReady()
```

Pronta. Verdadeiro quando a malha desta superfície está carregada no Play

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

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

**Uso:** Pronta. Verdadeiro quando a malha desta superfície está carregada 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-5c1d99a3abcc6bdb" class="astra-member">PolygonCount</h3>

```csharp
public long PolygonCount()
```

Polígonos. Polígonos da malha carregada, com recortes de obstáculos

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

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

**Uso:** Polígonos. Polígonos da malha carregada, com recortes de obstáculos

**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-88818f5303bfd91e" class="astra-member">Remove</h3>

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

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

**Caminho:** Inspector → Superfície 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-d7e1413333767743" class="astra-member">SetData</h3>

```csharp
public void SetData(Astra.AssetGuid value, uint slot = 0)
```

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

**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:** [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 |
|---|---|---|
| `value` | `Astra.AssetGuid` |  |
| `slot` | `uint` |  · Opcional: `0` |

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

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

**Caminho:** Inspector → Superfície 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-47d8195b471c47f7" class="astra-member">AgentHeight</h3>

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

Altura do agente (m). Espaço livre mínimo acima do chão

Faixa válida: 0.05 a 100.

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

**Uso:** **Altura do agente:** Espaço livre mínimo acima do chão, em metros. Passagens mais baixas ficam fora 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.

<h3 id="member-b563c7978e491314" class="astra-member">AgentMaxClimb</h3>

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

Altura do degrau (m). Desnível que o agente sobe sem link

Faixa válida: 0 a 50.

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

**Uso:** **Altura do degrau:** Desnível que o agente vence sem link, em metros (degrau). Maior junta plataformas próximas; menor exige rampas ou links.

**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-e7534beb7e7bc64f" class="astra-member">AgentMaxSlope</h3>

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

Inclinação máxima (°). Rampas mais íngremes não entram na malha

Faixa válida: 0 a 89.

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

**Uso:** **Inclinação máxima:** Inclinação máxima caminhável, em graus. Rampas mais íngremes não entram na 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.

<h3 id="member-bd027dfcf6c51c21" class="astra-member">AgentRadius</h3>

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

Raio do agente (m). Distância mantida das paredes; a malha recua por este raio

Faixa válida: 0 a 50.

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

**Uso:** **Raio do agente:** Raio do agente para o bake, em metros: a malha recua essa distância das paredes. Agentes maiores que ele podem raspar; asse de novo ao mudar.

**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-bf5c1e85d833990a" class="astra-member">CellHeight</h3>

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

Altura da célula (m). Menor detalhe vertical

Faixa válida: 0.01 a 10.

**Caminho:** Inspector → Superfície de navegação → Precisão; ou fachada C# em um Behavior.

**Uso:** **Altura da célula:** Altura da célula de voxel, em metros. Define a precisão vertical dos degraus.

**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-717024db87fddc31" class="astra-member">CellSize</h3>

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

Tamanho da célula (m). Menor detalhe horizontal; menor é mais preciso e mais lento

Faixa válida: 0.01 a 10.

**Caminho:** Inspector → Superfície de navegação → Precisão; ou fachada C# em um Behavior.

**Uso:** **Tamanho da célula:** Tamanho horizontal da célula de voxel, em metros. Menor aumenta precisão e tempo de bake; maior pode fechar vãos estreitos.

**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-9c1bdd4a1d30ec2f" class="astra-member">Collect</h3>

```csharp
public Astra.Components.NavSurface.CollectOption Collect { get; set; }
```

Coletar. Colisores estáticos que entram no bake

**Caminho:** Inspector → Superfície de navegação → Coleta; ou fachada C# em um Behavior.

**Uso:** **Coletar:** Quais colisores estáticos entram: toda a cena, este objeto e filhos, ou só os que tocam o Volume.

**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-8f21f5afdeb53fed" class="astra-member">Component</h3>

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

**Caminho:** Inspector → Superfície 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-38b0f72d5350bd8d" class="astra-member">DetailSampleDistance</h3>

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

Amostra de detalhe (células). Menor que 1 desliga a malha de detalhe de altura

Faixa válida: 0 a 100.

**Caminho:** Inspector → Superfície de navegação → Avançado; ou fachada C# em um Behavior.

**Uso:** **Amostra de detalhe:** Distância de amostragem da malha de detalhe de altura, em células. Abaixo de 1 desliga o detalhe.

**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-ed04b1da1d0ec9c1" class="astra-member">DetailSampleMaxError</h3>

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

Erro de detalhe (células)

Faixa válida: 0 a 100.

**Caminho:** Inspector → Superfície de navegação → Avançado; ou fachada C# em um Behavior.

**Uso:** **Erro de detalhe:** Erro máximo de altura da malha de detalhe, em células.

**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-b0812c5b6f03e40c" class="astra-member">EdgeMaxError</h3>

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

Erro de borda (células). Quanto o contorno pode se afastar das paredes

Faixa válida: 0.1 a 10.

**Caminho:** Inspector → Superfície de navegação → Avançado; ou fachada C# em um Behavior.

**Uso:** **Erro de borda:** Quanto o contorno simplificado pode se afastar das paredes, em células. Maior gera menos vértices.

**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-bb2d145e1ff594d6" class="astra-member">EdgeMaxLength</h3>

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

Aresta máxima (m). Zero não limita o comprimento das bordas

Faixa válida: 0 a 1000.

**Caminho:** Inspector → Superfície de navegação → Avançado; ou fachada C# em um Behavior.

**Uso:** **Aresta máxima:** Comprimento máximo das bordas da malha, em metros; zero não limita.

**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-1a492528386c9920" class="astra-member">Enabled</h3>

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

Ativa. Desligada não carrega a malha no Play; o bake é preservado

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

**Uso:** **Ativa:** Desligada não carrega a malha no Play; o recurso assado é preservado.

**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-c711b03ace003572" class="astra-member">InstanceId</h3>

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

**Caminho:** Inspector → Superfície 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-3e56dd9d59ec7003" class="astra-member">IsAlive</h3>

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

**Caminho:** Inspector → Superfície 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-a4816682158dd58c" class="astra-member">Layer</h3>

```csharp
public Astra.Components.NavSurface.LayerOption Layer { get; set; }
```

Camada dos colisores. Todas ou só uma camada física do projeto

**Caminho:** Inspector → Superfície de navegação → Coleta; ou fachada C# em um Behavior.

**Uso:** **Camada dos colisores:** Todas as camadas físicas ou só uma. Colisores de outras camadas não viram chã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-398d49448146dbe1" class="astra-member">MinRegionArea</h3>

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

Área mínima de região (m²). Ilhas menores são descartadas

Faixa válida: 0 a 10000.

**Caminho:** Inspector → Superfície de navegação → Precisão; ou fachada C# em um Behavior.

**Uso:** **Área mínima de região:** Área mínima, em m², de uma ilha de malha. Ilhas menores (topos de caixas, quinas) são descartadas.

**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-f02694c11d271cfa" class="astra-member">Object</h3>

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

**Caminho:** Inspector → Superfície 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-f46aedf6cd068f75" class="astra-member">TileSize</h3>

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

Tile (células). Lado do tile; obstáculos reconstroem só os tiles que tocam

Faixa válida: 16 a 128.

**Caminho:** Inspector → Superfície de navegação → Precisão; ou fachada C# em um Behavior.

**Uso:** **Tile:** Lado do tile em células. Obstáculos e links reconstroem só os tiles que tocam; tiles menores reconstroem menos por 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-1db01cf9fef878c9" class="astra-member">TypeId</h3>

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

**Caminho:** Inspector → Superfície 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-833930d97d6bdc09" class="astra-member">VolumeCenter</h3>

```csharp
public System.Numerics.Vector3 VolumeCenter { get; set; }
```

Centro do volume

**Caminho:** Inspector → Superfície de navegação → Coleta; ou fachada C# em um Behavior.

**Uso:** **Centro X:** Coordenada X do centro do volume de coleta, no espaço do objeto da Superfície. Usada só com Coletar = Volume. **Centro Y:** Coordenada Y do centro do volume de coleta, no espaço do objeto. Usada só com Coletar = Volume. **Centro Z:** Coordenada Z do centro do volume de coleta, no espaço do objeto. Usada só com Coletar = Volume.

**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-8d5fdc04b717a726" class="astra-member">VolumeSize</h3>

```csharp
public System.Numerics.Vector3 VolumeSize { get; set; }
```

Tamanho do volume

**Caminho:** Inspector → Superfície de navegação → Coleta; ou fachada C# em um Behavior.

**Uso:** **Tamanho X:** Largura do volume de coleta em metros (eixo X do objeto). Colisores fora dele não entram no bake. **Tamanho Y:** Altura do volume de coleta em metros. Inclua o chão e o espaço livre do agente. **Tamanho Z:** Profundidade do volume de coleta em metros (eixo Z 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.