Astra.Components.NavSurface

Namespace: Astra.Components · Assembly: Astra.Scripting · Tipo: Struct

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

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

Consulte também Superfície de navegação para propriedades, valores iniciais, requisitos e edição em Play.

Membros

Membro	Categoria
.ctor	Method
GetData	Method
IsReady	Method
PolygonCount	Method
Remove	Method
SetData	Method
Wrap	Method
AgentHeight	Property
AgentMaxClimb	Property
AgentMaxSlope	Property
AgentRadius	Property
CellHeight	Property
CellSize	Property
Collect	Property
Component	Property
DetailSampleDistance	Property
DetailSampleMaxError	Property
EdgeMaxError	Property
EdgeMaxLength	Property
Enabled	Property
InstanceId	Property
IsAlive	Property
Layer	Property
MinRegionArea	Property
Object	Property
TileSize	Property
TypeId	Property
VolumeCenter	Property
VolumeSize	Property

.ctor

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
component	Astra.Component

GetData

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
slot	uint	· Opcional: 0

IsReady

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

PolygonCount

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Remove

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

SetData

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
value	Astra.AssetGuid
slot	uint	· Opcional: 0

Wrap

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
component	Astra.Component

AgentHeight

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

AgentMaxClimb

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

AgentMaxSlope

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

AgentRadius

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

CellHeight

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

CellSize

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Collect

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Component

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

DetailSampleDistance

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

DetailSampleMaxError

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

EdgeMaxError

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

EdgeMaxLength

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Enabled

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

InstanceId

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

IsAlive

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Layer

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

MinRegionArea

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Object

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

TileSize

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

TypeId

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

VolumeCenter

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

VolumeSize

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.