Pular para o conteúdo
AstraDOCS

Astra.Components.NavModifier

Astra 0.3.0-preview.20261009Referência de assinaturas

Modificador de navegação: Muda a área dos colisores deste objeto no bake ou os ignora. Família Navegação · Malha.

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

readonly struct Astra.Components.NavModifier

Modificador de navegação: Muda a área dos colisores deste objeto no bake ou os ignora. Família Navegação · Malha.

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

Interfaces: Astra.Components.IComponentFacade<Astra.Components.NavModifier>.

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

No Behavior em Play, obtenha a fachada com Object.GetComponent<NavModifier>(); trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar new NavModifier(component) envolve um componente existente; não adiciona um componente à cena.

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 Modificador de navegação para propriedades, valores iniciais, requisitos e edição em Play.

Membro Categoria
.ctor Method
Remove Method
Wrap Method
ApplyToChildren Property
Area Property
Component Property
InstanceId Property
IsAlive Property
Mode Property
Object Property
TypeId Property

.ctor

public NavModifier(Astra.Component component)

Caminho: Inspector → Modificador 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

Remove

public void Remove()

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

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

Wrap

public static Astra.Components.NavModifier Wrap(Astra.Component component)

Caminho: Inspector → Modificador 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

ApplyToChildren

public bool ApplyToChildren { get; set; }

Aplicar aos filhos. Filhos sem modificador próprio herdam este

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

Uso: Aplicar aos filhos: Filhos sem modificador próprio herdam esta regra no bake.

Roadmap deste membro: Câmera e navegação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Area

public Astra.Components.NavModifier.AreaOption Area { get; set; }

Área. Área do chão destes colisores na malha

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

Uso: Área: Área do chão destes colisores: Caminhável, Não caminhável (buraco), Salto ou Difícil.

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 → Modificador 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.

InstanceId

public ulong InstanceId { get; }

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

Mode

public Astra.Components.NavModifier.ModeOption Mode { get; set; }

Modo. Ignorar tira os colisores do bake

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

Uso: Modo: Alterar área muda o chão destes colisores; Ignorar no bake os tira da malha.

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 → Modificador 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.

TypeId

public static string TypeId { get; }

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