Superfície de navegação

Astra 0.3.0-preview.20261009Conferido em fonte

Assa a malha de navegação dos colisores estáticos e a carrega no Play

Família: Navegação · Grupo: Malha · Identificador: astra.navigation.surface · Payload: 1

Para que usar

Assa a malha de navegação a partir dos colisores estáticos da cena e a carrega no Play. Agentes só andam onde existe malha assada.

Crie pela folha Criar → Navegação → Superfície ou adicione a um objeto vazio. Ajuste as medidas do agente (raio, altura, degrau, inclinação) e toque Assar na Inspeção. O resultado vira o recurso Navegação/.navmesh do projeto.

Criar e configurar

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

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é Astra.Components.NavSurface.

Coleta: toda a cena, só os filhos ou um volume (centro/tamanho no espaço do objeto); a camada física filtra os colisores. Objetos com Agente ou Obstáculo não viram chão. O bake roda em segundo plano com progresso e Cancelar; assar de novo reescreve o mesmo recurso. A atribuição do recurso é um passo de Desfazer. A malha fica onde foi assada: mover o objeto da Superfície não a desloca.

Guia relacionado: Guia de navegação · Notas 0.3.0

Exemplo de uso

Com um chão estático 20×20 m e uma parede de 12 m, mantenha raio .5, altura 2, degrau .4 e inclinação 45°. Asse: o cartão mostra polígonos, área e tiles, e o viewport desenha a malha com um vão ao redor da parede. Mova a parede e veja o cartão passar a “Desatualizada”; asse de novo.

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	Não
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.

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.

Recursos do projeto

Estes seletores ficam no componente e não entram na contagem dos campos numéricos. Use recursos registrados do projeto; nome ou caminho externo não substitui uma referência válida.

Recurso	Onde	Tipo	Uso
Malha assada · `data`	Inspector → Superfície de navegação → Geral	navmesh	Recurso .navmesh produzido pelo bake; o Play carrega este arquivo

Agente

Propriedade	Tipo / unidade	Padrão	Domínio
Raio do agente `agent_radius`	número · m	0.5	0 … 50
Altura do agente `agent_height`	número · m	2	0.05 … 100
Altura do degrau `agent_max_climb`	número · m	0.4	0 … 50
Inclinação máxima `agent_max_slope`	número · °	45	0 … 89

Raio do agente · `agent_radius`

Onde: Inspector → Superfície de navegação → Agente → Raio do agente.

Uso e efeito: 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.

Valor: 0.5 · Tipo: número · Unidade: m · Domínio: 0 … 50.

Altura do agente · `agent_height`

Onde: Inspector → Superfície de navegação → Agente → Altura do agente.

Uso e efeito: Espaço livre mínimo acima do chão, em metros. Passagens mais baixas ficam fora da malha.

Valor: 2 · Tipo: número · Unidade: m · Domínio: 0.05 … 100.

Altura do degrau · `agent_max_climb`

Onde: Inspector → Superfície de navegação → Agente → Altura do degrau.

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

Valor: 0.4 · Tipo: número · Unidade: m · Domínio: 0 … 50.

Inclinação máxima · `agent_max_slope`

Onde: Inspector → Superfície de navegação → Agente → Inclinação máxima.

Uso e efeito: Inclinação máxima caminhável, em graus. Rampas mais íngremes não entram na malha.

Valor: 45 · Tipo: número · Unidade: ° · Domínio: 0 … 89.

Coleta

Propriedade	Tipo / unidade	Padrão	Domínio
Centro X `volume_center_x`	número · m	0	-100000 … 100000
Centro Y `volume_center_y`	número · m	0	-100000 … 100000
Centro Z `volume_center_z`	número · m	0	-100000 … 100000
Tamanho X `volume_size_x`	número · m	20	0.1 … 100000
Tamanho Y `volume_size_y`	número · m	6	0.1 … 100000
Tamanho Z `volume_size_z`	número · m	20	0.1 … 100000
Coletar `collect`	enumeração	Toda a cena	Toda a cena \| Este objeto e filhos \| Volume
Camada dos colisores `layer`	enumeração	Todas	Todas \| Camada 0 \| Camada 1 \| Camada 2 \| Camada 3 \| Camada 4 \| Camada 5 \| Camada 6 \| Camada 7 \| Camada 8 \| Camada 9 \| Camada 10 \| Camada 11 \| Camada 12 \| Camada 13 \| Camada 14 \| Camada 15 \| Camada 16 \| Camada 17 \| Camada 18 \| Camada 19 \| Camada 20 \| Camada 21 \| Camada 22 \| Camada 23 \| Camada 24 \| Camada 25 \| Camada 26 \| Camada 27 \| Camada 28 \| Camada 29 \| Camada 30 \| Camada 31

Centro X · `volume_center_x`

Onde: Inspector → Superfície de navegação → Coleta → Centro X.

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

Valor: 0 · Tipo: número · Unidade: m · Domínio: -100000 … 100000.